Webhooks

Gérer les statuts et réponses de vos campagnes SMS

Réponse sur un numéro court

Après l’envoi d’une campagne depuis notre numéro court, SMS Partner vous permet de recevoir des réponses. Pour en savoir plus, contactez nous.

À noter

Pour recevoir les réponses, vous devez paramétrer votre URL de réception des réponses

dans votre onglet API SMS

Exemple de réponse JSON envoyé en POST

{
"type":"response",
"phone_number":"+336....",
"text":"test",
"message_id":1111111
}

Pour un STOP SMS la réponse du webhook sera

{
"type":"stop",
"phone_number":"+336...",
"text":"Stop",
"message_id":111111
}

Réponse sur numéro long (numéro virtuel)

SMS Partner vous propose la location d'un numéro long (exemple: 06 XX XX XX XX) Pour en savoir plus sur la création d'un numéro long dédié, contactez nous.

Exemple de réponse simple (160 caractères maximum)

{
  "msisdn": "33xxxxxxxxx",
  "to": "33xxxxxxxxx",
  "messageId": "1235-1234-1233-4665",
  "text": "Test",
  "type": "text",
  "keyword": "Test",
  "message-timestamp": "2016-03-10 09:51:46"
}

Exemple de réponse sur SMS long (+160 caractères)

{
  "msisdn": "33xxxxxxxxx",
  "to": "33xxxxxxxxx",
  "messageId": "a1b2c3d4-e5f6-40a1-80b2-c9d0e1f....", //au format UUID
  "concat": "true",
  "concat-ref": "171",
  "concat-total": "2",
  "concat-part": "1",
  "text": "   Message long....",
  "type": "text",
  "keyword": "MESSAGELONG",
  "message-timestamp": "2016-03-09 16:00:30"
}
 
{
  "msisdn": "33xxxxxxxxx",
  "to": "33xxxxxxxxx",
  "messageId": "a1b2c3d4-e5f6-40a1-80b2-c9d0e1...", //au format UUID
  "concat": "true",
  "concat-ref": "171",
  "concat-total": "2",
  "concat-part": "2",
  "text": "....très long",
  "type": "text",
  "keyword": "TRESLONG",
  "message-timestamp": "2016-03-09 16:00:31"
}

DLR - récupération des statuts des SMS

Le statut de délivrabilité des SMS peut être envoyé via le webhook en POST

{
"status":"delivered",
"msgId":"11111111",
"date":1764768485,
"phone":"+336.......",
"cost":"0.049",
"currency":"EUR",
"tag":"...."
}

Les différents statuts sont

• delivered : Le SMS a été délivré

• not delivered : Le SMS n'a pas été délivré

• waiting: Le SMS est en attente chez l'opérateur