Todas as integrações

Rode workflows do n8n com eventos do Deskwoot e aja no Deskwoot a partir do n8n

Há dois caminhos para conectar o n8n. No plano Enterprise, o node do Deskwoot para o n8n inicia um workflow quando algo acontece no Deskwoot, e os seus workflows respondem, adicionam notas, atribuem, aplicam etiquetas e atualizam contatos no Deskwoot. A partir do plano Startup, um webhook do Deskwoot envia eventos para o próprio node Webhook do n8n.


Visão geral

O trabalho de suporte raramente termina na caixa de entrada. Uma nova mensagem de cliente pode pedir uma consulta de pedido na sua loja, uma linha numa planilha ou uma tarefa em outra ferramenta. O n8n cria esses workflows, no n8n Cloud ou no seu próprio servidor. O Deskwoot se conecta a ele de dois jeitos: os seus workflows reagem ao que acontece no Deskwoot e, no plano Enterprise, também agem no Deskwoot.

O node do Deskwoot para o n8n é um community node: instale no n8n em Settings > Community Nodes com o nome n8n-nodes-deskwoot. O Deskwoot Trigger dele inicia um workflow com 6 eventos: uma nova conversa, uma nova mensagem de cliente, uma atribuição, uma conversa resolvida, um novo contato e uma avaliação de satisfação. Cada evento chega com campos simples, como o link, o status, a caixa de entrada, o responsável e as etiquetas da conversa, e o nome e o email do contato.

Depois, o node do Deskwoot age no Deskwoot. Ele inicia uma conversa quando o canal permite, responde ao cliente, adiciona uma nota privada, atribui uma conversa a um colega ou a um time, aplica uma etiqueta e encontra, cria ou atualiza um contato. Ele também funciona como ferramenta para os agentes de IA do n8n. Respostas e notas vindas do n8n mostram o nome da pessoa que criou o token de API.

O node entra com um token da API REST do Deskwoot, por isso exige o plano Enterprise, e um teste não inclui acesso à API. Ele funciona com o n8n no seu próprio servidor, já que o n8n Cloud oferece só community nodes que o n8n verificou. O Deskwoot assina cada evento que envia ao Deskwoot Trigger, e o trigger confere essa assinatura, então ninguém mais consegue iniciar o seu workflow pelo endereço dele.

Não está no Enterprise? A partir do plano Startup, e no teste de 7 dias, o próprio node Webhook do n8n recebe eventos do Deskwoot: cole a Production URL dele num webhook em Configurações > Webhooks. Este caminho também funciona no n8n Cloud, mas só envia eventos para fora. Para o n8n responder aos clientes como um bot, crie um bot Custom Webhook em Configurações > Bots, também a partir do plano Startup.

O que você ganha com a integração com n8n

  • Workflows iniciam com eventos do Deskwoot

    O Deskwoot Trigger inicia um workflow com novas conversas, mensagens de clientes, atribuições, conversas resolvidas, novos contatos e avaliações de satisfação.

  • Aja no Deskwoot a partir do n8n

    Responda, adicione notas privadas, atribua, aplique etiquetas, inicie conversas e mantenha contatos em dia a partir de qualquer workflow, ou deixe um agente de IA do n8n usar o node como ferramenta.

  • Cada evento é conferido

    O Deskwoot assina cada evento, e o trigger confere a assinatura. Publicar um workflow liga o trigger dele no Deskwoot, e despublicar desliga.

  • Webhooks a partir do plano Startup

    Sem o Enterprise, o node Webhook do n8n recebe eventos do Deskwoot por um webhook, inclusive no teste de 7 dias.

Como começar

Conecte o n8n em 4 passos.

  1. No n8n, vá em Settings > Community Nodes, clique em Install e digite n8n-nodes-deskwoot.
  2. No Deskwoot, um administrador abre Configurações > Tokens de API e cria um token com os escopos Leitura e Escrita. O Deskwoot mostra o token só uma vez.
  3. No n8n, crie uma credencial Deskwoot API com esse token e o ID que aparece em O ID da sua conta, na mesma página do Deskwoot. O n8n testa a credencial na hora.
  4. Adicione o Deskwoot Trigger com um evento como Customer Message Received, adicione o node do Deskwoot como próximo passo e publique o workflow.

Ver o guia de configuração

FAQ da integração com n8n

As respostas curtas estão aqui. Para qualquer outra coisa, pergunte ao Fynn abaixo.

Qual plano eu preciso?

O node do Deskwoot exige o plano Enterprise, porque entra com um token da API REST, e um teste não inclui acesso à API. O próprio node Webhook do n8n funciona a partir do plano Startup com um webhook do Deskwoot, e o teste de 7 dias também o inclui.

O node do Deskwoot funciona no n8n Cloud?

Ainda não. O n8n Cloud oferece só community nodes que o n8n verificou, então o node do Deskwoot funciona com o n8n no seu próprio servidor. O node Webhook do n8n também funciona no n8n Cloud.

Do que o Deskwoot Trigger precisa?

De um token de API criado por um administrador, porque só esse token consegue ligar triggers do Deskwoot, e de um n8n que o Deskwoot alcance pela internet via HTTPS. Quando você publica o workflow, o trigger se inscreve no evento dele no Deskwoot. Quando você despublica, o trigger remove essa inscrição.

O n8n pode responder aos clientes?

Sim. Com o node do Deskwoot, Reply envia uma mensagem pelo canal da conversa, e Add Private Note escreve uma nota que só o seu time vê. Sem o Enterprise, um bot Custom Webhook em Configurações > Bots deixa o n8n responder como um bot, a partir do plano Startup.

O que acontece quando eu revogo o token de API?

Todo trigger que esse token ligou para na hora, e as ações do node falham. Crie um novo token, atualize a credencial Deskwoot API no n8n, depois despublique e publique o workflow de novo.

Quanto custa?

O node é gratuito e de código aberto sob a licença MIT. No Deskwoot, ele vem com o plano Enterprise, e os webhooks vêm a partir do plano Startup. O preço do n8n é definido pelo próprio n8n.

Teste grátis por 7 dias

Demo interativa do Deskwoot