Twilio no n8n: envie SMS e mensagens pelo fluxo
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

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,+55antes 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.