Receita de integração

Integração do WhatsApp com Zoho Desk: tickets a partir do número que você já usa

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

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.
Como uma mensagem do WhatsApp chega ao ticket (ilustrativo)
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. 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. 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. 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. 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. 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. 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. 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. 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

Perguntas frequentes

O Zoho Desk consegue criar tickets a partir de mensagens do WhatsApp?

Sim. Com o Spun e o fluxo de trabalho do n8n, a primeira mensagem de WhatsApp de uma conversa cria um ticket no Zoho Desk ligado a um contato encontrado ou criado pelo telefone, e as mensagens seguintes entram nesse ticket como comentários.

Como os agentes respondem ao WhatsApp pelo Zoho Desk?

Com um comentário público no ticket. Um webhook do Zoho Desk o envia ao fluxo de trabalho, que o envia ao cliente no WhatsApp a partir do seu próprio número. Notas privadas ficam internas.

Qual plano do Zoho Desk eu preciso?

Um plano que inclua webhooks, que o Zoho oferece no Professional e no Enterprise. O webhook leva as respostas dos agentes de volta ao WhatsApp.

Isso usa o canal de WhatsApp do próprio Zoho Desk?

Não. O WhatsApp continua no número que os seus clientes já usam, no Spun, e os tickets são criados pela API do Zoho Desk. O canal do próprio Zoho funciona sobre a WhatsApp Business API, com número, modelos e tarifas próprios.

Isto é um app do Zoho Marketplace?

Não. É um fluxo de trabalho do n8n que você importa no seu próprio n8n, Cloud ou auto-hospedado, com um guia de configuração na documentação do Spun.

WhatsApp no seu número, tickets no Zoho Desk

O Spun transforma o número de WhatsApp que você já tem em uma caixa de entrada compartilhada da equipe, com etiquetas, 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