Principal APIs Como enviar mensagem proativa pelo WhatsApp via HubSpot

Como enviar mensagem proativa pelo WhatsApp via HubSpot

Última atualização em May 21, 2026

Quando usar

  • Você quer disparar mensagens proativas de WhatsApp a partir de ações no HubSpot (mudança de etapa, formulário enviado, propriedade alterada)
  • Você quer personalizar a mensagem com propriedades do contato no HubSpot (nome, número do pedido, status)
  • Você está montando fluxos de follow-up, cobrança, onboarding ou atualização de status

Pré-requisitos

Sobre este tutorial

Usando o endpoint de envios proativos do Cloud Chat, é possível iniciar conversas de WhatsApp via webhooks integrados ao HubSpot. Esses webhooks são alimentados com dados do HubSpot, tornando a mensagem contextualmente dinâmica.

Para a referência completa do endpoint, consulte: Como enviar mensagem proativa pelo WhatsApp via API.

Passo a passo

Etapa 1 — Criar o Workflow no HubSpot

  1. Na sidebar principal do HubSpot, passe o mouse sobre o ícone de Automações e clique em Fluxos de trabalho

  1. Clique em Criar fluxo de trabalho e selecione Do zero

  1. Escolha as opções que disparam o gatilho

Etapa 2 — Configurar o envio do Webhook

  1. Adicione uma ação clicando em +

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

  1. Escolha o método POST

  1. Preencha a URL do webhook:
https://{CLOUDCHAT_DOMAIN}/api/v1/accounts/{ACCOUNT_ID}/conversations/create_proactive_whatsapp_conversation

  1. Configure a Chave de API: clique em Adicionar segredo, preencha Nome do segredo com api_access_token e o Valor do segredo com a API Key do Cloud Chat

Etapa 3 — Estruturar o payload

Preencha o body da requisição incluindo:

  • template_name (obrigatório) — valor estático com o nome exato do template aprovado

  • inbox_id (obrigatório) — valor estático que identifica a inbox

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

  • Variáveis do template — devem ter exatamente o mesmo nome das propriedades enviadas pelo HubSpot

O nome da variável no template precisa ser idêntico ao nome do campo no payload (grafia, maiúsculas/minúsculas e underscores). Caso contrário, a substituição de valores não acontece.

Exemplo de payload:

Observações