SMS avec Twilio

Le canal SMS utilise Twilio Messaging : les messages entrants et les rappels de livraison arrivent par webhook, tandis que les messages sortants utilisent l’API REST de Twilio.

Prérequis

• Twilio Account SID (AC suivi de 32 caractères hexadécimaux) ;
• un from_number compatible SMS au format E.164 ;
• API Key SID (SK suivi de 32 caractères hexadécimaux) ;
• API Key Secret pour les appels REST sortants ;
• Auth Token pour vérifier les signatures des webhooks Twilio ;
• une URL de rappel HTTPS publique.

Consultez la documentation Twilio Messaging pour la configuration actuelle des numéros et webhooks.

Connexion dans Dashboard

1. Ouvrez Dashboard → Channel → Add.
2. Choisissez SMS (Twilio).
3. Saisissez Account SID, From number, API Key SID et Status callback URL.
4. Ajoutez API Key Secret et Auth Token.
5. Enregistrez les identifiants, vérifiez la règle dans l’assistant CLI et configurez le webhook entrant du numéro Twilio.

Activez l’écoute webhook partagée d’Anyy et le proxy HTTPS décrits dans Plateformes de messagerie. L’URL de rappel doit utiliser HTTPS et se terminer par la route du compte :

https://YOUR_HOST/channels/sms/ACCOUNT_ID/webhook

L’identifiant de compte par défaut est twilio. Utilisez la même route pour les messages entrants et le rappel de statut configuré.

Règle d’accès

SMS utilise open par défaut et accepte open, allowlist ou disabled. Choisissez SMS dans l’assistant interactif anyy setup channel pour changer la règle. Le formulaire Dashboard ne l’expose pas, et les actions actuelles ne modifient pas les entrées des listes SMS. L’association est indisponible ; choisir uniquement allowlist n’ajoute pas de numéro autorisé.

Normalisez les numéros au format E.164, par exemple +14155550123.

Quand HTTPS se termine sur un proxy du même hôte, transmettez depuis la boucle locale avec les valeurs exactes X-Forwarded-Proto: https et X-Forwarded-Host. Cet adaptateur ne fait pas confiance aux en-têtes d’URL transmis depuis une connexion hors boucle locale. Conservez l’URL publique et le corps de formulaire d’origine pour vérifier la signature.

Accusés de livraison

Twilio peut signaler l’avancement de la livraison à l’URL de rappel. Un envoi Anyy réussi prouve d’abord la transmission au fournisseur ; consultez l’accusé/le statut ultérieur avant de réessayer un message incertain.

Les SMS peuvent entraîner des frais directs

Les frais entrants, sortants, opérateur et internationaux dépendent du compte Twilio et de la destination. Limitez l’accès et testez avec un numéro connu avant d’activer l’automatisation.

Vérifier la connexion

anyy channel doctor sms
anyy channel reload

Envoyez un SMS entrant, confirmez la règle de l’expéditeur, puis testez une réponse et son statut de livraison.

Dépannage

Problème	Points à vérifier
Twilio rejette l’URL de rappel	Chemin HTTPS exact /channels/sms/ACCOUNT_ID/webhook
Échec de signature du webhook	Auth Token et préservation de l’URL/du corps d’origine par le proxy
Échec de l’API sortante	Account SID, API Key SID/Secret et capacité du numéro From
Expéditeur ignoré	Règle des messages privés et valeur E.164 de la liste d’autorisation
Le statut n’avance jamais	URL et configuration du rappel de livraison Twilio