Receita de integração

Integração do WhatsApp com Zendesk: os dois caminhos francos

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

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

A resposta que o fluxo de trabalho envia para um comentário público
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)

Perguntas frequentes

O Zendesk tem um canal de WhatsApp próprio?

Sim, construído sobre a Business API: oficial e integrado, mas com um número dedicado, regras de modelos, taxas por mensagem e sem suporte a grupos. Esta página documenta a alternativa: manter o WhatsApp no seu número atual no Spun e criar tickets do Zendesk por um fluxo de trabalho do n8n.

Uma mensagem do WhatsApp pode criar um ticket do Zendesk automaticamente?

Sim. Com o fluxo de trabalho, cada conversa individual do WhatsApp vira um ticket do Zendesk para um solicitante encontrado ou criado pelo número de telefone, e as mensagens seguintes são adicionadas ao mesmo ticket.

Os agentes podem responder ao WhatsApp pelo Zendesk?

Sim. Um comentário público no ticket é enviado ao cliente pelo WhatsApp do seu número real. As respostas enviadas pela caixa de entrada do Spun são adicionadas ao ticket como comentários privados, então os dois lados podem responder.

Qual caminho é mais barato?

O caminho do Spun não tem taxas por mensagem da Business API. Cada evento entregue ao fluxo de trabalho usa tokens de IA do seu plano do Spun, e a forma de medir isso no uso com help desks ainda está em revisão. O canal próprio do Zendesk soma as taxas por conversa da Business API aos preços do Zendesk.

Suporte pelo WhatsApp no seu próprio número

O Spun transforma o seu número de WhatsApp atual em uma caixa de entrada de suporte compartilhada com filas, atribuição e resumos com IA, além 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