Receita de integração

Integrações de help desk com WhatsApp: conecte o seu help desk ao WhatsApp

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

Se a sua equipe de suporte já trabalha em um help desk, o WhatsApp não precisa ser um mundo à parte. O Spun mantém o WhatsApp no número que os seus clientes já usam e transforma cada conversa em um ticket no seu help desk, então o sistema de tickets para WhatsApp é o mesmo que os seus agentes já conhecem. As respostas dos agentes no ticket voltam para o cliente no WhatsApp.

A conexão passa por um pequeno fluxo de trabalho do n8n que você importa no seu próprio n8n, Cloud ou auto-hospedado. Há um guia de configuração e um fluxo de trabalho pronto para Zendesk, Zoho Desk, Freshdesk, HubSpot Service Hub e Jira Service Management, e uma versão genérica para qualquer outro help desk com API. Os fluxos de trabalho estão documentados passo a passo; confira os primeiros tickets na sua própria conta antes de confiar neles.

Como nasce um ticket de suporte do WhatsApp: os cinco movimentos

Toda integração com help desk faz as mesmas cinco coisas. O que muda de um help desk para outro é onde o número de telefone fica guardado e como o help desk avisa o fluxo de trabalho de que um agente respondeu.

  1. 1

    1. Encontrar ou criar o contato pelo telefone

    Quando um cliente escreve, o fluxo de trabalho procura o solicitante no help desk pelo número de telefone e o cria se ele ainda não existir. Os eventos de mensagem do Spun trazem o número do cliente em formato internacional, então não é preciso tratar o número.

  2. 2

    2. Abrir um ticket

    Se o cliente não tiver um ticket aberto, o fluxo de trabalho cria um e guarda nele o id do chat do Spun, para que as mensagens seguintes encontrem o mesmo ticket.

  3. 3

    3. Adicionar cada mensagem

    Cada nova mensagem do WhatsApp é adicionada ao ticket aberto. As mídias chegam como um link que continua válido por 24 horas.

  4. 4

    4. Devolver as respostas dos agentes

    Quando um agente responde no ticket, o help desk avisa o fluxo de trabalho, e o fluxo de trabalho envia o texto ao cliente no WhatsApp pelo endpoint send-message do Spun, a partir do seu próprio número.

  5. 5

    5. Fechar

    Arquivar a conversa no Spun fecha ou resolve o ticket, e desarquivar a conversa o reabre. Fechar no help desk também pode arquivar a conversa no Spun, como uma opção que você ativa.

As respostas que a sua equipe envia pela caixa de entrada do Spun ficam registradas no ticket como internas, então os dois lados podem responder e o ticket guarda toda a troca de mensagens.

Os help desks, lado a lado

  • Zendesk: os solicitantes são usuários do Zendesk encontrados ou criados pelo telefone. Os agentes respondem com um comentário público, que um gatilho envia ao fluxo de trabalho.
  • Zoho Desk: os tickets ficam ligados a contatos do Zoho Desk encontrados ou criados pelo telefone. Os agentes respondem com um comentário público, que um webhook do Zoho Desk envia ao fluxo de trabalho. Exige um plano do Zoho Desk com webhooks.
  • Freshdesk: os tickets ficam ligados a contatos do Freshdesk identificados pelo telefone. Os agentes respondem com uma nota pública, que uma regra de automação envia ao fluxo de trabalho. O sentido duplo exige o plano Growth ou superior.
  • HubSpot Service Hub: cada conversa vira um ticket no pipeline que você escolher. Os agentes respondem digitando em um campo de resposta do Spun no ticket.
  • Jira Service Management: cada conversa vira uma solicitação no seu projeto de serviço, aberta por uma única conta de integração. Os agentes respondem com um comentário público, que um webhook assinado do Jira envia ao fluxo de trabalho.
  • Qualquer outro help desk: o fluxo de trabalho genérico mantém as chamadas ao help desk em nós claramente identificados, então o mesmo fluxo pode ser apontado para a API de outro help desk.

Relacionado: WhatsApp + Zendesk · WhatsApp + Zoho Desk · WhatsApp + Freshdesk · WhatsApp + HubSpot Service Hub · WhatsApp + Jira Service Management

O que você precisa

  • Um espaço de trabalho do Spun com uma linha de WhatsApp conectada e acesso à página “Webhooks” em “Configurações”.
  • Uma instância do n8n, Cloud ou auto-hospedada, que tanto o seu help desk quanto o Spun consigam acessar por HTTPS. Os fluxos de trabalho usam apenas os nós que já vêm com o n8n.
  • Um plano de help desk que permita a uma automação chamar um webhook, e um administrador para configurar isso uma vez.
  • Uma chave de API do Spun com o escopo “Send Messages”. Adicione “Fechar e Reabrir Conversas” se fechar no help desk tiver que arquivar a conversa no Spun.

Relacionado: Documentação: conectar um help desk ao WhatsApp · WhatsApp + n8n: a API e os webhooks por baixo

Assinado nos dois sentidos

  • Cada evento que o Spun envia é assinado com HMAC-SHA256 no cabeçalho X-Webhook-Signature, e o fluxo de trabalho rejeita tudo o que não confere.
  • Cada entrega tem até três tentativas, e todas carregam o mesmo id de evento, então o fluxo de trabalho ignora as duplicatas em vez de abrir um segundo ticket.
  • Cada resposta é enviada com uma chave de idempotência tirada do evento do help desk, então uma resposta reenviada não sai duas vezes.
  • Proteções contra loop impedem que as notas e mensagens do próprio fluxo de trabalho voltem como novas respostas.

O que saber antes de começar

  • Chats de grupo são ignorados: um grupo não tem um único número de telefone para ligar a um solicitante.
  • As mídias entram no ticket como um link válido por 24 horas, não como anexo do help desk. As respostas dos agentes voltam ao WhatsApp como texto; anexos em uma resposta não são encaminhados.
  • 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.
  • A API do Spun permite 60 requisições por minuto por chave. Cada help desk tem os próprios limites de API, indicados na página dele.
  • O Spun também pode ser o próprio help desk, com etiquetas como filas, atribuição e notas internas, se você não usa um help desk separado.

Relacionado: O WhatsApp como o próprio help desk · Integração do WhatsApp com CRM: HubSpot · Integração do WhatsApp com CRM: Salesforce · Integração do WhatsApp com CRM: Odoo

Perguntas frequentes

Posso conectar o WhatsApp ao meu help desk?

Sim. O Spun mantém o WhatsApp no número que você já usa e um fluxo de trabalho do n8n transforma cada conversa em um ticket no Zendesk, Zoho Desk, Freshdesk, HubSpot Service Hub ou Jira Service Management. As respostas dos agentes no ticket voltam para o cliente no WhatsApp.

Cada mensagem do WhatsApp cria um ticket novo?

Não. Cada conversa individual corresponde a um ticket aberto. As mensagens seguintes são adicionadas a esse ticket, e uma mensagem que chega depois que o ticket foi fechado abre um novo.

Meus agentes vão ter que trabalhar em dois lugares?

Não. Os agentes podem responder no ticket dentro do help desk, e as respostas enviadas pela caixa de entrada do Spun ficam registradas no ticket como internas, então o ticket mostra a conversa inteira de qualquer forma.

Preciso de um desenvolvedor?

Você precisa de alguém à vontade para importar um fluxo de trabalho do n8n e colar ids no nó “Settings” dele, além de um administrador do help desk para criar um webhook ou uma automação. O guia de configuração de cada help desk lista cada valor e onde encontrá-lo. O HubSpot Service Hub pode exigir um desenvolvedor para o app que leva as respostas.

Funciona com grupos do WhatsApp?

Não. Chats de grupo são ignorados, porque um grupo não tem um único número de telefone para ligar a um solicitante.

Quanto custa?

Importar o fluxo de trabalho é grátis. Cada evento entregue usa tokens de IA do seu plano do Spun, e a forma de medir isso no uso com help desk ainda está em análise. O seu plano de help desk e o seu plano do n8n são cobrados por esses fornecedores.

Leve o WhatsApp para o seu help desk

O Spun opera o WhatsApp no número que você já tem, com caixa de entrada compartilhada da equipe, etiquetas e resumos com IA, além dos webhooks e da API que esses fluxos de trabalho de help desk usam. Teste grátis.

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

Ver todas as integrações