Envio de mensagens proativas em disparos de webhook via hubspot

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 um template aprovado na Meta cadastrado no Cloud Chat.
Ter a caixa de entrada cadastrada no Cloud Chat e ter o inbox_id da mesma.
Ter sua API Key do Cloud Chat em mãos.

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: