SMS com Twilio

Sem o Twilio, o app não envia SMS: as automações com canal SMS não entregam, e o login por telefone não fica disponível, porque é o Twilio que manda o código.

Antes de começar

• Plano: qualquer um, inclusive o Free;
• Conta na Twilio, com cartão cadastrado para comprar um número;
• Custo em dois lugares:
  • a Twilio cobra o número (mensalidade) e cada SMS, na sua conta, pela tabela dela;
  • cada SMS enviado pelo app consome créditos de integração da plataforma, e o SMS é o canal de aviso mais caro em créditos. Isso inclui cada código de login por SMS. O débito só acontece quando a Twilio aceita o envio.

Passo a passo

Campos do card: Account SID, Auth Token e Número remetente.

1. crie a conta em twilio.com;
2. no Console da Twilio, a página inicial mostra o Account SID (começa com AC) e o Auth Token (clique para revelar);
3. em Phone Numbers → Manage → Buy a number, compre um número com capacidade de SMS. Alguns países exigem um cadastro regulatório antes de liberar o número: a própria Twilio indica quando for o caso;
4. no editor do app, aba Integrações, categoria Notificações, abra o card SMS (Twilio);
5. preencha o Account SID, o Auth Token e, em Número remetente, o número comprado no formato internacional, com + e código do país (por exemplo, +5511999999999);
6. clique em Salvar e ativar.

Conta de teste (trial)

Enquanto a conta Twilio está em trial, ela só envia para números verificados e a mensagem chega com um prefixo de teste. Para testar, cadastre o seu número em Verified Caller IDs no Console. Para o app em uso, a conta precisa sair do trial.

Login por telefone

Com o Twilio conectado, o app passa a poder oferecer entrada com número de telefone e código recebido por SMS, e recuperação de senha pelo mesmo caminho. Não é na aba Autenticação que isso se liga: é a presença do Twilio que libera. O resto está em Cadastro e login no seu app.

Vale planejar o saldo: cada tentativa de login por SMS é um SMS pago na Twilio e um débito em créditos de integração. Com o saldo de créditos zerado, o código não é enviado e a pessoa não consegue entrar por telefone.

Como saber que funcionou

O card do Twilio não testa a credencial ao salvar: Conectado quer dizer que os campos foram salvos. A prova é um SMS real:

• se o app tem login por telefone, peça um código com o seu número;
• ou peça no chat um botão de teste que envie um SMS para você (isso gasta crédito de IA, como qualquer construção).

No Console da Twilio, em Monitor → Logs → Messaging, cada tentativa aparece com o status e, se falhou, o motivo.

Problemas comuns

• Nenhum SMS chega e não aparece nada nos logs da Twilio. A credencial está errada. Abra o card e digite de novo o campo que estiver errado (um campo em branco mantém o valor salvo);
• Aparece nos logs como falha para números não verificados. A conta está em trial. Verifique o número de destino ou saia do trial;
• O número remetente é recusado. Ele precisa ser um número da sua conta Twilio com capacidade de SMS, escrito com + e código do país;
• Parou de enviar de uma hora para outra. Veja o saldo de créditos de integração, no painel em Cobrança, e o saldo da própria conta Twilio.