API MESSAGES

Envoyez & recevez des SMS avec l’API Messages

Une API de messagerie est une interface de programmation qui permet à votre entreprise d’envoyer, de recevoir et de gérer des messages à l’aide de requêtes HTTP standardisées. Avec l’API Messages de Sinch Engage, vous pouvez envoyer des messages WhatsApp et des SMS, demander des rapports de livraison, vérifier le statut par ID de message et récupérer les réponses.

Image for Envoyez & recevez des SMS avec l'API Messages

FLUX DE TRAVAIL PRINCIPAUX

Ce que vous pouvez faire avec l’API Messages

Utilisez l’API Messages pour envoyer des messages WhatsApp et des SMS, suivre l’état de traitement, récupérer les réponses et confirmer les réponses après les avoir traitées.

Image pour Ce que vous pouvez faire avec l'API Messages

Envoi programmé

Envoyez un SMS avec un paramètre programmé. Utilisez-le pour la messagerie temporelle comme les rappels de rendez-vous.

Rapports de livraison

Demandez des rapports de livraison lorsque vous envoyez un message. Un rapport de livraison est une notification lorsque l’état du message change.

Vérifications d’état par ID de message

Capturez l’ID de message à partir de la réponse d’envoi. Utilisez-le pour vérifier l’état du message plus tard.

Réponses et confirmation

Récupérez les réponses envoyées depuis un téléphone mobile en appelant la fonction de réponse. Confirmez les réponses traitées afin qu’elles ne soient pas retournées à nouveau.

COMMENT ÇA MARCHE

Ce que fait l’API Messages

Envoyez des messages SMS et WhatsApp en passant le contenu, le numéro de destination, les options de programmation, les préférences de rapport de livraison et les métadonnées facultatives. L’API renvoie un ID de message que vous pouvez utiliser pour vérifier l’état et récupérer les réponses du téléphone mobile.

INTÉGRATION

Comment l’API Messages s’intègre à vos systèmes existants

Intégrez l’API Messages avec des requêtes HTTP standard ou un SDK pour l’adapter à vos systèmes existants. Ajoutez une callback_url pour activer les webhooks et incluez des métadonnées pour passer le contexte du message personnalisé.

Image pour Comment l'API Messages s'intègre à vos systèmes existants

CAPACITÉS

Capacités de l’API Messages

L’API Messages prend en charge un flux de travail structuré pour l’envoi de messages et la gestion des réponses afin que vous puissiez intégrer la messagerie dans vos applications.

  • Envoyez des messages avec le contenu et le destination_number

  • Programmez des messages avec scheduled

  • Demandez des rapports de livraison avec delivery_report

  • Vérifiez l’état du message par ID de message

  • Récupérez les réponses depuis les téléphones mobiles

  • Confirmez les réponses et incluez jusqu’à 10 paires de métadonnées

Image pour Capacités de l'API Messages

AMÉLIOREZ VOTRE FLUX DE TRAVAIL

Commencez à utiliser l’API Messages

Pour commencer, vous aurez besoin d’un compte Sinch Engage et de Ruby installé. Ensuite, installez le SDK Ruby pour envoyer des messages, vérifier les mises à jour d’état et récupérer les réponses.

Installez le SDK Ruby pour commencer à développer avec l’API Messages.

Créez un fichier app.rb dans le dossier de votre projet et ouvrez-le dans votre éditeur.

Envoyez un message avec le contenu et le numéro de destination. Vous pouvez également inclure des métadonnées, la programmation et les paramètres de rapport de livraison.

Utilisez l’ID de message dans la réponse pour vérifier l’état du message. Appelez la fonction de réponse pour récupérer les réponses des téléphones mobiles des destinataires.

Confirmez les réponses traitées afin qu’elles n’apparaissent plus lors des vérifications futures. Ajoutez une callback_url dans send_message pour activer les webhooks.

Image pour Commencez à utiliser l'API Messages

POURQUOI SINCH ENGAGE ?

Pourquoi choisir une application dotée de capacités d’API ?

Sinch Engage combine une application facile à utiliser avec des capacités d’API pour que votre équipe puisse lancer et gérer la messagerie sans flux de travail nécessitant beaucoup de développeurs. Vous obtenez la facilité d’utilisation dont les équipes commerciales ont besoin et la flexibilité d’intégration qu’attendent les équipes techniques.

FAQ

Foire aux questions sur l’API Messages

Une API de messagerie est une interface de programmation qui permet aux applications d’envoyer, de recevoir et de gérer des messages à l’aide de requêtes HTTP standardisées. L’API Messages est une façon de mettre en œuvre ce modèle.

Dans le tutoriel de l’API Messages, le corps du message d’envoi inclut des champs tels que content et destination_number. Il peut également inclure metadata, scheduled et delivery_report.

Lorsque vous envoyez un message, l’API Messages renvoie un ID de message dans l’objet de réponse. Utilisez cet ID de message pour vérifier l’état du message.

Les réponses envoyées depuis un téléphone mobile apparaissent lorsque vous appelez la fonction de réponse dans le flux de travail du tutoriel. Après avoir traité les réponses, confirmez-les afin qu’elles ne soient pas retournées à nouveau.

Dans le tutoriel de l’API Messages, vous pouvez activer les webhooks en incluant un paramètre callback_url dans le corps du message de votre fonction send_message. Le matériel source ne spécifie pas d’autre comportement de webhook.

Oui. L’API Messages prend en charge jusqu’à 10 paires clé/valeur de métadonnées dans un message. Utilisez les métadonnées lorsque vous ne souhaitez pas stocker de données persistantes dans l’application.

Vous avez besoin d’un compte développeur MessageMedia et de Ruby installé. Le tutoriel mentionne également l’installation du SDK Ruby avec gem install messagemedia_messages_sdk.

Les rapports de livraison sont une notification concernant un changement dans l’état d’un message pendant son traitement. Dans le flux de travail du tutoriel, vous pouvez demander delivery_report dans le corps du message.

Oui. Le tutoriel montre un champ scheduled dans le corps du message. Il décrit également les rappels de rendez-vous avec une confirmation un jour avant et un rappel une heure avant.

Après le traitement d’un ou plusieurs messages de réponse, confirmez-les avec le point de terminaison de confirmation des réponses. Les réponses confirmées ne sont pas renvoyées dans les requêtes ultérieures de vérification des réponses.