Référence API

API des appareils Sender ID API Notification Telegram Webhooks pour le statut de livraison Webhooks pour SMS entrants

__SDKs & autres libs

PHP SDK Postman NPM SDK Exemple PHP Curl Exemple de gueule PHP

Plugins

Send via Excel file AmoCRM and KommoCRM Github Repositories 👨‍💻 Tutoriels Youtube 📺 Demander un plugin ✉️

Webhooks

Vous trouverez ici des réponses à vos questions sur l'utilisation de nos webhooks

Les Webhooks sont essentiels pour recevoir des informations plus rapidement. Nous avons deux types de webhooks:

1. Webhook pour recevoir le statut de livraison de chaque SMS.

2. Webhook pour recevoir des SMS entrants.

Maintenant, discutons de chacun d'eux:

1. En commençant par le webhook qui peut informer votre serveur de l'état de livraison des SMS. Grâce à cela, vous n'avez pas besoin de faire des demandes API supplémentaires pour suivre les statuts SMS.

   Pour le configurer, allez dans les paramètres de l'appareil, et dans cette section, entrez ce qui suit dans le champ:
   Webhooks pour les statuts d'envoi de SMS

   

   {
     "sms_id": int,
     "status_id": int,
     "status_message": string,
     "sendto": string,
     "senttime": datetime,
     "sim": int (0 or 1),
     "device_id": int
   }
   

   Tout ici est simple et clair. Peut-être que seul status_id a besoin d'être clarifié.

   • 1 - En attente de SMS
   • 2 - SMS pris par téléphone
   • 3 - En attente d'envoi. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2."
   • 5 - SMS entrants
   • 6 - SMS envoyé par téléphone
   • 7 - Le SMS a été envoyé
   • 8 - Le SMS n'a pas été envoyé
   • 9 - SMS n'a pas du tout été envoyé - Échec générique. (Lire ce qu'il faut faire avec cette erreur ici)
   • Autre, erreurs moins courantes:
   • 10 - SMS non envoyé - No Service
   • 11 - SMS non envoyé - Null PDU
   • 12 - SMS non envoyé - Radio Off
   • 100, 101 - SMS non envoyé - NOT ALLOWED. (Les autorisations pour l'envoi de SMS dans l'application n'ont pas été accordées)

Maintenant, nous allons nous plonger dans le webhook pour les SMS entrants. Son but est de vous permettre de transférer immédiatement un SMS entrant vers votre système. Cela se fait très simplement: il suffit de spécifier votre point de terminaison pour ce webhook dans le champ 'Webhooks for incoming SMS'. Dans ce cas, vous serez en mesure de recevoir du JSON via une requête POST dans le format suivant:

{
"address": int,
"date": datetime,
"date_sent": datetime,
"body": string,
"internal_id": int,
"sim": int,
"sms_id": int,  
"device_id": int,
"device_name": devicename
}