• Salvar cada novo lead do WhatsApp em uma planilha do Google Sheets.

• Enviar uma mensagem automática quando um registro no CRM mudar de status.

• Redirecionar um usuário dentro de um bot do WOZTELL com base em condições.

Nota: Este plugin está atualmente disponível no Programa de Acesso Antecipado (EAP) do n8n WOZTELL. Não deve ser usado em ambientes de produção nem com dados sensíveis.

O que é o n8n

Vantagens principais de usar o n8n com o WOZTELL

• Automação sem código: Crie fluxos de trabalho visuais sem necessidade de conhecimento em programação.

• Flexibilidade: Conecte o WOZTELL com qualquer sistema ou API compatível com o n8n.

• Economia de tempo: Automatize tarefas repetitivas como captura de leads ou acompanhamento de clientes.

• Escalabilidade: Expanda facilmente sua lógica de automação à medida que o seu negócio cresce.

• Controle de dados: Hospede o n8n na sua própria infraestrutura para manter a conformidade e a privacidade dos dados.

Requisitos

Antes de começar, verifique se você tem:

• Uma conta ativa no WOZTELL.

• Pelo menos um canal conectado (WhatsApp Cloud API, Messenger, Instagram ou Webchat).

• Acesso a uma instância do n8n (nuvem ou auto-hospedada).

• Acesso de administrador no WOZTELL para gerar um Token de Acesso.

Instalar o pacote

Para instalar o pacote de nós da comunidade WOZTELL no n8n:

Você pode acessar diretamenten o N8N + WOZTELL https://www.npmjs.com/package/@woztell-sanuker/n8n-nodes-woztell-sanuker-eap

Para mais informações, consulte o guia de instalação de Community Nodes do n8n.

Configurar credenciais

Antes de usar o plugin, você precisa obter suas credenciais de API na plataforma WOZTELL. Essas credenciais funcionam como chaves de autenticação para acessar a API do Produto WOZTELL. Certifique-se de ativar as permissões necessárias para o seu caso de uso e inserir essas informações na configuração de credenciais WOZTELL no n8n.

Para mais detalhes, confira a documentação sobre Tokens de Acesso da WOZTELL.

Token da API do Canal para templates do WhatsApp: cada canal WOZTELL possui seu próprio Token da API do Canal usado para mensagens com Template do WhatsApp. Insira esse token no segundo campo da credencial WOZTELL. Recomendamos criar credenciais separadas para cada canal. Mais informações: WhatsApp Cloud Public API.

Criar seu primeiro fluxo de trabalho

Triggers e Nós

Visão geral

Ao pesquisar “WOZTELL” na barra lateral, você encontrará os nós e triggers disponíveis. Basta arrastá-los para o seu fluxo de trabalho.

• Triggers: Recebem dados via webhook dos canais do WOZTELL.

• Ações da Bot API: Enviam mensagens e executam ações via WOZTELL.

• Ações de Membro: Gerenciam informações de contato (consulta, atualização, marcação) armazenadas no WOZTELL.

Webhook: Ao receber mensagem do WOZTELL

Esse gatilho (trigger) recebe mensagens webhook de qualquer canal do WOZTELL, incluindo eventos de entrada, saída e atualização de membro. As mensagens são entregues em formato JSON com os detalhes do evento.

Você pode configurar o caminho do Webhook e filtrar por ID de Canal ou Tipo de Evento.

Mais informações: documentação sobre Webhooks da WOZTELL.

Nó: Enviar Resposta

Envia uma mensagem do seu número do WhatsApp Business para a conta do cliente por meio da BotAPI do WOZTELL. O conteúdo da mensagem é definido diretamente nos dados da Resposta.

Após o envio, a resposta da API estará disponível para os próximos nós continuarem o processamento.

Mais informações: Referência da API de Envio de Respostas.

Nó: Redirecionar Membro para um Nó

O nó “Redirecionar Membro para um Nó” redireciona o fluxo atual para um ponto específico dentro da Árvore de Chatbot do WOZTELL.

Em vez de criar manualmente payloads JSON para enviar templates do WhatsApp ou acionar fluxos, você pode simplesmente usar este nó e passar parâmetros básicos. O Chatbot do WOZTELL cuidará da lógica para você.

Esse nó funciona como um ponteiro — ele entrega o controle de volta à estrutura existente do seu bot e permite que ela conduza os próximos passos.

Ideal para usuários que integram o n8n com bots do WOZTELL.

Mais informações: Referência da API: Redirecionar Membro para Nó.

Nó: Enviar Mensagem de Template do WhatsApp

De acordo com as regras oficiais de mensagens do WhatsApp, se você quiser entrar em contato com um usuário fora da janela de 24 horas — ou com alguém que nunca enviou uma mensagem para você — deve usar uma Mensagem de Template pré-aprovada.

Este nó do n8n simplifica esse processo. Em vez de construir a mensagem manualmente, ele permite selecionar um template previamente aprovado e preencher os campos obrigatórios. A mensagem é então gerada automaticamente e enviada no formato correto.

Nó: Obter membros por tags

“Obter Membros por Tags” recupera contatos de um canal específico com base em uma ou mais tags atribuídas. Ele utiliza o endpoint Get Member Information da WOZTELL Open API para buscar todos os membros associados aos rótulos selecionados.

Cada consulta retorna até 100 registros. Se o número de resultados ultrapassar esse limite, você pode usar o campo Cursor para paginação manual ou ativar a opção Return All para buscar todos os registros automaticamente.

Mais informações: WOZTELL Open API.

Nó: Definir tags de membro

O nó “Definir Tags de Membro” permite atribuir uma ou mais tags a um contato em um canal específico usando a Open API da WOZTELL.

As tags são usadas em diversos recursos da WOZTELL, como Campanhas, Gerenciamento de Contatos e Construtor de Chatbot. Elas permitem segmentar usuários, acompanhar status comerciais e personalizar fluxos de trabalho com base no perfil ou comportamento do usuário.

Esse nó pode ser colocado em qualquer ponto do seu fluxo onde seja necessário aplicar lógica baseada em tags.

Nó: Obter informações do membro por ID

Este nó recupera o perfil de um membro usando seu ID Externo em um canal específico. Para canais do WhatsApp, o ID Externo corresponde ao número de telefone do usuário.

Ele retorna todos os dados de contato, incluindo metadados e, na versão mais recente, a localização atual da conversa na Caixa de Entrada.

Para usar este nó:

1. Selecione a credencial associada à sua conta WOZTELL.
2. Escolha o canal correspondente.
3. Insira o ID Externo do contato.

Mais informações: WOZTELL Open API · Visão geral da Caixa de Entrada.

Nó: Obter histórico de conversa por ID

O nó “Obter Histórico de Conversa por ID” recupera o histórico de conversas de um contato usando seu ID Externo e um intervalo de tempo definido.

Isso é especialmente útil para auditorias, fluxos de suporte ou para melhorar o treinamento do chatbot com base em interações anteriores.

Para usar este nó:

1. Selecione a credencial vinculada à sua conta WOZTELL.
2. Escolha o canal de conversa.
3. Insira o ID Externo do contato.
   
4. Defina o intervalo de tempo para a consulta (timestamps de início e fim).
   

Nota:

O intervalo de tempo é obrigatório. Sem ele, as consultas podem falhar devido ao alto volume de dados.

Se forem esperados mais de 100 resultados, utilize o campo Cursor para paginação ou ative a opção Return All.

Mais informações: WOZTELL Open API.

Casos de uso

• Captura de leads: Salvar leads do WhatsApp no Google Sheets e enviar uma mensagem de confirmação.

• Integração com CRM: Atualizar um registro no CRM e acionar uma notificação via WhatsApp usando WOZTELL.

• Roteamento de chatbot: Redirecionar clientes de um fluxo de suporte para vendas usando a ação Redirecionar Membro para Nó.

Melhores práticas

• Ambientes separados: Use um ambiente de teste dedicado para experimentar novos fluxos antes de implantá-los em produção.

• Gestão de tokens: Mantenha seus Tokens de Acesso seguros, limite seu escopo e faça a rotação regularmente.

• Tratamento de erros: Adicione ramificações de erro e lógica de repetição no n8n para garantir que os fluxos se recuperem de falhas temporárias.

• Monitoramento e logs: Revise os logs de execução no n8n para acompanhar o desempenho e resolver problemas.

• Escalabilidade: Comece com fluxos simples e expanda conforme as necessidades do seu negócio crescem.