Receita de integração

HubSpot Service Hub e WhatsApp: transforme conversas em tickets do HubSpot

Guia de configuração e fluxo de trabalho do n8n importávelÚltima verificação: outubro de 2026

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.
Como as mensagens ficam registradas no ticket (ilustrativo)
[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. 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. 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. 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. 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. 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. 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. 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. 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

Perguntas frequentes

O HubSpot Service Hub consegue criar tickets a partir do WhatsApp?

Sim. Com o Spun e o fluxo de trabalho do n8n, cada conversa individual do WhatsApp vira um ticket no pipeline e na etapa que você escolher, e cada mensagem fica registrada no ticket e na linha do tempo do contato.

Como os agentes respondem ao WhatsApp a partir de um ticket do HubSpot?

Eles digitam a resposta na propriedade “Spun reply” do ticket e salvam. O texto é enviado ao cliente no WhatsApp a partir do seu próprio número, fica registrado no ticket e o campo é limpo.

Qual a diferença para a sincronização de contatos do HubSpot CRM?

A sincronização de contatos mantém os contatos em dia entre o Spun e o HubSpot e não cria tickets. Este fluxo de trabalho cria e atualiza tickets e nunca edita um contato. Os dois funcionam lado a lado.

O que eu preciso do lado do HubSpot?

Service Hub, duas propriedades de ticket personalizadas, uma chave para as chamadas à API e um app para o webhook de respostas: um app privado legado criado antes de 26 de outubro de 2026, ou um app baseado em projetos criado com a HubSpot CLI, que exige um desenvolvedor.

Isto é um app do marketplace do HubSpot?

Não. É um fluxo de trabalho do n8n que você importa no seu próprio n8n, Cloud ou auto-hospedado, com um guia de configuração na documentação do Spun.

Conversas do WhatsApp como tickets do HubSpot

O Spun transforma o número de WhatsApp que você já tem em uma caixa de entrada compartilhada da equipe, com etiquetas, atribuição e resumos com IA, além da sincronização de contatos do HubSpot e dos webhooks e da API que este fluxo de trabalho usa. Teste grátis.

Comece grátis: 7 dias com tudo incluído

Ver todas as integrações