Receita de integração

Integração do WhatsApp com Freshdesk: tickets no 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 Freshdesk. O Freshdesk 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 Freshdesk por um fluxo de trabalho no seu próprio n8n.

Esta página trata do segundo caminho, o fluxo de trabalho de WhatsApp com Freshdesk: cada conversa individual vira um ticket no Freshdesk, as mensagens seguintes são adicionadas a ele, e a nota pública de um agente volta ao cliente no WhatsApp. Se todo o seu suporte já funciona no Freshdesk e o preço da Business API serve para você, o canal do próprio Freshdesk é a opção mais simples.

O que o fluxo de trabalho de WhatsApp com Freshdesk faz

  • Cada conversa individual do WhatsApp vira um ticket com a origem “Chat”, as tags spun e whatsapp, e o id do chat do Spun em um campo personalizado.
  • O solicitante é associado a um contato do Freshdesk pelo telefone e depois pelo celular, em formato internacional. Se não houver correspondência, um contato é criado só com o nome e o número. Contatos existentes nunca são editados e nenhum endereço de e-mail é adicionado.
  • As mensagens seguintes entram como notas públicas do lado do cliente na conversa, precedidas pelo nome e pelo número de quem enviou. Um ticket em “Pending” ou “Resolved” volta para “Open”.
  • Os agentes respondem com uma nota pública, e a nota chega ao cliente no WhatsApp como texto. Notas privadas ficam internas.
  • As respostas que a sua equipe envia pela caixa de entrada do Spun aparecem como notas privadas, então os dois lados podem responder.
  • Arquivar no Spun fecha o ticket (ou o resolve, conforme uma configuração), e desarquivar o reabre. Fechar no Freshdesk também pode arquivar a conversa no Spun, uma opção que fica desativada até você ativá-la.
  • Depois que um ticket fica em “Closed”, a próxima mensagem abre um ticket novo que cita o número do ticket anterior.

A API do Freshdesk não tem uma origem de ticket WhatsApp, então esses tickets usam a origem “Chat” mais a tag whatsapp. Relatórios filtrados pelo canal de WhatsApp do próprio Freshdesk não os incluem; filtre pela tag.

Responda com uma nota pública, não com o botão “Reply”

Em um ticket do WhatsApp, os agentes respondem com “Add note” e mudam a nota para pública. O botão “Reply” envia um e-mail, e um cliente criado pelo fluxo de trabalho não tem endereço de e-mail. A nota pública é o que a regra de automação envia ao fluxo de trabalho, e o que chega ao cliente no WhatsApp.

Configuração, passo a passo

Você precisa do Freshdesk Growth ou superior para a sincronização nos dois sentidos, porque as notas dos agentes chegam ao fluxo de trabalho por uma regra de automação que chama um webhook. No Free e no Sprout, as mensagens do WhatsApp continuam virando tickets, mas as notas não podem ser enviadas de volta. Você também precisa de um administrador do Freshdesk, de um agente de integração como “Spun WhatsApp” com a própria chave de API e de uma instância do n8n que o Freshdesk e o Spun consigam acessar por HTTPS.

  1. 1

    Crie a credencial da chave de API

    Conectado como o agente de integração, copie a chave de API em “Profile settings” e adicione-a ao n8n como uma credencial “Basic Auth”.

  2. 2

    Adicione um campo de ticket “Spun chat id”

    Um campo de texto de uma linha, não obrigatório para os agentes nem para fechar, mais um campo opcional “Spun line”.

  3. 3

    Importe o fluxo de trabalho

    Abra o nó “Settings” dele e cole a URL do seu Freshdesk, o nome de API do campo do id do chat e o id do agente de integração.

  4. 4

    Escolha a URL de resposta e o segredo

    Dê ao nó de resposta um caminho aleatório longo, defina uma segunda sequência aleatória como segredo do Freshdesk e ative o fluxo de trabalho.

  5. 5

    Crie a regra de automação

    Na aba “Ticket Updates”, uma regra que roda quando um agente adiciona uma nota em um ticket com a tag spun e que chama a URL de resposta do fluxo de trabalho com o cabeçalho X-Spun-Secret.

  6. 6

    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 Freshdesk tiver que arquivar a conversa no Spun.

  7. 7

    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.

  8. 8

    Envie uma mensagem de teste

    Mande uma mensagem para a linha a partir de outro celular. Um ticket aparece no Freshdesk; responda com uma nota pública e a resposta chega ao celular. Confira as notificações por e-mail ao solicitante durante esse primeiro teste.

Relacionado: Documentação: Freshdesk via n8n, o guia de configuração completo · WhatsApp + n8n: a API e os webhooks por baixo

O que saber antes de montar

  • O Freshdesk não assina os próprios webhooks, então o fluxo de trabalho confere um cabeçalho com um segredo compartilhado em cada resposta. Os eventos do próprio Spun são assinados com HMAC.
  • As mídias entram no ticket como um link válido por 24 horas, não como anexo. Anexos na nota de um agente não são encaminhados.
  • Chats de grupo são ignorados.
  • O limite de API do Freshdesk é por conta e por minuto (Growth 100, Pro 400, Enterprise 700) e é compartilhado com os seus outros apps. Uma conversa nova usa até 5 chamadas e uma mensagem seguinte, 2 ou 3. O Freshdesk permite 1.000 chamadas de webhook por hora e coloca o restante na fila.
  • 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.

Relacionado: Todas as integrações de help desk com WhatsApp · O WhatsApp como o próprio help desk

Perguntas frequentes

O Freshdesk consegue criar tickets a partir de mensagens do WhatsApp?

Sim. Com o Spun e o fluxo de trabalho do n8n, cada conversa individual do WhatsApp vira um ticket no Freshdesk ligado a um contato associado pelo telefone, e as mensagens seguintes são adicionadas a esse ticket.

Como os agentes respondem ao WhatsApp pelo Freshdesk?

Com uma nota pública no ticket. Uma regra de automação envia a nota ao fluxo de trabalho, que a envia ao cliente no WhatsApp a partir do seu próprio número. O botão “Reply” envia um e-mail, então use notas públicas para o WhatsApp.

Qual plano do Freshdesk eu preciso?

Growth ou superior para a sincronização nos dois sentidos, porque as respostas passam por uma regra de automação com uma ação de webhook. No Free e no Sprout, as mensagens do WhatsApp continuam virando tickets, mas as notas dos agentes não podem ser enviadas de volta ao WhatsApp.

Isso vai alterar os meus contatos existentes no Freshdesk?

Não. Contatos existentes são apenas associados pelo telefone ou celular, nunca editados, e o fluxo de trabalho nunca adiciona um endereço de e-mail. Contatos novos são criados só com nome e número.

Isto é um app do marketplace do Freshdesk?

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 Freshdesk

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