Получение данных по HTTP-запросу Отправка SMS через Infobip

Интеграция

Получение данных по HTTP-запросу → Отправка SMS через Infobip

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

  1. Настройка приёма HTTP-запросов (вебхука): метод, ответ отправителю, URL приёма, параметры из запроса и разбор JSON из тела.
  2. Отправка SMS через Infobip: укажите API-ключ и Base URL в кабинете Infobip, затем номер получателя и текст. Сохраните действие и отправьте тестовое сообщение.

Отдельные инструкции: источник «Получение данных по HTTP-запросу» · действие «Отправка SMS через Infobip»

Не хотите настраивать сами? Сделаем бесплатно

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

Получить бесплатную настройку Или следуйте инструкции ниже

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

Источник «HTTP (Webhook)»

Приём входящих HTTP-запросов (вебхуков) на уникальный URL. В источнике выберите метод, настройте ответ и при необходимости укажите параметры и заголовки для разбора входящего запроса.

Выбор типа источника

  1. В списке типов источника выберите «HTTP (Webhook)» и нажмите «Выбрать».
    Получение данных по HTTP-запросу: В списке типов источника выберите «HTTP (Webhook)» и нажмите «Выбрать»

Метод и ответ

  1. В поле «HTTP-метод» выберите метод, который нужно принимать, или оставьте «Любой».
  2. При необходимости задайте ответ отправителю: «Код статуса ответа», «Текст статуса ответа», «Заголовки ответа» и «Тело ответа».
  3. Нажмите «Сохранить».
    Получение данных по HTTP-запросу: Нажмите «Сохранить»

URL приёма

  1. Откройте вкладку «Источник данных».
  2. Скопируйте «URL» - на этот адрес нужно отправлять HTTP-запросы из внешней системы.
    Получение данных по HTTP-запросу: Скопируйте «URL» - на этот адрес нужно отправлять HTTP-запросы из внешней системы

Параметры и заголовки

  1. В блоке «Параметры» нажмите «Добавить параметр», укажите «Название» и «Приоритет» («Строка запроса» или «Тело запроса»).
  2. В блоке «Заголовки» при необходимости нажмите «Добавить заголовок» и укажите «Название».
  3. Нажмите «Сохранить».

Получить из последнего запроса

  1. Отправьте тестовый запрос на скопированный «URL».
  2. Откройте вкладку «Источник данных» и нажмите значок редактирования у «Настройки».
    Получение данных по HTTP-запросу: Откройте вкладку «Источник данных» и нажмите значок редактирования у «Настройки»
  3. Нажмите «Получить параметры из последнего запроса».
    Получение данных по HTTP-запросу: Нажмите «Получить параметры из последнего запроса»
  4. Нажмите «Сохранить».

Поля, которые приходят сами

Эти поля появляются в заявке без настройки в блоках «Параметры» и «Заголовки».

  • «Дата и время создания» - момент, когда запрос попал в обработку.
  • «Версия HTTP»
  • «HTTP-метод»
  • «Строка запроса»
  • «Заголовки» - все заголовки входящего запроса списком.
  • «Тело» - сырое тело запроса.
  • «Тело (строка)» - то же тело текстом. Если тело бинарное и не декодируется, поле будет пустым.

Отдельными полями станут только те параметры и заголовки, которые вы добавили в блоки или получили кнопкой «Получить параметры из последнего запроса».

Парсер JSON

Если внешняя система шлёт тело в JSON, разберите его действием «Парсер JSON».

  1. Добавьте действие «Парсер JSON».
  2. В поле «JSON» укажите «Тело (строка)» из источника.
    Получение данных по HTTP-запросу: В поле «JSON» укажите «Тело (строка)» из источника
  3. Вставьте образец в «Пример», отметьте нужные элементы в дереве и нажмите «Сохранить».
    Получение данных по HTTP-запросу: Вставьте образец в «Пример» и нажмите «Сохранить»
    Получение данных по HTTP-запросу: В дереве JSON отметьте нужные элементы

Полная настройка действия: Парсер JSON.

Если запрос не приходит

  • Проверьте, что в списке выбран «HTTP».
  • Скопированный «URL» вставьте целиком, параметры из него не удаляйте.
  • Если в «HTTP-метод» выбран метод, внешняя система должна слать именно его.
  • Для полей формы нажмите «Получить параметры из последнего запроса» после теста.
  • Для JSON добавьте действие «Парсер JSON» и укажите «Тело (строка)».

Действие «Infobip. Отправка СМС-сообщения»

Infobip отправляет SMS по API. Укажите API-ключ из кабинета, номер получателя и текст. Отдельное подключение не создаётся.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

Выбор действия

  1. Выберите «Infobip. Отправка СМС-сообщения» и нажмите «Выбрать».

Данные кабинета Infobip

  1. Откройте кабинет Infobip: portal.infobip.com.
  2. Перейдите в API-ключ и Base URL аккаунта.
  3. Скопируйте значения для полей авторизации: «API-ключ».

Поля действия

  1. В поле «Название» укажите понятное имя действия в обработке.
  2. В поле «API-ключ» укажите значение из кабинета или подставьте переменную.
  3. В поле «Base URL аккаунта (xxxx.api.infobip.com)» укажите значение из кабинета или подставьте переменную.
  4. В поле «Номер телефона» укажите номер получателя или подставьте переменную.
  5. В поле «Имя отправителя» укажите значение из кабинета или подставьте переменную. Поле необязательное.
  6. В поле «Текст сообщения» введите текст SMS или подставьте переменную из сценария.
  7. Нажмите «Сохранить».

Если сообщение не уходит

  • Проверьте ключи и пароли: лишний пробел или ключ от другого кабинета даёт отказ API.
  • Номер укажите в том формате, который написан в подписи поля.
  • Имя отправителя должно быть согласовано в кабинете, если поле заполнено или обязательно.
  • Проверьте баланс и что выбранный канал, шаблон или каскад активны.

Результат

После отправки в следующих шагах доступны поля: «ID сообщения», «Статус».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»

Застряли на подключении или полях?

Соберём обработку «Получение данных по HTTP-запросу → Отправка SMS через Infobip», проверим тест и запустим.