Отправление HSM

Метод позволяет отправить Клиенту сообщение в соответствии с тем или иным уже созданным HSM-шаблоном (HSM-сообщение).

HTTP-запрос:

POST /cc/md/hsm/send_message

Параметры запроса:

№ Параметр Тип Обязательный Описание
1 id Строка Да Уникальный идентификатор вызова, например UUID, используется для логирования и отладки
2 social_user_id Строка Да Номер телефона в WhatsApp
3 channel_id Целое Да Идентификатор канала
4 template_id Целое Да Идентификатор шаблона, используемого при формировании HSM
5 creator_abonent_id Целое Да Идентификатор сотрудника MANGO OFFICE, отправитель сообщения
6 parameters Объект Да Динамические данные HSM
6.1 parameters.bindings Массив строк Да Переменные основного текста шаблона
6.2 parameters.header Объект Нет Данные заголовка
6.2.1 parameters.header.content Строка Нет Ссылка на файл для заголовка
6.2.2 parameters.header.bindings Массив строк Нет Переменные текста заголовка шаблона

Примечание. Согласно модели взаимодействия, в POST-запросах отправляются обязательные поля vpbx_api_key и sign. Подробнее об этих обязательных полях…

Пример запроса:

POST https://app.mango-office.ru/cc/send_hsm

{
    "vpbx_api_key": "qwerty123",
    "sign": "qwerty123",
    "json": {
        "id": "qwerty123",
        "social_user_id": "74955404444",
        "channel_id": 11111,
        "template_id": 22222,
        "creator_abonent_id": 33333,
        "parameters": {
            "bindings": [
                "Иванов Иван"
            ],
            "header": {
                "content": "https://image.png",
                "bindings": [
                    "Иванов Иван"
                ]
            }
        }
    }
}

Параметры ответа:

№ Параметр Тип Обязательный Описание
1 name Строка Да Наименование статуса HTTP
2 status Целое Да Статус HTTP
3 code Целое Да Код результата
4 error Строка Нет Текст ошибки, если она произошла
5 message Объект Да Некоторые данные о сообщении на сервере
5.1 message.local_message_id Строка Да Локальный идентификатор отправляемого сообщения
5.2 message.message_id Строка Да Идентификатор сообщения на сервере
5.3 message.time Целое Да Время отправки сообщения в Unix Time в миллисекундах
5.4 message.session_id Строка Не указано Идентификатор сессии

Пример успешного ответа:

{
    "name": "OK",
    "status": 200,
    "code": 1000,
    "message": {
        "local_message_id": "92f7cc123000ecadfe6f0f680972098e",
        "message_id": "449026466343509280",
        "time": 1738009633316,
        "session_id": "mFv5u7SUXl6N+FE/pOsAIMd+"
    }
}

Пример неуспешного ответа:

{
    "result": 3000,
    "error": "error-address-format"
}