Development

Разъяснения по прозрачной схеме доставки PIN

Хотели бы Вы мгновенно узнавать, что случилось с сообщением, содержащим PIN Вашего пользователя. Отлично, это как раз то, о чём мы хотели Вам рассказать.

December 28 2015

Отправка секретных кодов PIN помогает пользователям подтвердить подлинность своих учётных записей, и это не новость, в отличие от прозрачной схемы отслеживания доставки PIN и возможности проконтролировать доставку Клиенту – это совершенно новая и захватывающая возможность.

Двухфакторная аутентификация на основе SMS-сообщений крайне проста. Как только пользователь пытается войти в свою учётную запись, он получает SMS-сообщение с его персональным идентификационным номером (PIN), что делает вход в систему более безопасным. Что позволяет избежать следующего

Кажется, это действительно просто: вы пишете пару строчек кода, внедряете их в своё приложение, и вот вы создали систему двухфакторной аутентификации. Таким образом, вы повысили безопасность учётной записи конечного пользователя.

Обычно сообщения доставляются пользователям в течение пары секунд, но что делать, если этого не происходит? Иногда сообщения приходят с задержкой. Вы когда-нибудь задумывались почему? Хотели бы Вы мгновенно узнавать, что случилось с сообщением, содержащим PIN Вашего пользователя. Отлично, это как раз то, о чём мы хотели Вам рассказать.

Данная пошаговая инструкция по интеграции полной версии нашей программы Messaging Suite в ваши процессы, используя Infobip HTTP API*, даст вам экспертное мнение по следующим вопросам:

* Для того чтобы узнать больше о Infobip SMS HTTP API, Вы можете ознакомиться с Руководством по началу работы.

Отправка SMS-сообщения

Для того чтобы начать отправлять SMS- сообщения, Вам необходимо создать в HTTP POST запрос в https://api.infobip.com/sms/1/text/advanced

Ваш Заголовок должен содержать следующие значения для авторизации и типа контента.

  • Авторизация: Базовая QWxhZGRpbjpvcGVuIHNlc2FtZQ==
  • Тип контента: application/json

Мы покажем вам на примерах, как Отправить SMS-сообщение, становить настройки для получения Промежуточного и Итогового отчётов о доставке и как наладить SMS-слежение за конверсией.

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":"41793026731"
            }
         ],
         "text":"Your PIN code is 1a2B3c. Enjoy our app!",
         "intermediateReport":true,
         "notifyUrl":"http://www.example.com/sms/advanced"
      }
    ],
   "tracking":{
         "track":"SMS",
         "type":"One_Time_Pin"
   }
}

В ответ на это вы должны получить статус 200 OK cо свойствами сообщения в теле ответа:

JSON


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

{
  "bulkId": "1446634544520356423",
  "messages": [
    {
      "to": "41793026731",
      "status": {
        "groupId": 1,
        "groupName": "PENDING",
        "id": 7,
        "name": "PENDING_ENROUTE",
        "description": "Message sent to next instance"
      },
      "smsCount": 1,
      "messageId": "8ef699bc-d4c6-4cf6-8d6e-9a9aa62ad93a"
    }
  ]
}

Одним из параметров, полученных в ответе, является ID сообщения, который используется для Предоставления информации о конверсии на платформу Infobip.

Для получения дополнительных разъяснений и примеров отправки сообщений посетите Страницу документации.

Промежуточные Отчёты о доставке

Промежуточные отчёты о доставке используются для получения информации о доставке ваших сообщений в режиме реального времени.

Как только система Infobip получает сообщение о любой несистематичной ошибке GSM (например, EC_ABSENT_SUBSCRIBER), она передаёт информацию об ошибке на указанный URL-адрес* для уведомлений* на вашем сервере. Кроме уведомлений об ошибках GSM мы также будем информировать вас об актуальной стоимости, статусе сообщений, кодах сетей и стран.

* URL-адрес для уведомлений устанавливается как один из параметров в Процедурах API для полнофункциональных сообщений.

Дополнительную информацию о кодах ошибок GSM и статусах сообщений, вы можете найти на Странице кодов ответов.

Ниже приведён пример Промежуточного отчёта о доставке который будет передан на ваш сервер:

JSON


{
  "results": [
    {
      "bulkId": "BULK-ID-123-xyz",
      "messageId": "c9823180-94d4-4ea0-9bf3-ec907e7534a6",
      "to": "41793026731",
      "sentAt": "2015-10-04T13:01:52.933+0000",
      "doneAt": "2015-10-04T13:02:00.134+0000",
      "smsCount": 1,
      "price": {
        "pricePerMessage": 0.0001000000,
        "currency": "EUR"
      },
      "status": {
        "groupId": 3,
        "groupName": "PENDING",
        "id": 1,
        "name": "PENDING_WAITING_DELIVERY",
        "description": "Message sent, waiting for delivery report"
      },
      "error": {
        "groupId": 1,
        "groupName": "HANDSET_ERRORS",
        "id": 27,
        "name": "EC_ABSENT_SUBSCRIBER",
        "description": "Absent Subscriber",
        "permanent": false
      }
    }
  ]
}

Итоговые отчёты о доставке

Как только система Infobip получает итоговые отчёты о доставке, они передаются на указанный URL-адрес для уведомлений на вашем сервере.

В результате на ваш URL-адрес для уведомлений вы получите сообщение, имеющее такую же структуру, как и Промежуточный отчёт о доставке:

JSON


{
  "results": [
    {
      "bulkId": "BULK-ID-123-xyz",
      "messageId": "MESSAGE-ID-123-xyz",
      "to": "41793026727",
      "sentAt": "2015-06-04T13:01:52.937+0000",
      "doneAt": "2015-06-04T13:02:01.204+0000",
      "smsCount": 1,
      "price": {
        "pricePerMessage": 0.0001000000,
        "currency": "EUR"
      },
      "status": {
        "groupId": 3,
        "groupName": "DELIVERED",
        "id": 5,
        "name": "DELIVERED_TO_HANDSET",
        "description": "Message delivered to handset"
      },
      "error": {
        "groupId": 0,
        "groupName": "OK",
        "id": 0,
        "name": "NO_ERROR",
        "description": "No Error",
        "permanent": false
      }
    }
  ]
}

Решение для слежения за конверсией

Когда вы проводите SMS-кампанию, крайне важно отслеживать её результативность, а также возможность оценить эффективность среди пользователей. Например, если вы отправляете одноразовые коды PIN по SMS, важно отследить показатель конверсии, чтобы иметь возможность оптимизировать поток и процессы.

Слежение за конверсией должно запускаться в начале процесса и останавливаться по завершению. Только когда мы можем отследить весь процесс от начала до конца, мы можем говорить, что конверсия была успешна.

ЗАПУСК ОТСЛЕЖИВАНИЯ ПОКАЗАТЕЛЯ КОНВЕРСИИ

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

Эти свойства устанавливаются в объектах слежения в Отправке SMS-сообщения.

ПРЕДОСТАВЛЕНИЕ ДАННЫХ О ПОКАЗАТЕЛЕ КОНВЕРСИИ

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

Для получения информации о конверсии вам необходимо предоставить ID сообщения полученного после Отправки SMS-сообщения. ID сообщения должен быть предоставлен на наш конечный терминал, как только переход завершен. Терминал предоставит данные по скорости преобразования: https://api.infobip.com/ct/1/log/end/{messageId}.

Пример: Предоставление ID сообщения messageId для сообщений, по которым осуществлено ожидаемое действие.

Этот пример показывает вам, как предоставлять ID сообщения, когда ожидаемое действие было произведено.

JSON


POST /ct/1/log/end/9304a5a3ab19-1ca1-be74-76ad87651ed25f35 HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
As a response, you will receive a processKey that is used for getting conversion rates and statistics:
JSON
{
    "processKey": "A37D448C1ACCA02FABA745522558326C" 
} 

В ответе вы получите processKey, который используется для получения статистики о показателе конверсии:

JSON

{
    "processKey": "A37D448C1ACCA02FABA745522558326C" 
} 

Если Вам необходима дополнительная консультация, чтобы сделать двухфакторную аутентификацию более прозрачной, пишите нам support@infobip.com!