API SMS à deux voies avec Webhooks: Gestion automatique des réponses

À retenir :

  • Le SMS bidirectionnel transforme une chaîne de radiodiffusion en conversation – les clients répondent et votre système répond intelligemment
  • Le traitement des réponses basé sur le Webhook permet un bruit des réponses en temps réel sans sondage pour de nouveaux messages
  • L'automatisation par mots clés (YES/NO/STOP/INFO) traite la majorité des réponses avec aucune implication humaine

Le SMS à sens unique est un système de notification de piscine. Il fonctionne bien pour les alertes, les rappels et les confirmations où aucune réponse n'est attendue. Mais au moment où vous envoyez un message qui invite une réponse – «texte OUI à confirmer» ou «répondre STOP à refuser» – vous avez besoin d'un système bidirectionnel qui gère ce qui vient.

L'architecture webhook rend cettefiabilité et en temps réel. Au lieu de vérifier de nouvelles réponses toutes les quelques minutes, votre fournisseur de SMS appelle votre terminal deès qu'une réponse arrive. Votre système le traite immédiatement et répond en conséquence.

Commentaire fonctionnel le Webhooks SMS entrant

Le flux est simple une fois que vous comprenez la direction des données:

  1. Le client reçoit votre SMS sortir et répondre avec "YES"
  2. Votre fournisseur de SMS reçoit le message entrant sur votre numéro attribué
  3. Le fournisseur demande immédiatement un POST HTTP à votre URL webhook avec les données du message
  4. Votre application traite la charge utile entrée, exécute votre logique d'entreprise (confirmer le rendez-vous, mettre à jour la base de données, déclencher le message prochain)
  5. Votre application demande en option un SMS de réponse via le même fournisseur API
  6. Le cycle complet se termine en moins de 3 secondes de la réponse à l'action

Structure de la charge utile du Webhook

Une charge utile typique de SMS entrant d'un fournisseur ressemble à:

POST/webhooks/sms-inbound { "de": "+15551234567", "à": "+18005550100", "corps": "OUI", "message id": "msg abc123", "timestamp": "2025-05-24T14:30:00Z", "urles médiatiques": [] }

Votre gestionnaire reçoit ici, normalise le texte du corps (trim whitespace, topcase), et les itinéraires vers votre gestionnaire de mots clés.

Créer une logique de réponse fondue sur des mots clés

Mots clés Utilisation typique Mesures d'intervention automatisées
OUI / CONFIRM / 1 Confirmation de rendez-vous, opt-in Mettre à jour l'état de la réservation, envoyer une confirmation, log activité
NON/ANNULATION / 2 Annulation du rendez-vous, déclin Annoncer la réservation, mise en place de temps libre, informateur le personnel, envoyé des alternatives
STOP / UNSUBSCRIBE / QUIT / FIN Opt-out (TCPA obligatoire) Immédiatement supprimer de tous les futurs envois, envoyer une confirmation de retrait obligatoire
START/UNSTOP Reprise après avoir arrêté avant Restaurer les permissions de messagerie, envoyer le message de bienvenu
AIDE / INFO Demande de soutien, informations Envoyer un message d'information avec les options de contact, en option route vers l'agent humain fichier d'attente
[Non reconnu] Réponse en texte libre Route vers la fiche d'attente de l'agent humain ou le processeur NLP; envoyé "Votre message a été reçu" reconnaissance

Gestion des séances pour les conversations multi-cours

La manipulation simple des mots clés fonctionne pour les interactions à un tour. Pour les conversations en plusieurs enregistrements – comme guide un client à travers un flux de renouvellement – vous avez besoin de gestion de session :

Exemple de flux de réponse basé sur la session

Étape 1:System envoie « Votre rendez-vous est mercredi à 15h. Réponse OUI à confirmer ou NON à réaliser."

Réponses du client:"NO"

Étape 2:Le système lit l'état de session (le client est en « flux de renouvellement », envoie « Nous avons jeudi à 14h00 ou vendredi à 10h00 disponibles. Réponse 1 pour le jeudi ou 2 pour le vendredi."

Réponses du client:"1"

Étape 3:Processus système "1" dans le contexte de l'étape 2, livre jeudi à 14h, demande confirmation, ferme la session.

L'état de session peut être stocké dans Redis, une table de base de données, ou même un cache en mémoire simple pour les applications à volume intérieur. La clé est que chaque webhook entrant inclut le numéro "à partir", qui agit comme la clé de session.

Manipulation des réponses non confirmées

Tous les clients ne répondent pas avec un mot-clé rangé. « Bien sûr ! », « Ça sonne bien », « Encore combien de foie ? », « En fait, pouvons-nous faire 16 heures ? », ce qui exige soit un traitement NLP, soit un bruit vers un agent humain. Concevez votre système avec cette réalité à l'esprit:

  • Pour les réponses libres qui correspondent à l'intention mais pas à des mots-clés exacts (p. ex. « yep », « absolu »), utilisez une correspondance flote ou un NLP simple pour classer l'intention.
  • Pour des messages vénérables non structurés, envoyez un accusé de réception et un itinéraire vers une fiche d'attente humaine: "Merci pour votre message! Un membre de l'équipe suit bienôt."
  • Suivez les modèles de réponse non reconnue — si 30 % des réponses à votre message de confirmation sont « à quelle heure encore? », votre message original ne comprend pas suffisamment d'information

Pour en savoir plus sur la construction de systèmes d'engagement client SMS bidirectionnels, consultez notre guideAPI texte automatisé et solutions personnalisées.

Construire un système de SMS à deux voies qui correspond à

L'API de Robotalker prend en charge les campagnes SMS sorties et la gestion des réponses entrantes avec la livraison webhook.

  • En temps réel entrées SMS webhooks
  • Numéros bidirectionnels
  • Traitement automatique STOP/opt-out
Démarrer l'essai gratuit →

FAQ: Webhooks SMS à deux voies

Les fournisseurs de SMS réputés réessayeront les vies de webhook échouées, généralement avec des retours exposants (réessager après 30 secondes, 5 minutes, 30 minutes, etc.). Implémentez idempotency dans votre gestionnaire webhook en utilisant le champ message id de sorte que les vies dupliquées pendent les réponses ne créditent pas d'actions dupliquées.

Pour les SMS bidirectionnels de style conversation, un code long dédié (10DLC) ou un code court dédié est fort recommandé. Les codes courts partagés rendent impossible l'identification des entreprises auxquelles un consommateur répondu, et ils ont été élargis par les transporteurs américains pour la messagerie A2P. L'enregistrement 10DLC est demandé pour les SMS commerciaux aux États-Unis, peu importe.