Há duas formas de usar o WhatsApp com o Zoho Desk. O Zoho Desk oferece o próprio canal de WhatsApp 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 conecta o WhatsApp e o Zoho Desk por um fluxo de trabalho no seu próprio n8n.
Esta página trata do segundo caminho. Cada conversa do WhatsApp vira um ticket no Zoho Desk, as mensagens seguintes entram como comentários, e um comentário público de um agente volta ao cliente no WhatsApp. Se toda a sua operação de suporte já está no Zoho Desk e o preço da Business API serve para você, o canal do próprio Zoho é a opção mais simples.
O que o fluxo de trabalho de WhatsApp com Zoho Desk faz
- A primeira mensagem de uma conversa cria um ticket no departamento que você escolher, ligado a um contato do Zoho Desk encontrado ou criado pelo número de telefone. O ticket guarda o id do chat do Spun em um campo personalizado.
- As mensagens seguintes entram no ticket aberto como comentários públicos, precedidas pelo nome e pelo número de quem enviou. As mídias chegam como um link que continua válido por 24 horas.
- As respostas que a sua equipe envia pela caixa de entrada do Spun entram como notas privadas, então o agente no Zoho Desk vê toda a troca de mensagens e os dois lados podem responder.
- Um comentário público de um agente é enviado ao cliente no WhatsApp como texto. Notas privadas e os comentários do próprio fluxo de trabalho nunca são enviados.
- Arquivar a conversa no Spun fecha o ticket, e desarquivar a conversa o reabre. Fechar no Zoho Desk também pode arquivar a conversa no Spun, uma opção que fica desativada até você ativá-la.
Subject: WhatsApp: Hi, my order has not arrived yet
[WhatsApp] Maria Lopez (+15550142233): Hi, my order has not arrived yet
[Sent from Spun] Alex: Sorry about that, checking now.Configuração, passo a passo
Você precisa de um plano do Zoho Desk que inclua webhooks (o Zoho os oferece no Professional e no Enterprise), de uma instância do n8n que o Zoho Desk e o Spun consigam acessar por HTTPS e de um agente do Zoho Desk dedicado à integração, por exemplo “WhatsApp (Spun)”. O guia de configuração lista cada valor e onde encontrá-lo.
- 1
Crie um cliente de API do Zoho
No “API Console” do Zoho, crie um “Self Client” e adicione uma credencial OAuth2 no n8n com as URLs do Zoho para o seu data center e os escopos indicados no guia de configuração.
- 2
Encontre os seus identificadores do Zoho
O id da organização, o departamento que deve receber os tickets do WhatsApp e o id do agente de integração.
- 3
Adicione dois campos personalizados de ticket
Um para o id do chat do Spun (obrigatório) e outro para a linha do Spun (opcional). O fluxo de trabalho precisa dos nomes de API deles, não dos rótulos exibidos.
- 4
Importe o fluxo de trabalho
Abra o nó “Settings” dele e cole os valores do Zoho, o valor do canal do ticket e o status que o seu portal usa para tickets abertos.
- 5
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 Zoho Desk tiver que arquivar a conversa no Spun.
- 6
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.
- 7
Crie o webhook do Zoho Desk
No “Developer Space”, aponte um webhook para a URL de resposta do fluxo de trabalho para os novos comentários de tickets do seu departamento.
- 8
Envie uma mensagem de teste
Mande uma mensagem para a linha a partir de outro celular. Um ticket aparece no Zoho Desk; responda com um comentário público e a resposta chega ao celular.
Relacionado: Documentação: Zoho Desk via n8n, o guia de configuração completo · WhatsApp + n8n: a API e os webhooks por baixo
O que saber antes de montar
- Chats de grupo são ignorados: um grupo não tem número de telefone para ligar a um contato ou a um ticket.
- Um ticket ativo por conversa. Uma mensagem que chega depois que o ticket foi fechado abre um ticket novo.
- As mídias entram como um link de 24 horas, não como anexo do Zoho. As respostas vindas do Zoho Desk são só texto; anexos no comentário de um agente não são encaminhados.
- Fechar no Zoho Desk arquiva a conversa no Spun somente depois que você ativa essa opção e dá à chave de API o escopo “Fechar e Reabrir Conversas”.
- 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.
- O fluxo de trabalho memoriza tickets e contatos no n8n, o que o mantém bem dentro dos limites de API do Zoho.
Relacionado: Todas as integrações de help desk com WhatsApp · O WhatsApp como o próprio help desk