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. 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. 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. 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. 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. 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