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

Requires: customSmsGateway

> **Nota sobre o plano:** Um gateway de SMS personalizado está disponível a partir do plano Essential. Consulte [Plans & add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md). 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](https://dts-identity.com/pt/docs/security/multi-factor-authentication.md) 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.

[Image: 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.
