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