Configurar verificação SMS com Tencent Short Message Service

O conector oficial do Logto para o Tencent Short Message Service.

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.

Conector Oficial do Logto para o Serviço de SMS da Tencent Cloud Documentação em Chinês

Conector de SMS da Tencent Cloud

A Tencent Cloud é um importante provedor de serviços em nuvem na Ásia, oferecendo uma ampla gama de serviços, incluindo SMS.

Este conector, fornecido oficialmente pelo Logto, permite que os usuários finais se registrem e façam login via códigos de verificação SMS.

Configurar um serviço de SMS no Console de SMS da Tencent Cloud

💡 Dica

Você pode pular partes que já completou.

Criar uma Conta na Tencent Cloud

Vá para Tencent Cloud e complete o registro da conta.

Ativar e Configurar o Serviço de SMS da Tencent Cloud

1. Faça login na Tencent Cloud com sua conta recém-registrada e navegue até o Console de Serviço de SMS.
2. Clique no botão "Teste Gratuito" no canto superior esquerdo da página do Serviço de SMS para iniciar o processo de configuração.
3. Concorde com os "Termos de Uso do Serviço de SMS" e ative o serviço para prosseguir.
4. Agora você estará na "Visão Geral do Console de Serviço de SMS." Dependendo do seu caso de uso, clique em "Mensagens Domésticas" ou "Mensagens Internacionais/Grande China" na barra lateral.
5. Siga as instruções para adicionar uma assinatura e modelos, fornecendo os materiais necessários para aprovação:
   • Nota: Ao adicionar uma assinatura, selecione "Código de Verificação" em "Cenário de Aplicação." Da mesma forma, ao adicionar um modelo, escolha "Código de Verificação" em "Tipo de Modelo," pois o objetivo aqui é enviar códigos de verificação. O envio de outros tipos de mensagens de texto não é suportado atualmente.
   • Certifique-se de que o conteúdo do seu modelo inclua um espaço reservado {1}, que será substituído por um código de verificação gerado aleatoriamente quando o SMS for enviado.
   • Apenas modelos com um único espaço reservado são suportados. Selecione ou crie modelos com apenas um espaço reservado.
6. Após enviar as aplicações de assinatura e modelo, aguarde sua aprovação. Enquanto isso, você pode retornar à Visão Geral do Console de Serviço de SMS para enviar mensagens de teste. Se sua assinatura e modelo forem aprovados, use-os diretamente para testes. Caso contrário, a Tencent fornece modelos de teste.
   • Você pode precisar recarregar sua conta com uma pequena quantia antes de enviar mensagens de teste.
   • Vincule o número de telefone que você planeja usar para testes com antecedência para garantir o recebimento bem-sucedido das mensagens de teste. Clique na guia "Guia do Iniciante" no topo da Visão Geral do Console de Serviço de SMS para mais detalhes.

Escrever a Configuração JSON do Conector

1. Vá para a Visão Geral do Console de Serviço de SMS, passe o mouse sobre seu perfil no canto superior direito, navegue até "Gerenciamento de Acesso" e clique em "Chaves de Acesso" em "Chave de API." Após completar a verificação de segurança, você receberá um "ID de Chave de Acesso" e um "Segredo de Chave de Acesso." Mantenha-os seguros.
2. Navegue de volta para a guia "Mensagens Domésticas" ou "Mensagens Internacionais/Grande China," onde você pode encontrar facilmente o "Nome da Assinatura" e o "CÓDIGO do Modelo."
   • Para usar uma assinatura e modelo específicos de teste, vá para a guia "Início Rápido" para encontrá-los em "Modelo de Assinatura de Teste."
3. Complete a configuração do Conector de SMS da Tencent Cloud:
   • Preencha accessKeyId e accessKeySecret com o par que você obteve na etapa 1.
   • Use o "Nome da Assinatura" da etapa 2 para o campo signName. Todos os modelos compartilharão esta assinatura.
   • Adicione vários modelos de SMS para atender a diferentes cenários de usuário. Abaixo está um exemplo de adição de um único modelo:
     • Use o "CÓDIGO do Modelo" da etapa 2 para o campo templateCode para controlar o conteúdo do SMS.
     • O campo usageType deve ser um dos Register, SignIn, ForgotPassword ou Generic para corresponder aos cenários de Registro, Login, Esqueceu a Senha ou Geral. (O atributo usageType é específico do Logto e determina o cenário de uso.) Para uma configuração completa, configure modelos para Register, SignIn, ForgotPassword e Generic.
   • Obtenha o ID do App na seção Gerenciamento de Aplicativos e preencha no campo sdkAppId.
   • Consulte a Documentação da API de SMS para regiões suportadas e preencha o campo region.

Testar o Conector de SMS da Tencent Cloud

Antes de clicar em "Salvar e Completar," insira um número de telefone e clique em "Enviar" para testar se a configuração funciona corretamente.

Tudo pronto! Prossiga para Habilitar inscrição ou login por número de telefone.

Esquema de Configuração

Nome	Tipo
accessKeyId	string
accessKeySecret	string
signName	string
region	string
sdkAppId	string
templates	Template[]

Atributo do Template	Tipo	Valores Enum
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referências

• Tencent Cloud: Como Implementar Códigos de Verificação SMS