Skip to Content

Telemóvel (SMS)

Configure o gateway que entrega códigos de utilização única por SMS ou chamada de voz (gateway integrado, Twilio ou gateway HTTP personalizado).

RequirescustomSmsGateway

Nota sobre o plano: Um gateway de SMS personalizado está disponível a partir do plano Essential. Consulte Plans & add-ons. Nos níveis inferiores, a plataforma envia os códigos de utilização única através do seu gateway integrado.

A plataforma entrega códigos de utilização única por SMS para a autenticação multifator baseada no telemóvel e para a verificação de números de telemóvel. Um gateway integrado funciona de imediato; a partir do plano Essential, pode encaminhar estas mensagens através do seu próprio fornecedor.

O separador Telemóvel das definições de branding

Escolher um gateway

  1. Na Admin Console, abra Branding → Telemóvel.
  2. Selecione um fornecedor:
    • Gateway integrado: o serviço predefinido. Não é necessária qualquer configuração.
    • Twilio: envie através da sua conta Twilio.
    • Gateway personalizado: envie através de qualquer API HTTP de SMS.
  3. Configure os campos correspondentes à sua escolha (abaixo) e selecione Guardar alterações.

Twilio

Indique o Account SID e o Token de autenticação da sua conta Twilio e, em seguida, escolha como as mensagens são enviadas:

  • Remetente: um Número do remetente ou um Messaging Service SID. Um Messaging Service aplica-se a mensagens de texto; as chamadas de voz utilizam sempre um número do remetente.
  • Métodos de entrega: entregue o código como Mensagem de texto (SMS), como Chamada de voz ou de ambas as formas.

Gateway personalizado

Aponte a plataforma para qualquer API HTTP de SMS:

  • URL do gateway e Método HTTP (GET ou POST).
  • Para POST, um Formato do corpo (JSON, form-encoded ou raw) e um modelo de Request body. Para corpos raw, pode definir o Content-Type.
  • Cabeçalhos personalizados: um Name: value por linha, útil para um cabeçalho Authorization.
  • Nome de utilizador, palavra-passe e um token de autenticação para os gateways que os exijam.

O URL, o request body e os cabeçalhos suportam marcadores de posição que são substituídos no momento do envio, incluindo o número do destinatário e o texto da mensagem, por exemplo https://api.example.com/send?to={{to}}&text={{message}} ou um cabeçalho como Authorization: Bearer {{authToken}}.

Campos secretos

Os valores sensíveis, como o Auth Token da Twilio e a palavra-passe e o token de autenticação do gateway personalizado, são armazenados de forma segura e nunca são pré-preenchidos. Deixe um campo secreto em branco para manter o seu valor atual; introduza um novo valor apenas quando o pretender alterar.

Conteúdo da mensagem

O texto da mensagem com o código provém da redação integrada e traduzida da plataforma; não é editado nesta página. O corpo é determinado pelas cadeias de idioma localizadas da instância, pelo que o idioma da mensagem segue a região do utilizador (ou da instância) e não um editor por modelo.

Proteção contra abusos

O envio de SMS está sujeito a limitação de taxa por utilizador, pelo que uma única conta não pode desencadear um número ilimitado de mensagens. Isto protege-o contra ciclos acidentais e abusos deliberados que, de outro modo, fariam aumentar os custos de entrega.

Resolução de problemas

  • Os códigos não chegam: confirme que as credenciais do gateway estão corretas, guarde novamente e volte a testar o fluxo. Lembre-se de que os campos secretos ficam intencionalmente em branco depois de guardar; isso não significa que o valor tenha sido apagado.
  • Voz da Twilio, mas sem número: um Messaging Service SID abrange apenas SMS; adicione um número do remetente para ativar a entrega por voz.
  • O gateway personalizado devolve um erro: verifique se o URL, o método HTTP, o formato do corpo e os marcadores de posição correspondem ao que o seu fornecedor espera.

Nesta página