Development

Отложенные SMS-кампании с помощью гибкого API

Умная настройка опций при планировании SMS компаний повышает конверсию.

April 27 2017

Оптимизируйте маркетинговые процессы и информируйте своих клиентов о последних промо-акциях, выбирая верный момент времени через создание отложенных во времени кампаний и задавая сроки действия. Вы можете продвинуться еще дальше. Используйте опции изменения графика и обновления статусов сообщений, и ваш бизнес будет более чутко реагировать на запросы клиентов. Настройка отложенных кампаний, а также другие действия доступны через личный кабинет Infobip и наш SMS API.

Информировать клиентов и поддерживать удовлетворенность сервисом можно обеспечить, используя разные каналы. Но если ваш предпочтительный канал – SMS, вы уже знаете, как важно разработать грамотную маркетинговую кампанию и составить график рассылок таким образом, чтобы сообщения доставлялись клиентам в правильный момент времени.

Изменение графика отложенных массовых рассылок через SMS API

Если вы уже пользуетесь SMS API от Infobip для отправки сообщений клиентам, приведенные ниже методы позволят более эффективно управлять SMS-кампаниями. Вы сможете пересматривать график доставки, статусы сообщений и задавать срок действия.

Чтобы изменить время отправки сообщения, вы с легкостью можете использовать опцию изменения графика. Изменение (и отмена) графика отложенных массовых рассылок поддерживается в тех случаях, когда развернутый SMS-запрос содержит только одно сообщение для рассылки и когда «bulkId» является уникальным. Если вы не указали «bulkId» в начале запроса на отправку SMS, система создаст уникальный ID сама и включит его в ответ как «bulkId». ID может использоваться и позднее, когда вам понадобится извлечь информацию о доставке, изменить статус, дату или время доставки сообщения. Также важно помнить о том, что многочисленные сообщения в едином массовом запросе на отправку нельзя обновить, потому что эти сообщения могут содержать разные дату и время доставки и иметь разные статусы.

Чтобы приступить к изменению графика, вы должны ввести запрос JSON с «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"
}

Ответ на запрос будет следующим:

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

2015-07-07T17:00:00.000+01:00 – это формат времени и даты для задания и изменения графика SMS.

Обновление статуса сообщения

Обновление статуса сообщения порой может оказаться полезной опцией и использоваться для приостановления, возобновления и/или отмены отправки сообщений по расписанию.

Статус «В ОЖИДАНИИ» может быть изменен на «ПРИОСТАНОВЛЕН» и «ОТМЕНЕН», а статус «ПРИОСТАНОВЛЕН» может быть изменен на «В ОЖИДАНИИ» или «ОТМЕНЕН».

Статусы «В ОЖИДАНИИ» и «ПРИОСТАНОВЛЕН» могут быть изменены столько раз, сколько вам понадобится – до момента обработки сообщения или, если точнее, по наступлении заданного момента и после отправки сообщения. Но если статус сообщения был изменен на «ОТМЕНЕН», график сообщения нельзя изменить или присвоить ему новый статус, оно останется недоставленным.

Обновление статусов делается легко. Ели вы хотите изменить статус сообщения на «ПРИОСТАНОВЛЕН», вы можете сделать это посредством простого запроса JSON:

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

{
    "status": "PAUSED"
}

Ответ JSON будет следующим:

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "status": "PAUSED"
}

Настройка срока действия SMS

Как и изменение графика, и обновление статуса сообщения, срок действия также может оказаться весьма полезным. Срок действия SMS – период времени, в течение которого предпринимаются попытки доставки сообщения, если телефон абонента не доступен. Он задается при отправке текстовых сообщений с полным набором опций. Максимальный срок действия SMS составляет 48 часов. Если будет задан более длительный период, он автоматически сократится до 48 часов.

Для задания срока действия вам понадобится отправить запрос JSON:

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":"The time-traveling is just too dangerous. Better that I devote myself to study the other great mystery of the universe: women!",
         "validityPeriod": 1440
      }
   ]
}

Ответ будет следующим:

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"
    }
  ]
}

Помните, что срок действия исчисляется в минутах. После настройки срока действия и по истечении указанного периода отправка сообщения будет невозможна.

Это лишь некоторые из наших рекомендаций, которые помогут эффективнее управлять вашими SMS-кампаниями. Чтобы узнать больше об интеграции и различных каналах коммуникации, посетите наш портал для разработчиков.

Начните управлять кампаниями

Посетите страницу для разработчиков