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).
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.

Escolher um gateway
- Na Admin Console, abra Branding → Telemóvel.
- 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.
- 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: valuepor linha, útil para um cabeçalhoAuthorization. - 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.