n8n no atendimento ao cliente: conecte o Deskwoot por webhook ou com o node do Deskwoot

Uma cliente dá 1 de 5 estrelas ao seu atendimento, e você só fica sabendo na sexta-feira, no relatório da semana. Um cliente fiel escreve na segunda de manhã e acaba sendo atendido pelo funcionário temporário, porque ninguém vê que ele compra de você há 9 anos.

O n8n, uma ferramenta de workflows automáticos, fecha lacunas assim. Aqui você encontra os 2 jeitos de conectar o Deskwoot a ele, 3 workflows para você copiar e o que hospedar o n8n por conta própria significa para a proteção de dados.

Os 2 caminhos em resumo

Você pode contratar o n8n como serviço na nuvem, o n8n Cloud, ou rodá-lo num servidor seu. O Deskwoot se conecta a ele de 2 jeitos.

No primeiro, o Deskwoot envia eventos por webhook para um node Webhook no n8n. No segundo, você instala o node do Deskwoot para o n8n, que recebe eventos e também consegue agir dentro do Deskwoot.

Qual caminho serve para você depende de 2 perguntas: o n8n precisa fazer algo no Deskwoot? E onde roda o seu n8n?

Você encontra os dois caminhos no Deskwoot em Configurações > Integrações > n8n.

Caminho 1: um webhook do Deskwoot inicia o seu workflow

Os webhooks estão disponíveis a partir do plano Startup, por US$ 4 por agente por mês ou US$ 3,20 com cobrança anual, e também no teste de 7 dias. No plano gratuito Hacker, o Deskwoot não envia webhooks.

Configure em 5 passos

1. No n8n, adicione um node Webhook como primeiro passo, coloque HTTP Method em POST e deixe Respond em Immediately.
2. Copie a Production URL do node.
3. No Deskwoot, vá em Configurações > Webhooks (só administradores veem esta página), clique em Adicionar webhook e cole a URL em URL do endpoint.
4. Em Inscrever-se em eventos, marque só o que o seu workflow precisa e clique em Criar webhook. Entre as opções estão Conversa criada, Conversa atribuída, Conversa resolvida, Mensagem criada, Contato criado e CSAT enviado.
5. Publique o workflow no n8n.

Cada evento chega como JSON com os campos event, data, timestamp e accountId. Um webhook pode se inscrever em vários eventos. Nesse caso, um node If no workflow verifica o campo event e manda cada evento para o seu ramo.

Test URL ou Production URL

A primeira armadilha é o endereço. Todo node Webhook no n8n tem uma Test URL e uma Production URL.

Segundo a documentação do n8n sobre o node Webhook, o n8n só registra a Production URL quando você publica o workflow. As execuções dela aparecem apenas na aba Executions, não no editor. Quem coloca a Test URL no Deskwoot encontra, no dia seguinte, um workflow mudo.

Tempo limite e segunda tentativa

O Deskwoot espera no máximo 10 segundos por uma resposta. Se ela não vier, ou vier um erro, o Deskwoot tenta de novo uma única vez, depois de 5 segundos.

Com Respond em Immediately, o n8n responde na hora, não importa quanto tempo o resto do workflow leve. Se o n8n ficou fora do ar por mais tempo, os eventos desse período se perdem, porque o Deskwoot não os guarda.

Cada mensagem inicia uma execução

O evento Mensagem criada dispara a cada mensagem de uma conversa, inclusive nas respostas da sua equipe. Um workflow que deve reagir só a mensagens de clientes precisa de um filtro.

No n8n Cloud, além disso, cada execução conta. O n8n cobra por execuções (executions), e uma execução é uma passagem completa pelo workflow.

Segundo a página de preços do n8n, o plano Starter inclui 2.500 execuções por mês (informação do fabricante, em outubro de 2026). Se cada mensagem de uma caixa de entrada movimentada inicia uma execução, essa cota acaba rápido. Por isso, inscreva o webhook só nos eventos que você realmente usa.

Assinatura e URL secreta

O Deskwoot assina cada evento com HMAC SHA256 no header x-deskwoot-signature. Só que o painel não mostra o secret de um webhook criado ali. Por esse caminho, então, o seu workflow não consegue recalcular a assinatura.

A proteção vem do caminho aleatório que o n8n dá a cada Production URL. Por isso, trate a URL como uma senha.

Se você criar o webhook pela API REST no plano Enterprise, recebe o secret uma vez na resposta e pode fazer a verificação você mesmo.

n8n atrás de um reverse proxy

O Deskwoot só envia para endereços HTTPS públicos. Se o seu n8n roda atrás de um reverse proxy, a documentação do n8n manda definir a variável N8N_WEBHOOK_URL com o endereço público. Senão, o n8n mostra um endereço que não funciona de fora.

O nome antigo, WEBHOOK_URL, está obsoleto desde o n8n 2.35.0.

O que um webhook não faz

Este caminho não muda nada no Deskwoot, porque um webhook só envia dados para fora. Para o n8n responder aos seus clientes, crie em Configurações > Bots um bot do tipo Custom Webhook, a partir do plano Startup. Cada conversa que o bot responde conta como 1 conversa de IA. Para todo o resto, você precisa do caminho 2.

Caminho 2: o node do Deskwoot para o n8n

O node do Deskwoot é um community node, ou seja, uma extensão que não vem do próprio n8n. O pacote se chama n8n-nodes-deskwoot e está na versão 0.1.0 no npm.

Ele traz 2 nodes: o Deskwoot Trigger, que inicia workflows, e o node Deskwoot, que trabalha dentro do Deskwoot. Quem publica o pacote é o próprio Deskwoot, sob licença MIT e com o código-fonte no GitHub.

Do que você precisa

O node entra com um token da API REST, e a API REST faz parte do plano Enterprise, por US$ 12 por agente por mês ou US$ 9,60 com cobrança anual.

O teste não inclui acesso à API. Então você só consegue experimentar o node com um plano Enterprise pago.

Além disso, por enquanto ele só roda no n8n que você mesmo hospeda. A documentação do n8n diz: "Unverified community nodes aren't available on n8n cloud." (community nodes não verificados não estão disponíveis no n8n Cloud). Para chegar ao n8n Cloud, o node precisa antes ser verificado e liberado pelo n8n.

Instalar e conectar

1. No n8n, vá em Settings > Community Nodes e clique em Install. Digite n8n-nodes-deskwoot, confirme o aviso sobre os riscos e instale. Segundo o n8n, só usuários com o papel Owner ou Admin podem fazer isso.
2. No Deskwoot, vá em Configurações > Tokens de API, clique em Criar token e marque Leitura e Escrita. Copie o token na hora, porque o Deskwoot só o mostra uma vez.
3. No n8n, crie uma credencial do tipo Deskwoot API com o token e o ID da conta, que a mesma página do Deskwoot mostra em O ID da sua conta. O n8n testa a conexão buscando as suas caixas de entrada.

Só administradores veem a página Tokens de API. O trigger só envia eventos enquanto a pessoa que criou o token continuar sendo administradora.

Respostas e notas enviadas pelo n8n levam o nome dessa pessoa. Então pense bem em nome de quem a sua automação deve escrever.

O que o trigger avisa

• Conversation Created: uma conversa começa, seja porque o cliente escreveu, seja porque a sua equipe a iniciou.
• Customer Message Received: o cliente escreve. Respostas e notas da sua equipe não contam, então você dispensa o filtro do caminho 1.
• Conversation Assigned: uma conversa ganha um novo responsável. O round robin em conversas novas e as regras de automação não disparam esse evento.
• Conversation Resolved: uma conversa é resolvida.
• Contact Created: alguém da equipe cria um contato, ou um app faz isso pela API.
• Conversation Rated: o cliente avalia uma conversa na pesquisa de satisfação.

Quando você publica o workflow, o trigger registra sozinho o próprio endereço no Deskwoot e, quando você tira o workflow do ar, cancela esse registro. Ele confere a assinatura de cada evento e rejeita requisições sem uma assinatura válida.

Um workspace comporta no máximo 100 desses registros, somados aos triggers do app do Deskwoot para o Zapier.

O que o node faz no Deskwoot

• Para conversas: Start (uma primeira mensagem para um contato), Reply, Add Private Note, Assign e Add Label.
• Para contatos: Create or Update e Find.

Cada conversa em que o n8n responde a um cliente com Reply ou que ele abre com Start conta como 1 conversa de IA. Notas, atribuições, etiquetas e contatos nunca contam.

Start só funciona onde uma empresa pode escrever primeiro, como no e-mail ou no SMS. Num chat ao vivo, o Deskwoot recusa o envio.

No WhatsApp vale o mesmo quando a pessoa não escreveu para a sua caixa de entrada nas últimas 24 horas, porque o node não envia modelos de mensagem. Nesses casos, o node mostra o motivo.

Community nodes e o seu servidor

Um alerta que vale para qualquer community node: na sua página sobre os riscos, o n8n avisa que community nodes têm "full access to the machine that n8n runs on" (acesso total à máquina em que o n8n roda).

Instale só pacotes cuja origem você conhece e, antes de atualizar, leia o que mudou.

3 workflows para pequenos negócios

1. Avaliação ruim, aviso na hora (webhook)

O Deskwoot pode enviar uma pesquisa de satisfação depois que uma conversa é resolvida. As pesquisas estão disponíveis a partir do plano Business.

1. No Deskwoot, crie um webhook só para CSAT enviado.
2. No n8n, um node If verifica se a nota em body.data.rating (de 1 a 5) é 2 ou menos.
3. Se for, o n8n manda para você um e-mail com o comentário de body.data.feedback e um link para a conversa.

Você monta o link com https://deskwoot.com/app/, body.accountId, /conversations/ e body.data.conversationId. Assim você entra em contato com a cliente ainda no mesmo dia.

2. Clientes fiéis vão direto para a pessoa de sempre (node)

O Deskwoot Trigger inicia com Conversation Created. O n8n verifica se o e-mail em contactEmail (no WhatsApp, o número em contactPhone) está na sua lista de clientes, por exemplo numa planilha do Google ou no seu CRM.

Se estiver, o node age no Deskwoot:

• Assign atribui a conversa à pessoa que sempre atende esse cliente, escolhida na lista ou pelo ID que está na sua lista de clientes.
• Add Label adiciona a sua etiqueta "Cliente fiel".
• Add Private Note anota o número de cliente e o último pedido. Só a sua equipe vê a nota.

3. Pedido de retorno pelo formulário vira conversa na caixa de entrada (node)

Segundo a documentação do n8n, um Form Trigger no n8n gera uma página de formulário pronta, aqui com nome, e-mail e telefone.

Depois do envio, Create or Update cria o contato com nome e telefone ou completa o contato que já existe. Em seguida, Start manda uma primeira mensagem da sua caixa de entrada de e-mail: "Obrigado, vamos ligar para você no próximo dia útil até as 12h."

Assim o pedido de retorno fica no Deskwoot como conversa aberta, e o número fica salvo no contato. Se a pessoa responder ao e-mail, a resposta cai na mesma conversa.

Rodar o n8n por conta própria: o que isso significa para a proteção de dados

Os eventos do Deskwoot contêm dados pessoais: dependendo do evento, nomes, e-mails, telefones ou o texto de uma mensagem. O lugar onde o n8n roda define quem mais processa esses dados.

Os pontos a seguir se referem ao GDPR, o regulamento europeu de proteção de dados, e portanto a empresas na UE. Fora da UE, valem as leis de proteção de dados do seu país (no Brasil, a LGPD). Esta é uma informação geral, não uma consultoria jurídica.

Com o n8n Cloud

No n8n Cloud, segundo a página de preços, os dados ficam armazenados na UE, em servidores em Frankfurt. A página de segurança do n8n cita o Microsoft Azure como provedor de hospedagem.

O n8n passa então a ser o seu operador, e pelo art. 28(3) do GDPR esse tratamento é "regulado por contrato". Você assina esse acordo de processamento de dados online, com o n8n.

No seu próprio servidor

Se você mesmo roda o n8n, os dados ficam no seu servidor. Se aluga um servidor para isso, em geral a empresa de hospedagem é o seu operador, e você assina com ela um acordo desses.

As medidas técnicas e organizacionais do art. 32 do GDPR passam a ser responsabilidade sua. Na prática, isso significa:

• Instalar atualizações
• Fazer backups
• Proteger o acesso
• Criptografar os dados

No seu comparativo entre o Cloud e a hospedagem própria, o próprio n8n diz que instalação e configuração exigem conhecimento técnico e que a manutenção fica por sua conta.

Execuções salvas e outros destinatários

O n8n também salva cada execução com os dados de entrada. Segundo a documentação do n8n, um n8n hospedado por você apaga por padrão as execuções concluídas depois de 336 horas, ou seja, 14 dias, e guarda no máximo 10.000.

Com EXECUTIONS_DATA_SAVE_ON_SUCCESS=none, ele nem salva as execuções bem-sucedidas. Prazos mais curtos combinam com o princípio da limitação da conservação, do art. 5(1)(e) do GDPR: guardar dados só pelo tempo que a finalidade exige.

Cada serviço para o qual o seu workflow passa dados é mais um destinatário. Se ele processa esses dados em seu nome, você também precisa de um acordo com ele nos termos do art. 28 do GDPR.

Do lado do Deskwoot

O app e o banco de dados de cada workspace rodam em servidores na Holanda, também no plano gratuito. Você assina o acordo de processamento de dados nos termos do art. 28 do GDPR direto no painel.

Qual caminho serve para você?

• Se você usa o n8n Cloud ou está no plano Startup ou Business, fique com o webhook. Para notificações e para passar dados a planilhas ou outras ferramentas, ele basta.
• Se o seu workflow precisa agir dentro do próprio Deskwoot, ou seja, responder, atribuir, adicionar etiquetas ou cuidar dos contatos, e você roda o n8n no seu próprio servidor, use o node do Deskwoot com o Enterprise.

O seu primeiro workflow

Com o workflow 1, você fica sabendo de uma avaliação ruim no mesmo dia. No Deskwoot, basta colar uma URL e marcar o evento CSAT enviado. O resto você monta no n8n.

Webhooks e pesquisas de satisfação fazem parte do teste de 7 dias. Ele roda no plano Enterprise (sem acesso à API), sem cartão de crédito e para até 30 assentos, contando o seu. O plano Hacker é gratuito, mas não envia webhooks.

Antes de começar, você pode ler cada passo, com os nomes dos campos, no artigo de ajuda Integração com o n8n, e há artigos próprios sobre webhooks e tokens de API. A comparação dos planos está na página de preços.

Crie uma conta em deskwoot.com/pt-BR/signup e cole a Production URL do seu primeiro node Webhook em Configurações > Webhooks.