Existem duas formas verdadeiras de fazer o WhatsApp funcionar com o Zendesk, e elas são muito diferentes. O primeiro caminho é o canal de WhatsApp do próprio Zendesk: oficial, construído sobre a Business API, o que significa um número dedicado, aprovações de modelos, taxas por mensagem e nada de grupos do WhatsApp. O segundo caminho mantém o WhatsApp no número que você já usa, com o Spun como espaço de trabalho do WhatsApp, e um fluxo de trabalho de WhatsApp para Zendesk no seu próprio n8n transforma cada conversa em um ticket do Zendesk.
Esta página documenta o segundo caminho e é franca sobre quando o primeiro é a melhor escolha: se toda a sua operação de suporte vive dentro do Zendesk e você quer o WhatsApp como mais um canal de tickets, com a economia da API, use o canal do Zendesk. Se o WhatsApp é o seu principal canal com os clientes e o Zendesk é um sistema entre vários, mantê-lo no seu número real com uma caixa de entrada da equipe costuma atender melhor os clientes.
1. Tickets do WhatsApp no Zendesk: o que o fluxo de trabalho faz
Cada conversa individual do WhatsApp na linha vira um ticket do Zendesk, sem precisar aplicar uma etiqueta antes. As mensagens seguintes são adicionadas ao mesmo ticket, e um comentário público de um agente volta para o cliente pelo WhatsApp.
- O solicitante é um usuário do Zendesk que o fluxo de trabalho encontra ou cria para o número de telefone do cliente, e o ticket é criado para esse usuário.
- Os comentários públicos dos agentes no Zendesk são enviados ao cliente pelo WhatsApp como texto, do seu próprio número. Os comentários privados ficam internos.
- As respostas que a sua equipe envia pela caixa de entrada do Spun viram comentários privados no ticket, então os dois lados podem responder e o ticket guarda toda a troca.
- Arquivar a conversa no Spun resolve o ticket, e desarquivá-la o reabre. Resolver no Zendesk também pode arquivar a conversa no Spun, uma opção que fica desativada até você ativá-la. Em nenhum dos casos o fluxo de trabalho envia uma mensagem de status ao cliente.
- Cada resposta é enviada com o id do comentário do Zendesk como chave de idempotência, então uma resposta repetida em uma nova tentativa não é enviada duas vezes.
Os chats de grupo são ignorados. A mídia chega ao ticket como um link que continua válido por 24 horas.
2. Configure
Você precisa de um administrador do Zendesk que possa criar webhooks, gatilhos e um cliente OAuth, de um agente de integração como “Spun WhatsApp” e de uma instância do n8n que o Zendesk e o Spun consigam acessar por HTTPS. O guia de configuração lista cada valor e onde encontrá-lo.
- 1
Crie um cliente OAuth
Conectado como o agente de integração, adicione um cliente OAuth no “Admin Center” do Zendesk e uma credencial OAuth2 no n8n com o tipo de concessão “Client Credentials”. Um token de API é a alternativa.
- 2
Importe o fluxo de trabalho
Abra o nó “Settings” dele e cole a URL do seu Zendesk e o id de usuário do agente de integração. Um grupo, uma marca e um campo de ticket “Spun line” são opcionais.
- 3
Crie o webhook e o gatilho de respostas no Zendesk
Um webhook apontado para a URL de respostas do fluxo de trabalho, e um gatilho que o chama quando um ticket com a tag spun recebe um comentário público. Cole o segredo de assinatura do webhook no fluxo de trabalho.
- 4
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 resolver no Zendesk deve arquivar a conversa no Spun.
- 5
Inscreva o Spun no fluxo de trabalho
Adicione um webhook para mensagens recebidas, mensagens enviadas, conversa encerrada e conversa reaberta, com o “Formato de Payload” em “Bruto (padrão)”, e cole o segredo de assinatura dele no fluxo de trabalho.
- 6
Envie uma mensagem de teste
Mande uma mensagem para a linha de outro celular. Um ticket aparece no Zendesk; responda com um comentário público e a resposta chega ao celular.
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json
{
"to": "14155552671",
"text": "Thanks for waiting, your replacement ships today.",
"idempotency_key": "<Zendesk comment id>"
}Relacionado: Documentação: Zendesk via n8n, o guia de configuração completo · WhatsApp + n8n: a API e os webhooks por trás
O que saber antes de construir
- Isto é uma ponte, não uma fusão de canais: as conversas do WhatsApp vivem no Spun, os tickets vivem no Zendesk e o fluxo de trabalho mantém os dois em sincronia. Se você precisa do WhatsApp como um canal do Zendesk com número próprio, esse é o primeiro caminho, com os custos e os limites dele.
- É um fluxo de trabalho do n8n que você importa, não um app do marketplace do Zendesk. O lado do Spun usa uma chave de API; o lado do Zendesk usa um cliente OAuth.
- Encerrar pelo Zendesk chama os endpoints de encerramento e reabertura do Spun, que exigem o escopo “Fechar e Reabrir Conversas” na chave.
- O Zendesk permite 30 atualizações por ticket a cada 10 minutos, 5 novos usuários por minuto e 5.000 comentários por ticket. A API do Spun permite 60 solicitações por minuto por chave.
- Cada evento entregue usa tokens de IA do seu plano do Spun. A forma de medir isso no uso com help desks ainda está em revisão.
- Muitas equipes descobrem que a camada de tickets era a parte opcional: as etiquetas, a atribuição e as tarefas do Spun já cobrem sozinhas a gestão de tickets baseada em chat. Veja a página do WhatsApp como help desk.
Relacionado: O WhatsApp como o próprio help desk (sem precisar do Zendesk) · Todas as integrações do WhatsApp com help desks · WhatsApp + Zapier e Make (a API completa)