Configurar verificação SMS com Twilio SMS

O conector oficial do Logto para o serviço de mensagens curtas Twilio.

dica

Neste guia, assumimos que você tem conhecimento básico sobre Conectores (Connectors) do Logto. Se não tiver, confira o guia Configurar conectores para começar.

Introdução

Twilio fornece ferramentas de comunicação programáveis para fazer e receber chamadas telefônicas, enviar e receber mensagens de texto e outras funções de comunicação. Podemos enviar mensagens de texto de "código de verificação" através de suas APIs de serviço web.

Registrar conta Twilio

Crie uma nova conta no Twilio. (Pule para o próximo passo se você já tiver uma.)

Configurar números de telefone dos remetentes

Vá para a página do console Twilio e faça login com sua conta Twilio.

Compre um número de telefone em "Phone Numbers" -> "Manage" -> "Buy a number".

ℹ️ Dica

Às vezes, você pode encontrar a situação em que o serviço de SMS não é suportado em países ou áreas específicas. Escolha um número de outras regiões para contornar.

Uma vez que tenhamos um número válido reivindicado, navegue para "Messaging" -> "Services". Crie um novo Serviço de Mensagens clicando no botão.

Dê um nome amigável ao serviço e escolha Notify my users como nosso propósito de serviço. No próximo passo, escolha Phone Number como Sender Type, e adicione o número de telefone que acabamos de reivindicar a este serviço como remetente.

ℹ️ Nota

Cada número de telefone pode ser vinculado apenas a um serviço de mensagens.

Obter credenciais da conta

Precisaremos das credenciais da API para fazer o conector funcionar. Vamos começar pela página do console Twilio.

Clique no menu "Account" no canto superior direito, depois vá para a página "API keys & tokens" para obter seu Account SID e Auth token.

Volte para a página de configurações de "Messaging" -> "Services" a partir da barra lateral e encontre o Sid do seu serviço.

Compor o JSON do conector

Preencha os campos accountSID, authToken e fromMessagingServiceSID com Account SID, Auth token e Sid do serviço de mensagens correspondente.

Você pode adicionar vários modelos de conector SMS para diferentes casos. Aqui está um exemplo de adição de um único modelo:

• Preencha o campo content com conteúdos de string arbitrária. Não se esqueça de deixar o espaço reservado {{code}} para o código de verificação aleatório.
• Preencha o campo usageType com Register, SignIn, ForgotPassword, Generic para diferentes casos de uso. Para habilitar fluxos completos de usuário, são necessários modelos com usageType Register, SignIn, ForgotPassword e Generic.

Testar o conector Twilio SMS

Você pode inserir um número de telefone e clicar em "Send" para ver se as configurações funcionam antes de "Save and Done".

É isso. Não se esqueça de Habilitar conector na experiência de login.

Tipos de configuração

Nome	Tipo
accountSID	string
authToken	string
fromMessagingServiceSID	string
templates	Templates[]

Propriedades do Modelo	Tipo	Valores do enum
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referência

• Twilio - Dicionário de Erros e Avisos