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

• 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

Como disparar ligações, SMS e SMS Flash em um workflow

• Enviar ligações (Send Voice)

• Enviar SMS e SMS Flash (Send SMS/Flash)

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.

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. Após o upload, utilize o ID gerado no campo voice_upload_id do node Send Voice.

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

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.

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.

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

• Pacote NPM