Com o node oficial da LigueLead no n8n, você dispara ligações com áudio gravado, SMS e SMS Flash direto dos seus workflows, conectando a LigueLead às suas demais ferramentas de forma rápida e escalável. 

Este artigo descreve a versão 1.0.0 do node oficial da LigueLead no n8n. O node é oficial do n8n e está disponível diretamente no catálogo da plataforma — não é necessário instalar pacotes externos para utilizá-lo. 

O que você vai aprender 

• O que é a integração da LigueLead com o n8n 
• Como adicionar o node ao seu workspace 
• Onde encontrar o Token de API e o App ID 
• Como disparar ligações, SMS e SMS Flash em um workflow 
• Como preparar os dados que serão enviados ao node 
• Como acompanhar envios, créditos e limites de uso 

Antes de começar 

Para utilizar o node da LigueLead no n8n, você precisa: 

• Ser cliente da API LigueLead 
• Ter acesso ao n8n 
• Possuir um API Token 
• Possuir um App ID — recomendamos criar um App ID exclusivo para a integração com o n8n, facilitando a rastreabilidade dos envios 

Como adicionar o node da LigueLead no n8n 

Por ser um node oficial, a LigueLead aparece diretamente nas buscas do n8n. Você pode adicionar o node de três formas: 

• Pelo Nodes panel: abra o painel de nodes e busque por LigueLead 
• Pela busca (lupa): clique na lupa e digite LigueLead 
• Pelo Add node: clique em Add node e procure por LigueLead 

Ao encontrar o node, clique em Instalar para adicioná-lo ao seu workspace. Após a instalação, o node ficará disponível para uso nos seus workflows. 

Instalação via Community Nodes: caso sua instância do n8n não localize o node pelo catálogo oficial, ainda é possível instalá-lo manualmente via Community Nodes, utilizando o pacote @liguelead/n8n-nodes-liguelead. Nesse caso, pode ser necessário reiniciar o n8n após a instalação. 

Como configurar a conexão 

Ao adicionar o node da LigueLead, configure a conexão com os dados da sua conta API. Esses dados são usados para autenticação, rastreabilidade da origem dos envios e atribuição correta de custos. 

A conexão precisa ser configurada no primeiro acesso ou sempre que um novo cadastro de credencial for criado. 

Onde encontrar o Token e o App ID 

• Acesse a plataforma da API da LigueLead e faça login 
• No menu lateral, vá em Integrações > Token API 
• Nessa tela, você encontrará seu Token de API e a opção para adicionar um novo App 
• Crie um App identificado para a integração com o n8n 
• Após a criação, será gerado um App ID 
• Utilize o Token e o App ID nos campos de conexão do node no n8n 

O que você pode fazer com o node 

• Enviar ligações (Send Voice) 
• Enviar SMS e SMS Flash (Send SMS/Flash) 

Formato dos números de telefone 

Os envios aceitam números de telefone com ou sem código do país (DDI). 

Para melhor compatibilidade, recomendamos utilizar o formato nacional com 11 dígitos. 

Enviar ligação (Send Voice) 

Envia mensagens de voz pré-gravadas para uma lista de telefones. O destinatário recebe uma chamada telefônica que reproduz automaticamente o áudio configurado. 

Campos obrigatórios: 

Exemplo de payload: 

No n8n, o campo phones aceita números separados por vírgula ou o dado recebido diretamente de outro node. Consulte a seção Como preparar os dados para envio. 

Enviar SMS e SMS Flash (Send SMS/Flash) 

Dispara SMS padrão ou SMS Flash para múltiplos números. 

Campos obrigatórios: 

Campo opcional: 

Exemplo de payload: 

O SMS Flash tem o mesmo funcionamento do SMS padrão, com exibição imediata no dispositivo do usuário. Basta ativar o campo isFlash no envio. 

Como preparar os dados para envio: 

Preencher o campo phones 

O campo phones aceita dois formatos: 

1. Digitação direta — insira os números separados por vírgula diretamente no campo: 

2. Dados vindos de outro node — quando os telefones chegam de um node anterior (por exemplo, uma lista de leads), conecte o campo phones à saída do node. 

Caso sua automação retorne dados estruturados, utilize um node intermediário (como JSON Node ou Edit Fields) para transformar o payload e retornar apenas os telefones no formato esperado. 

Envio do áudio (voice_upload_id) 

Para realizar envios de mensagens de voz, o áudio precisa ser enviado previamente, gerando um voice_upload_id. O upload do áudio deve ser feito conforme a documentação da API da LigueLead (https://docs.liguelead.com.br/reference/upload-an-audio-file). Após o upload, utilize o ID gerado no campo voice_upload_id do node Send Voice. 

Usar o node Edit Fields 

Quando precisar preencher os campos title e message de forma dinâmica, utilize o node Edit Fields antes do node da LigueLead. Esse node pode ser usado para: 

• Personalizar mensagens com dados do lead ou do evento 
• Criar títulos descritivos para identificar os envios 
• Ajustar o payload para ficar compatível com o node da LigueLead 

Como acompanhar os envios e relatórios 

Os envios realizados pelo node da LigueLead no n8n podem ser acompanhados diretamente na plataforma API da LigueLead. 

• Faça login na plataforma da LigueLead com seu e-mail e senha 
• No menu lateral, acesse Relatórios para visualizar a consolidação dos envios e os valores consumidos 

A origem da automação é identificada pelo App ID utilizado na integração com o n8n, facilitando a rastreabilidade dos envios. 

Como funciona a cobrança 

A cobrança segue o modelo da API LigueLead: 

• Pré-pago 
• Consumo por envio 
• Centralizado na conta LigueLead do cliente 

Compra de créditos 

• Faça login na plataforma da LigueLead 
• No menu lateral, acesse Créditos > Comprar 
• Escolha o tipo de canal: Ligação, SMS ou SMS Flash 
• Realize o pagamento 

Após a confirmação, os créditos ficam disponíveis para uso e podem ser consumidos normalmente pelos envios realizados via n8n. 

Limites e restrições: 

Limites de requisição 

 Em fluxos de alto volume, recomendamos distribuir os envios ao longo do tempo para evitar bloqueios. 

Envios de ligação 

Horário permitido: mensagens de voz podem ser enviadas apenas entre 8h e 22h (horário de Brasília). Envios realizados fora desse horário ficam em espera e são processados automaticamente no próximo horário permitido. 

Duração e cobrança: 

Formatos e limites de arquivo: 

Envios de SMS 

O SMS suporta até 1.600 caracteres. Mensagens são divididas automaticamente em partes: 

• Até 160 caracteres → 1 crédito 
• A cada 152 caracteres adicionais → +1 crédito 
• Emojis e caracteres especiais são suportados 

Exemplos: 

Boas práticas de uso 

• Teste com pequenos volumes antes de escalar os envios. Isso ajuda a validar o fluxo e evita consumo indevido de créditos 
• Reutilize áudios já enviados sempre que possível. O mesmo áudio pode ser usado em múltiplos envios com o mesmo voice_upload_id 
• Use títulos claros e descritivos. Títulos bem definidos facilitam a identificação dos envios em relatórios e no suporte 

Links úteis 

• Documentação da API LigueLead: https://docs.liguelead.com.br 
• Pacote NPM: https://www.npmjs.com/package/@liguelead/n8n-nodes-liguelead