HubSpot Collect Leads AI Acción

Qué hace esta integración de Hubspot AI

Cuando tu bot identifica a un visitante cualificado, llama a la API de Contactos o Leads de HubSpot con los detalles del visitante y la información de transcripción. El resultado es un registro de Contacto nuevo o actualizado en HubSpot sin salir del chat. Puedes desencadenar la creación de contactos o leads cuando se completa un chat o en función de las reglas de cualificación de leads que configures en tu Chatbot de IA.

Requisitos previos

Necesitarás una cuenta HubSpot y una Private App con ámbitos que permitan crear contactos o leads (para la mayoría de las configuraciones: crm.objects.leads.write; si en cambio creas Contactos, utiliza crm.objects.contacts.write). Copie el token de acceso de su Private App. Lo utilizará como encabezado del token de portador de autorización en la configuración de la acción personalizada.

Datos que recogerá del chat

Configure your AI action to collect fields like: email, first name, last name, phone, company, and any campaign or channel info you want to track (e.g., channel, campaign, pageUrl). These become variables in your Custom Action body (e.g., {{email}}).

Añadir una acción personalizada en Social Intents

Cree una nueva Acción personalizada → Llamar solicitud de API. Dele un nombre descriptivo (por ejemplo, create_hubspot_lead) y escriba una breve descripción de "Cuándo usar" (por ejemplo, "Cuando un visitante pide que se le contacte o solicita una demo").

Configuración API

• Tipo de acción: Disparo automático al finalizar el chat
• Nombre de la acción: Un nombre descriptivo como create_hubspot_lead
• Cuándo utilizarlo: Ejemplo: "Esta acción se activa cuando se completa un chat".
• Respuesta desencadenada: Ejemplo: "Claro, déjame que te busque el tiempo".
• Recoger datos de entrada para la acción: Cualquier parámetro de la solicitud como nombre, apellido, correo electrónico, transcripción
• Solicitud API: La URL del endpoint en nuestro caso estamos creando o actualizando leads (ej. https://api.hubapi.com/crm/v3/objects/contacts/batch/upsert
• Método API: Elija POST.
• Cabeceras de petición: Añade un encabezado de Autorización con un valor de encabezado de "Bearer pat-****". Este es tu token de API que generas en Hubspot.
• Solicitar plantilla JSON:

  {
      "inputs": [
         {
           "idProperty":"email",
           "id":"{{email}}",  
           "properties": {
            "firstname": "{{firstName}}",
             "lastname": "{{lastName}}",
             "email": "{{email}}",
             "si_transcript": "{{transcript}}"
           }
         }
       ]
  }

Así es como se verán los detalles de su Acción Personalizada en Social Intents. Esta configuración enviará los datos del cliente potencial, así como la transcripción a Hubspot.

Ejemplos de casos prácticos

Crear un contacto en Hubspot cuando se completa un chat

Esta acción personalizada siempre se activará tan pronto como termine una conversación de chat en vivo para que siempre tenga su chat en Hubspot. También puede configurar la acción personalizada para que se active en función de criterios de cualificación en el contexto de su chat AI. dentro del contexto de tu chat AI.