Webhook SMS
NOÉ permet d'utiliser un webhook pour envoyer des SMS groupés via votre propre service d'envoi de SMS. Cela vous permet de garder le contrôle sur l'opérateur d'envoi et sur les coûts associés.
Comment ça marche
Lorsqu'un·e organisateur·rice clique sur le bouton d'envoi de SMS groupé, NOÉ envoie une requête POST à l'URL que vous avez configurée dans les paramètres avancés de votre événement.
Méthode
POST
Corps de la requête
{
"phoneNumbers": ["+33612345678", "+33698765432"],
"textMessage": "Bonjour ! Rappel pour la session...",
"senderRegistration": {"...": "inscription de l'envoyeur"},
"session": {"...": "informations de la session"},
"registrations": [{"...": "liste des inscriptions"}]
}
Détail des champs
| Champ | Description |
|---|---|
phoneNumbers | Liste des numéros de téléphone des destinataires. |
textMessage | Le message texte à envoyer. L'envoyeur peut le modifier avant l'envoi. |
senderRegistration | Les informations de l'inscription de la personne qui envoie le SMS (nom, email, etc.). |
session | Les informations de la session concernée (nom, dates, horaires, lieu, etc.), sans la liste des participant·es. |
registrations | La liste complète des inscriptions à cette session, avec leurs réponses au formulaire. |
Le message par défaut est basé sur le modèle de message SMS configurable dans les paramètres de l'événement. L'envoyeur peut modifier le texte librement avant de l'envoyer.
Mode de requête
La requête est envoyée en mode: "no-cors". Cela signifie que :
- NOÉ ne peut pas lire la réponse de votre serveur.
- L'envoi est considéré comme réussi dès que la requête a été envoyée.
- Votre service doit accepter les requêtes CORS depuis l'origine de votre instance NOÉ.
Sécurité
Comme pour les webhooks classiques de NOÉ, les webhooks SMS ne sont pas sécurisés par défaut. Nous vous recommandons d'utiliser un filtrage par adresse IP pour vérifier que les requêtes proviennent bien du serveur NOÉ.