Passar para o conteúdo principal

Guia de Integração: Auth0

Envie OTPs automatizados e notificações por SMS seguras diretamente do seu aplicativo Auth0 usando o ClickSend.

Atualizado hoje

O que está incluído

Ao integrar o ClickSend com o Auth0, você obterá:

  • Verificação OTP – Enviar senhas de uso único para login ou cadastro

  • Notificações por SMS – Enviar notificações em tempo real para autenticação multifator (MFA)


Pré-requisitos

  • Uma conta ClickSend

  • Uma conta Auth0

  • Suas credenciais de API da ClickSend (nome de usuário + chave de API)


Instalação

  1. Configurar o ClickSend no Auth0:

    • Faça login no seu painel do Auth0.

    • Vá para o Marketplace e clique em Add Integration (Adicionar Integração).

    • Escolha seu locatário (tenant) e conceda as permissões necessárias.

    • Você será redirecionado para a biblioteca, onde precisará inserir suas credenciais da API do ClickSend (nome de usuário e chave de API).

    • A chave de API pode ser encontrada no seu painel do ClickSend: Chave de API do ClickSend.

    • Clique em Criar para salvar a conexão.

  2. Configurar as configurações de OTP no Auth0:

    • Vá para o Painel > Segurança > Autenticação multifator.

    • Ativar a Senha de uso único (OTP).

    • Role até Definir políticas e defina Exigir autenticação multifator como Sempre e, em seguida, clique em Salvar.

  3. Configurar a mensagem de telefone para SMS:

    • Em Segurança, configure o Phone Message Factor para entrega de SMS.

    • Ative Phone Message e salve suas alterações.

  4. Adicionar a Ação do ClickSend ao Fluxo:

    • Clique em Add to Flow na janela pop-up que for exibida.

    • Arraste a Ação do ClickSend para o local desejado no seu fluxo de MFA.


Autenticação

Para ativar o componente de SMS:

  1. Nas configurações de componente do Auth0, vá para Credenciais da API.

  2. Insira:

    • Nome de usuário – O seu nome de usuário do ClickSend

    • Chave de API – A chave encontrada no seu painel do ClickSend


Verificação OTP (Senhas de uso único)

Verifique os usuários durante o login ou cadastro usando senhas de uso único (OTP).

Configuração

  1. Vá para o Menu de verificação > Corpo da mensagem.

  2. Inclua %otp% onde você deseja que o OTP apareça na sua mensagem.

  3. Exemplo: Seu código de verificação é %otp%.

  4. Dica: Use o Magic Text para extrair automaticamente os números de telefone salvos do banco de dados de usuários.

  5. Personalizar: Ajuste o texto do botão “Get OTP”, a aparência e o fluxo para atender às suas necessidades.


Notificação por SMS

Enviar alertas por SMS para autenticação multifator ou outros acionadores no aplicativo (por exemplo, tentativas de login de usuários).

Configuração

  1. Em Phone Message Factor, adicione uma mensagem estática ou dinâmica no campo Corpo da mensagem.

  2. Opcionalmente, defina uma mensagem de confirmação após o envio do SMS, como “SMS Sent”.

  3. Permitir que os usuários editem a mensagem em tempo real antes de enviar.


Solução de problemas

Se as mensagens falharem ao enviar, tente o seguinte:

  • Verificar credenciais da API:

    • Confirme se você inseriu o nome de usuário e a chave de API corretos do ClickSend (não a sua senha).

  • Garantir crédito suficiente:

    • Verifique se a sua conta ClickSend tem crédito suficiente. Recarregue sua conta aqui.

  • Preencher campos obrigatórios:

    • Certifique-se de que todos os campos obrigatórios (por exemplo, número de telefone de destino, corpo da mensagem) estejam preenchidos corretamente.


Problemas com Alpha Tag:

Se estiver usando um nome de empresa (Alpha Tag) como remetente:

  • Certifique-se de que tenha no máximo 11 caracteres sem espaços.

  • Alguns países não suportam Alpha Tags. Verifique a lista compatível aqui.

  • Certifique-se de que a Alpha Tag esteja registrada e aprovada no painel do ClickSend.


FAQs

Posso usar o nome da minha empresa como remetente?

Sim, mas apenas em países que suportam Alpha Tags. Certifique-se de que a Alpha Tag esteja:

  • 11 caracteres ou menos

  • Sem espaços

  • Registrada e aprovada através da página de IDs de remetente no ClickSend

Como definir uma Alpha Tag?

Vá para Credenciais da API no painel do ClickSend e ative a opção Alterar Alpha Tag/ID de remetente.

Respondeu à sua pergunta?