Como enviar mensagem proativa pelo WhatsApp via HubSpot

Neste artigo, você vai aprender a enviar mensagens proativas pelo WhatsApp usando webhooks do HubSpot integrados ao Cloud Chat.

Utilizando nosso endpoint de envios proativos, é possível iniciar conversas de WhatsApp através de webhooks integrados ao Hubspot. Esses webhooks podem ser alimentados com a base de informações do hubspot, tornando a mensagem contextualmente dinâmica.

📌 Quando usar essa integração?

Utilize esse fluxo quando quiser:

• Enviar automaticamente uma mensagem no WhatsApp (utilizando um template aprovado pela Meta) pelo Cloud Chat a partir de uma ação no HubSpot

• Personalizar a mensagem com propriedades do contato no HubSpot (nome, número do pedido, status, entre outros)

• Criar fluxos automáticos de follow-up, cobrança, onboarding ou atualização de status

✅ Pré-requisitos

Antes de configurar o endpoint, você precisa:

• Ter o número de WhatsApp conectado ao Cloud Chat e possuir o inbox_id da caixa de entrada correspondente.
  Consulte a FAQ: Guia mestre — Como conectar seu número de WhatsApp ao Cloud Chat

  O inbox_id pode ser encontrado acessando a configuração da caixa de entrada no Cloud Chat. A URL seguirá o padrão abaixo:
  https://cloudchat.cloudhumans.com/app/accounts/{{account_id}}/settings/inboxes/{{inbox_id}}

• Ter um template aprovado na Meta cadastrado no Cloud Chat.
  Acesse a FAQ: Como criar templates do WhatsApp no Cloud Chat (criação, edição e aprovação).

• Ter sua API Key do Cloud Chat em mãos.
  Acesse a FAQ a seguir para obter a chave e o token: API: Enviar mensagem proativa pelo WhatsApp.

Etapa 1: Criar o Workflow no HubSpot

Para criar um webhook de disparo proativo em um workflow do Hubspot, siga as etapas abaixo.

Na sidebar principal do Hubspot, passe o mouse sobre o símbolo de automações e em seguida clique em Fluxos de trabalho para ser redirecionado à dashboard de workflows:

Ao adentrar a dashboard, clique em Criar fluxo de trabalho e em seguida selecione a opção Do zero:

Escolha as opções que irão disparar esse gatilho:

Etapa 2: Configurar o envio do Webhook

Com a configuração inicial do workflow concluída, temos agora que construir o payload a ser enviado no webhook.

Para iniciar a configuração do webhook, clique no botão de adicionar ação (+):

No painel esquerdo, clique em Operações de dados e em seguida selecione Envie um webhook:

No seletor de método, escolha a opção POST:

Em seguida, preencha as informações de url do webhook e a chave de api:
URL: https://{CLOUDCHAT_DOMAIN}/api/v1/accounts/{ACCOUNT_ID}/conversations/create_proactive_whatsapp_conversation

Para configurar a Chave de API, clique em Adicionar segredo. Em seguida, aparecerá uma janela solicitando o Nome do segredo e o Valor do segredo.

Preencha o Nome do Segredo com api_access_token e, no campo Valor do Segredo, informe a API Key do Cloud Chat que foi salva anteriormente.

Estrutura do Payload

Por fim, preencha o body (payload) da requisição para realizar o disparo, incluindo:

• template_name (obrigatório) — valor estático correspondente ao nome exato do template aprovado no Cloud Chat.

• inbox_id (obrigatório) — valor estático que identifica a inbox de envio do Cloud Chat.

• phone_number (obrigatório) — campo dinâmico utilizando a variável do HubSpot {{contact.phone}}.

• Variáveis do template — Ao cadastrar o template no Cloud Chat, as variáveis configuradas nele devem ter exatamente o mesmo nome das propriedades que serão enviadas pelo HubSpot no payload.

  Isso significa que o nome da variável no template precisa ser idêntico ao nome do campo enviado no webhook (respeitando grafia, maiúsculas/minúsculas e underscores), para que a substituição dos valores aconteça corretamente no momento do disparo.

Abaixo, segue um exemplo de payload:

Observação: As variáveis utilizadas acima, bem como as informações sobre a url do webhook e a chave de API são discutidas na seção de envios proativos via API.