Ação de IA do HubSpot Collect Leads

O que essa integração de IA da Hubspot faz

Quando seu bot identifica um visitante qualificado, ele chama a API de contatos ou leads da HubSpot com os detalhes do visitante e as informações de transcrição. O resultado é um registro de contato novo ou atualizado no HubSpot sem sair do chat. Você pode automaticamente acionar a criação de contato ou lead automaticamente quando um chat for concluído ou com base nas regras de qualificação de lead que você configurou no seu AI Chatbot.

Pré-requisitos

Você precisará de uma conta da HubSpot e de um aplicativo privado com escopos que permitam a criação de contatos ou leads (para a maioria das configurações: crm.objects.leads.write; se, em vez disso, você criar contatos, use crm.objects.contacts.write). Copie o token de acesso de seu aplicativo privado. Você o usará como cabeçalho do token do portador de autorização nas configurações da ação personalizada.

Dados que você coletará no 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}}).

Adicionar uma ação personalizada em Social Intents

Crie uma nova ação personalizada → Chamar solicitação de API. Dê a ela um nome descritivo (por exemplo, create_hubspot_lead) e escreva uma breve descrição de "Quando usar" (por exemplo, "Quando um visitante pede para ser contatado ou solicita uma demonstração").

Configuração da API

• Tipo de ação: Acionamento automático no final do bate-papo
• Nome da ação: Um nome descritivo, como create_hubspot_lead
• Quando usar: Exemplo: "Esta ação é acionada quando um bate-papo é concluído".
• Resposta acionada: Exemplo: "Claro, deixe-me ver a previsão do tempo para você".
• Coleta entradas de dados para ação: Quaisquer parâmetros na solicitação, como nome, sobrenome, e-mail, transcrição
• Solicitação de API: O URL do endpoint, no nosso caso, está criando ou atualizando leads (por exemplo https://api.hubapi.com/crm/v3/objects/contacts/batch/upsert
• Método da API: Escolha POST.
• Cabeçalhos de solicitação: Adicione um cabeçalho de autorização com um valor de cabeçalho "Bearer pat-****". Esse é o token de API que você gerou no Hubspot.
• Solicitar modelo JSON:

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

Esta é a aparência dos detalhes de sua ação personalizada no Social Intents. Essa configuração enviará os dados do lead, bem como a transcrição, para o Hubspot

Exemplos de casos de uso

Crie um contato no Hubspot quando um chat for concluído

Essa ação personalizada sempre será acionada assim que uma conversa de bate-papo ao vivo terminar, para que você sempre tenha suas transcrições de bate-papo enviadas para o Hubspot. Como alternativa, você pode configurar a ação personalizada para ser acionada com base em critérios de qualificação no contexto de seu chat de IA.