Base de Conhecimento

Twilio no n8n: envie SMS e mensagens pelo fluxo

  • twilio, n8n, sms, webhook, automação, ligações
  • Usuários acharam útil: 0

Veja o que a conta de teste da Twilio não faz, crie a credencial, envie o primeiro SMS, receba respostas pelo webhook e configure o pedido de saída em português.

Por Redação Eleven Host · @robson.direitodigital · 17 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: Twilio no n8n: envie SMS e mensagens pelo fluxo

Capa da Redação Eleven Host para o tutorial: Twilio no n8n: envie SMS e mensagens pelo fluxo Arte: Eleven Host

Usar twilio no n8n é enviar SMS e fazer ligações com o nó Twilio e receber SMS com o Twilio Trigger, tudo com a mesma credencial Twilio API.

No Brasil, segundo a Twilio, o número longo brasileiro serve só para conversa entre pessoas (P2P). Mensagem de empresa vai por short code, remetente alfanumérico ou número de outro país.

Atualizado em 17/11/2026. Em 17/11/2026, a versão estável do n8n é a 2.48.4, publicada em 13/11/2026, e o nó Twilio e o Twilio Trigger estão na versão 1.

O que o n8n oferece para a Twilio

O nó Twilio tem dois recursos em Resource: SMS, com a operação Send, e Call, com a operação Make, que liga e fala o texto da mensagem.

O Twilio Trigger inicia o fluxo a partir de um evento da Twilio. Em Trigger On, as opções são New SMS, quando um SMS chega, e New Call, quando uma chamada é recebida. O aviso do New Call pode levar até 30 minutos.

Para quem serve

Serve para a empresa que roda o n8n na própria VPS e quer lembretes e avisos por SMS: horário marcado, pedido enviado, alerta interno. Há um artigo sobre servidor VPS.

Veja os planos de VPS da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver na loja

Passo 1: a conta Twilio e o que a conta de teste não faz

Crie a conta no site da Twilio. Segundo ela, a conta de teste (trial) expira 30 dias depois do cadastro e tem limites que atrapalham quem quer mandar mensagem de verdade pelo n8n:

  • o SMS só vai para números verificados, até 5 por conta, e a página de teste de SMS cita números dos EUA;
  • o texto não é livre: o corpo tem de ser um dos modelos prontos da Twilio, como confirmação de pedido ou lembrete de agendamento;
  • o remetente é um número compartilhado da Twilio, que não acompanha a conta no upgrade.

Quem está no Brasil não deve contar com SMS livre para o próprio celular durante o trial. Para testar o fluxo como ele vai funcionar, faça o upgrade da conta e compre um número, como a Twilio orienta depois do upgrade.

Passo 2: remetente e regras do Brasil

O que vai em From depende do remetente que a conta tem. Segundo a Twilio, as opções para mensagem de empresa são:

  • Short code: suportado, com prazo de 2 a 4 semanas;
  • Remetente alfanumérico: o dinâmico não é suportado, e o pré-registro é opcional, só para TIM, Claro e Vivo, com prazo de 10 semanas;
  • Número de outro país com SMS, cujo remetente pode ser trocado por short code ou número longo aleatório.

O número longo brasileiro fica para conversa entre pessoas. A Twilio também avisa que SMS para telefone fixo é bloqueado (erro 400, código 21614) e que acentos podem virar caracteres sem acento em várias operadoras.

Horário e consentimento

  • Segundo a Twilio, marketing é proibido fora do intervalo de 09h às 22h, no horário local, e o domingo inteiro. O Brasil tem três fusos;
  • A Twilio recomenda ter o opt-in do destinatário antes de enviar, sobretudo para marketing;
  • Os números vão em formato E.164: +, código do país, DDD e número, com até 15 dígitos. Para o Brasil, +55 antes do DDD.

Passo 3: a credencial Twilio API

Antes de abrir o n8n, abra o Console da Twilio. Em Dashboard > Account Info ficam o Account SID e o Auth Token. Se preferir a chave de API, copie o Account SID dali, vá em API keys & tokens, clique em Create API Key, informe o nome e o tipo e clique de novo em Create API Key. Na tela Copy secret key, copie o SID e o Secret. O n8n informa que funciona com chaves Main e Standard e que a Restricted não foi testada.

No n8n, crie uma credencial Twilio API. O campo Auth Type aceita Auth Token (padrão), ou API Key, com Account SID, API Key SID e API Key Secret. A Twilio recomenda o Auth Token só para teste local e a chave de API para produção.

Para quem vai usar o Twilio Trigger, recomendamos o Auth Token: com ele o n8n confere a assinatura de cada aviso, e com chave de API essa conferência não acontece. Recomendamos não colocar o token em código público ou repositório.

Passo 4: o envio de teste

Crie um fluxo com gatilho manual e um nó Twilio. Escolha a credencial do passo 3, Resource igual a SMS e Operation igual a Send. Preencha estes campos obrigatórios:

  • From: o número da conta que envia;
  • To: o número que recebe, em E.164, como +5511999990000;
  • Message: o texto.

Execute o nó e confira se a mensagem chegou ao aparelho. Com a conta de teste, só vale um modelo da Twilio, como no passo 1.

Para ligar, use Resource igual a Call e Operation igual a Make; o texto de Message é falado na ligação.

Passo 5: receber SMS com o Twilio Trigger

A Twilio é quem chama o seu n8n, então ele precisa de uma URL pública. Atrás de proxy reverso, defina no ambiente do n8n a variável N8N_WEBHOOK_URL com o endereço público e N8N_PROXY_HOPS=1, e reinicie o n8n. Um exemplo, para conferir no seu servidor:

N8N_WEBHOOK_URL=https://n8n.exemplo.com/

N8N_PROXY_HOPS=1

A variável antiga WEBHOOK_URL está obsoleta desde o n8n 2.35.0 e gera aviso no log. Recomendamos HTTPS. Como a assinatura usa a URL exata, uma URL pública errada pode causar erro 401.

Crie outro fluxo com o nó Twilio Trigger, a credencial com Auth Token e Trigger On igual a New SMS. Publique o fluxo. Quando chegar um SMS, ele deve aparecer na lista de execuções do fluxo.

Esse gatilho responde à Twilio assim que recebe o aviso, então não serve para devolver uma resposta automática ao remetente.

Passo 6: responder pelo webhook do número

Para responder ao SMS, use o caminho do webhook do número: primeiro o fluxo no n8n, depois a URL no Console da Twilio.

No n8n, crie um nó Webhook com método POST e Respond igual a Using 'Respond to Webhook' Node. A Test URL só escuta enquanto você clica em Listen for Test Event. A Production URL só funciona depois de publicar o fluxo, e é ela que vai para o Console.

A Twilio envia os dados como formulário (application/x-www-form-urlencoded), com parâmetros como MessageSid, From, To e Body, e espera TwiML na resposta. Para não responder nada, devolva um TwiML vazio. Recomendamos um nó Respond to Webhook com o cabeçalho Content-Type igual a text/xml. Um exemplo de corpo, para conferir no seu n8n:

<Response></Response>

Um exemplo de resposta com texto, no formato que a Twilio mostra:

<Response><Message>Recebemos sua mensagem, obrigado!</Message></Response>

O nó Webhook do n8n não tem opção de conferir a assinatura da Twilio. Para proteger a URL, recomendamos Basic auth no próprio nó, com usuário e senha na URL cadastrada no Console, ou a validação de X-Twilio-Signature num nó de código.

Com o fluxo publicado, abra no Console da Twilio a página Numbers, clique no número e, na seção Messaging, ache a opção A MESSAGE COMES IN. Escolha Webhook, cole a Production URL e selecione POST.

Passo 7: pedido de saída (STOP)

Por padrão, a Twilio trata as respostas de saída em inglês nos números longos: STOP, UNSUBSCRIBE, END, QUIT, STOPALL, REVOKE, OPTOUT e CANCEL. Para palavras em português, a Twilio oferece o Advanced Opt-Out, configurado num Messaging Service, onde dá para definir palavras e respostas em outros idiomas. Recomendamos cadastrar SAIR e PARAR.

Enviar para quem pediu saída falha com o erro 21610 da Twilio. Recomendamos guardar no fluxo quem consentiu e quando.

Combinações para começar

Um exemplo: lembrete de horário. Um Schedule Trigger diário busca os agendamentos do dia seguinte numa planilha ou agenda e chama o nó Twilio, com To igual a {{ $json.telefone }} e uma Message com nome e hora.

Um exemplo: aviso de pedido. O webhook da loja avisa que o pedido foi pago ou enviado, e o nó Twilio manda o número do pedido, só para quem aceitou receber SMS. Para o aviso de pagamento, veja Mercado Pago no n8n: receba avisos de pagamento.

Um exemplo: alerta interno. Um Error Trigger, ou um HTTP Request que checa um site, aciona o nó Twilio para o celular do responsável. Outro canal de alerta está em Slack no n8n: mensagens e alertas automáticos.

Problemas comuns

  • Erros 21610 e 21614: o destinatário pediu saída ou o destino é telefone fixo;
  • Erro 401 no Twilio Trigger: confira a URL pública e as variáveis do passo 5;
  • O SMS recebido não aciona o fluxo: confira se o fluxo está publicado e se a Production URL foi para o Console.

Onde o n8n fica no ar

O n8n precisa estar de pé para executar os fluxos, e uma VPS própria é uma das formas de mantê-lo no ar.

Conheça a VPS da Eleven Host, vendida por plano mensal. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos

Perguntas frequentes

Posso testar com a conta de teste (trial) da Twilio?

Só de forma limitada. Segundo a Twilio, o teste aceita apenas modelos de mensagem e destinos verificados. Para texto livre, faça o upgrade e use um número da conta.

Qual número uso como remetente no Brasil?

Para mensagem de empresa, a Twilio indica short code, remetente alfanumérico ou número de outro país. O número longo brasileiro é só para conversa entre pessoas.

O Twilio Trigger responde o SMS sozinho?

Não. Para responder, use o webhook do número no Console com o nó Webhook e um TwiML de resposta, ou envie uma nova mensagem com o nó Twilio.

O nó Webhook confere a assinatura da Twilio?

Não. O Twilio Trigger confere quando a credencial usa Auth Token; no Webhook, valide o cabeçalho num nó de código.

Esta resposta lhe foi útil?

Artigos Relacionados