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
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.
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.
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.
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:
Nas configurações de componente do Auth0, vá para Credenciais da API.
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
Vá para o Menu de verificação > Corpo da mensagem.
Inclua %otp% onde você deseja que o OTP apareça na sua mensagem.
Exemplo: Seu código de verificação é %otp%.
Dica: Use o Magic Text para extrair automaticamente os números de telefone salvos do banco de dados de usuários.
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
Em Phone Message Factor, adicione uma mensagem estática ou dinâmica no campo Corpo da mensagem.
Opcionalmente, defina uma mensagem de confirmação após o envio do SMS, como “SMS Sent”.
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.
