Development

Contrôlez et mesurez la durée de vos campagnes SMS avec une API flexible

Avoir des options multiples lors de la programmation de vos messages est un facteur important en matière d’engagement des pratiques de communication.

May 29 2017

Optimisez vos processus marketing et informez vos clients des dernières promotions au moment opportun grâce à la planification et la période de validité, puis allez un peu plus loin. Utilisez la reprogrammation et mettez à jour le statut du message pour rendre votre entreprise encore plus réactive aux exigences de vos clients. La planification ainsi que d’autres mesures peuvent être programmées à travers l’interface Internet du portail Infobip ou bien à travers notre API SMS.

Tenir les clients bien informés et satisfaits peut être accompli à travers plusieurs canaux, mais si votre canal préféré est le SMS, vous connaissez déjà l’importance du développement d’une bonne campagne marketing et de la programmation de messages à livrer aux moments les plus opportuns pour les clients.

REPROGRAMMATION DES MESSAGES EN MASSE AVEC L’API SMS

Si vous utilisez déjà l’API SMS d’Infobip pour envoyer des campagnes à vos clients, ces méthodes vous donneront davantage de contrôle sur les messages que vous envoyez. Vous pourrez modifier leur calendrier de livraison et le statut du message ainsi que définir la période de validité.

Afin de modifier l’heure d’envoi du message, vous pouvez facilement utiliser la reprogrammation. La reprogrammation (et l’annulation) des messages en masse est supportée lorsqu’une requête SMS avancée contient un seul message par lot, et que le « bulkId » du message est unique. Si vous ne fournissez pas un « bulkId » à travers la requête d’envoi initiale du SMS, le système créera une ID unique pour vous et l’inclura en tant que « bulkId » dans la réponse. L’ID pourra être utilisé ultérieurement pour obtenir les données de livraison, le statut de changement, et la date ou l’heure de la livraison du message. Il est également important de remarquer que les messages multiples dans une requête d’envoi en masse ne peuvent pas être mis à jour, car chaque message peut contenir une date et une heure de livraison différentes, et avoir un statut différent..

Afin de commencer à reprogrammer un message, vous devrez émettre une requête JSON avec un « bulkId » :

PUT /sms/1/bulks?bulkId=a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
{
    "sendAt": "2021-08-25T16:00:00.000+0000"
}

La réponse à cette requête serait :

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "sendAt": "2021-08-26T16:00:00.000+0000"
}

2015-07-07T17:00:00.000+01:00 est le format de la date et de l’heure pour la programmation et la reprogrammation des SMS.

Mettre à jour le statut du message

Mettre à jour le statut du message peut parfois être utile : on peut ainsi mettre sur pause, reprendre et/ou annuler les messages programmés.

Le statut « EN ATTENTE » peut être modifié pour « MIS EN PAUSE » et « ANNULÉ » tandis que « MIS EN PAUSE » peut être modifié pour « EN ATTENTE » ou « ANNULÉ».

Les statuts « EN ATTENTE» ou « MIS EN PAUSE » peuvent être modifiés autant de fois que souhaité avant que le message ne soit traité, ou plus précisément, avant que l’heure programmée ne soit arrivée et que le message ait été envoyé. Mais si vous souhaitez modifier le statut du message pour « ANNULÉ », le message ne pourra pas être reprogrammé ou mis à jour pour un nouveau statut, et celui-ci ne serait pas livré.

Il est facile de mettre le statut à jour. Il suffit d’émettre une simple requête JSON pour modifier le statut du message à « MIS EN PAUSE ».

PUT /sms/1/bulks/status?bulkId=a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc HTTP/1.1
Host: api.infobip.com
Authorization: Basic b25lYXBpOnRoZUJveA==
Content-Type: application/json

{
    "statut": "MIS EN PAUSE"
}

Avec une réponse JSON:

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "statut": "MIS EN PAUSE"
}

Définir la période de validité

En plus la reprogrammation et la mise à jour du statut du message, la période de validité peut être très utile. Celle-ci peut être définie lors de l’envoi d’un message texte toutes caractéristiques incluses. Celui-ci peut être programmé pour une période maximale de 48 heures, et si une période plus longue est définie, nous la programmerons automatiquement pour 48 heures.

Il suffit d’effectuer une requête JSON pour définir une période de validité :

POST /sms/1/text/advanced HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

{
   "messages":[
      {
         "from":"InfoSMS",
         "destinations":[
            {
               "to":"41793026727",
            },
            {
               "to":"41793026731"
            }
         ],
         "text":":"Le voyage dans le temps est tout simplement trop dangereux. Mieux vaudrait que je dédie mes recherches à l’autre grand mystère de l’univers : les femmes !": 1440
      }
   ]
}

Avec la réponse

HTTP/1.1 200 OK
Content-Type: application/json

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "messages": [
    {
      "to": "41793026727",
      "status": {
        "groupId": 1,
        "groupName": "PENDING",
        "id": 7,
        "name": "PENDING_ENROUTE",
        "description": "Message sent to next instance"
      },
      "smsCount": 1,
      "messageId": "239a1bed-91d0-4454-a437-6663938465aa"
    },
    {
      "to": "41793026731",
      "status": {
        "groupId": 1,
        "groupName": "PENDING",
        "id": 7,
        "name": "PENDING_ENROUTE",
        "description": "Message sent to next instance"
      },
      "smsCount": 1,
      "messageId": "77a6e601-c12d-4a66-8e16-d8ec8c5fbc03"
    }
  ]
}

Veuillez garder à l’esprit que la période de validité est indiquée en minutes. Après avoir défini cette période, l’envoi du message ne sera pas permis si celle-ci a expiré.

Nous ne vous présentons ici que quelques conseils pour démarrer votre commerce et assurer la satisfaction de votre clientèle. Afin d’en savoir plus sur les intégrations et les différents canaux d’engagement, veuillez visiter notre centre de développement..

COMMENCEZ À CONTRÔLER VOS MESSAGES

Apprenez-en plus