Há duas formas de usar o WhatsApp com o HubSpot Service Hub. O HubSpot oferece o próprio canal de WhatsApp na caixa de entrada dele pela WhatsApp Business API, o que significa um número registrado na API, modelos aprovados para mensagens fora da janela de 24 horas e tarifas por mensagem. A outra forma mantém o WhatsApp no número que os seus clientes já usam, com o Spun como espaço de trabalho do WhatsApp, e cria tickets no HubSpot por um fluxo de trabalho no seu próprio n8n.
Esta página trata do segundo caminho, para criar tickets do HubSpot a partir do WhatsApp: cada conversa individual vira um ticket no pipeline que você escolher, cada mensagem fica registrada no ticket e na linha do tempo do contato, e os agentes respondem ao WhatsApp pelo ticket. Funciona junto com a sincronização de contatos do HubSpot CRM do Spun, que mantém os contatos em dia e não cria tickets.
Tickets do HubSpot a partir do WhatsApp: o que o fluxo de trabalho faz
- Cada conversa individual do WhatsApp vira um ticket no HubSpot, no pipeline e na etapa que o seu administrador escolher. Chats de grupo são ignorados.
- Cada mensagem fica registrada no ticket como uma comunicação de WhatsApp e também aparece na linha do tempo do contato, com o nome de quem fala no texto.
- As respostas que a sua equipe envia pela caixa de entrada do Spun também ficam registradas no ticket, então os dois lados podem responder.
- Arquivar no Spun move o ticket para a etapa de fechado, e desarquivar o devolve para a etapa de aberto. Fechar no HubSpot também pode arquivar a conversa no Spun, uma opção que fica desativada até você ativá-la.
[WhatsApp] Maria Lopez (+15550142233): Hi, my order has not arrived yet
[Sent from Spun] Alex: Sorry about that, checking now.
[Sent from HubSpot] It ships today, here is the tracking link.Respondendo pelo ticket com o campo “Spun reply”
Os agentes respondem digitando em uma propriedade “Spun reply” do ticket e salvando. Em poucos segundos o texto chega ao cliente no WhatsApp, fica registrado no ticket e o campo volta a ficar vazio. Se uma resposta não puder ser enviada, uma nota no ticket explica o motivo.
As respostas são só texto; anexos do ticket não são encaminhados. Notas e e-mails do HubSpot ficam internos. Tudo o que for escrito em “Spun reply” é enviado, não importa quem escreva, então deixe essa propriedade fora de edições em lote, importações e fluxos de trabalho do HubSpot.
Junto com a sincronização de contatos do HubSpot CRM
A sincronização de contatos do HubSpot CRM do Spun cuida dos contatos; este fluxo de trabalho cuida dos tickets. O fluxo de trabalho usa a própria chave do HubSpot e nunca edita um contato. Com a sincronização de contatos conectada, ele também nunca cria um contato: o ticket de um cliente totalmente novo é vinculado assim que a sincronização envia o contato, o que acontece com “Sincronizar Agora” ou com uma etiqueta mapeada, não a cada mensagem.
Relacionado: WhatsApp + HubSpot CRM: a sincronização de contatos
Configuração, passo a passo
Você precisa do HubSpot Service Hub, de um usuário que possa criar propriedades, chaves e assinaturas de webhook, de uma instância do n8n que o HubSpot e o Spun consigam acessar por HTTPS e de um app para levar o webhook de respostas: um app privado legado (crie-o antes de 26 de outubro de 2026, quando o HubSpot deixa de permitir novos em contas existentes) ou um app baseado em projetos, que é criado com a HubSpot CLI e exige um desenvolvedor.
- 1
Crie duas propriedades de ticket
“Spun chat id” (texto de uma linha) e “Spun reply” (texto de várias linhas). Adicione “Spun reply” à barra lateral do ticket para que os agentes a vejam.
- 2
Crie uma chave para as chamadas à API
Uma chave de serviço ou o token de acesso do seu app privado legado, com os escopos de tickets e contatos indicados no guia de configuração, guardada no n8n como uma credencial “Header Auth”.
- 3
Importe o fluxo de trabalho
Rode uma vez o assistente de configuração dele para listar os pipelines e etapas de tickets, e copie os ids para o nó “Settings”.
- 4
Informe a ele sobre a sincronização de contatos
Deixe ativada a configuração de sincronização de contatos se a sincronização de contatos do HubSpot do Spun estiver conectada, ou se você não tiver certeza.
- 5
Assine o app às mudanças de tickets
Aponte o webhook do app para a URL de resposta do fluxo de trabalho com uma assinatura na propriedade “Spun reply”, e cole o segredo do cliente do app no fluxo de trabalho.
- 6
Crie uma chave de API do Spun
“Configurações”, depois “Webhooks”, depois “Gerenciar Chaves da API”, com o escopo “Send Messages”. Marque também “Fechar e Reabrir Conversas” se fechar no HubSpot tiver que arquivar a conversa no Spun.
- 7
Assine o fluxo de trabalho aos eventos do Spun
Adicione um webhook para mensagens recebidas, mensagens enviadas, conversa fechada e conversa reaberta, com o “Formato de Payload” em “Bruto (padrão)”, e cole o segredo de assinatura dele no fluxo de trabalho.
- 8
Envie uma mensagem de teste
Mande uma mensagem para a linha a partir de outro celular. Um ticket aparece no HubSpot; digite uma resposta em “Spun reply”, salve, e a resposta chega ao celular.
Relacionado: Documentação: HubSpot Service Hub via n8n, o guia de configuração completo · WhatsApp + n8n: a API e os webhooks por baixo
O que saber antes de montar
- Os webhooks do HubSpot são assinados e o fluxo de trabalho confere a assinatura. Os eventos do próprio Spun são assinados com HMAC.
- As mídias entram no ticket como um link válido por 24 horas, não como um arquivo do HubSpot.
- Os limites de API do HubSpot valem por chave (100 ou 190 requisições a cada 10 segundos, mais um limite diário por conta). Uma conversa nova custa quatro ou cinco chamadas e uma mensagem seguinte, duas.
- Cada evento entregue usa tokens de IA do seu plano do Spun. A forma de medir isso no uso com help desk ainda está em análise.
Relacionado: Todas as integrações de help desk com WhatsApp · O WhatsApp como o próprio help desk