# Téléphone (SMS)

Configurez la passerelle qui envoie les codes à usage unique par SMS ou appel vocal (passerelle intégrée, Twilio ou passerelle HTTP personnalisée).

Requires: customSmsGateway

> **Remarque sur le plan :** une passerelle SMS personnalisée est disponible à partir du plan Essential. Voir [Plans et add-ons](https://dts-identity.com/fr/docs/getting-started/plans-and-addons.md). Sur les niveaux inférieurs, la plateforme envoie les codes à usage unique via sa passerelle intégrée.

La plateforme envoie des codes à usage unique par SMS pour l'[authentification multifacteur](https://dts-identity.com/fr/docs/security/multi-factor-authentication.md) par téléphone et la vérification des numéros de téléphone. Une passerelle intégrée fonctionne immédiatement ; à partir du plan Essential, vous pouvez acheminer ces messages via votre propre fournisseur.

[Image: L'onglet Téléphone des paramètres d'image de marque]

## Choisir une passerelle

1. Dans l'Admin Console, ouvrez **Image de marque → Téléphone**.
2. Sélectionnez un fournisseur :
   - **Passerelle intégrée** : le service par défaut. Aucune configuration requise.
   - **Twilio** : envoyez via votre compte Twilio.
   - **Passerelle personnalisée** : envoyez via n'importe quelle API SMS HTTP.
3. Configurez les champs correspondant à votre choix (ci-dessous) et sélectionnez **Enregistrer les modifications**.

## Twilio

Indiquez votre **Account SID** et votre **Jeton d'authentification** Twilio, puis choisissez le mode d'envoi des messages :

- **Expéditeur** : soit un **Numéro d'expéditeur**, soit un **SID du service de messagerie**. Un Messaging Service s'applique aux messages texte ; les appels vocaux utilisent toujours un numéro d'expéditeur.
- **Méthodes de remise** : remettez le code sous forme de **message texte (SMS)**, d'**appel vocal**, ou les deux.

## Passerelle personnalisée

Faites pointer la plateforme vers n'importe quelle API SMS HTTP :

- **URL de la passerelle** et **méthode HTTP** (GET ou POST).
- Pour POST, un **format de corps** (JSON, encodé en formulaire ou brut) et un modèle de **corps de requête**. Pour les corps bruts, vous pouvez définir le **Content-Type**.
- **En-têtes personnalisés** : un `Name: value` par ligne, utile pour un en-tête `Authorization`.
- **Nom d'utilisateur**, **mot de passe** et **jeton d'authentification** pour les passerelles qui les exigent.

L'URL, le corps de requête et les en-têtes prennent en charge des espaces réservés remplacés au moment de l'envoi, notamment le numéro du destinataire et le texte du message, par exemple `https://api.example.com/send?to={{to}}&text={{message}}` ou un en-tête tel que `Authorization: Bearer {{authToken}}`.

## Champs secrets

Les valeurs sensibles, comme le jeton d'authentification Twilio ainsi que le mot de passe et le jeton d'authentification de la passerelle personnalisée, sont stockées de manière sécurisée et ne sont jamais préremplies. **Laissez un champ secret vide pour conserver sa valeur actuelle** ; saisissez une nouvelle valeur uniquement si vous souhaitez la modifier.

## Contenu du message

Le texte du message contenant le code provient de la formulation intégrée et traduite de la plateforme ; il ne se modifie pas sur cette page. Le corps est déterminé par les textes linguistiques localisés de l'instance, de sorte que la langue du message suit les paramètres régionaux de l'utilisateur (ou de l'instance) plutôt qu'un éditeur par modèle.

## Protection contre les abus

Les SMS sortants sont soumis à une limitation de débit par utilisateur, de sorte qu'un seul compte ne peut pas déclencher un nombre illimité de messages. Cela vous protège contre les boucles accidentelles et les abus délibérés qui feraient sinon grimper les coûts d'envoi.

## Dépannage

- **Les codes n'arrivent pas** : vérifiez que les identifiants de la passerelle sont corrects, enregistrez à nouveau, puis testez de nouveau le parcours. N'oubliez pas que les champs secrets sont volontairement vides après l'enregistrement ; cela ne signifie pas que la valeur a été effacée.
- **Appel vocal Twilio, mais aucun numéro** : un SID de service de messagerie ne couvre que les SMS ; ajoutez un numéro d'expéditeur pour activer la remise par appel vocal.
- **La passerelle personnalisée renvoie une erreur** : vérifiez que l'URL, la méthode HTTP, le format de corps et les espaces réservés correspondent à ce qu'attend votre fournisseur.
