метод REST scope: imopenlines, imbot

imopenlines.bot.session.message.send

Отправить автоматическое сообщение в диалог

Кто может выполнять: любой пользователь

Описание

Метод imopenlines.bot.session.message.send отправляет в диалог открытой линии автоматическое сообщение от чат-бота приложения.

Параметры

CHAT_ID integer обязательный

Идентификатор чата, в который метод отправляет сообщение.

Идентификатор чата можно получить с помощью методов imopenlines.dialog.get или imopenlines.crm.chat.get

NAME string необязательный

Код типа автоответа.

Допустимые значения:
- WELCOME — отправляет автоматическое приветствие из настроек Открытой линии, параметр MESSAGE в этом режиме игнорируется
- DEFAULT — отправляет текст из параметра MESSAGE

MESSAGE string необязательный

Текст сообщения для режима NAME=DEFAULT. По умолчанию используется пустая строка.

Если передать NAME=DEFAULT и пустой MESSAGE, новое сообщение в чат не добавится

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"CHAT_ID":112,"NAME":"DEFAULT","MESSAGE":"Здравствуйте! Чем могу помочь?"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imopenlines.bot.session.message.send

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1728626400.456,
        "finish": 1728626400.539,
        "duration": 0.083,
        "processing": 0.031,
        "date_start": "2024-10-11T10:00:00+03:00",
        "date_finish": "2024-10-11T10:00:00+03:00",
        "operating": 0
    }
}

Возвращаемые данные

result boolean

Флаг успешного вызова метода. Метод не возвращает признак фактического создания сообщения в чате

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "CHAT_ID_EMPTY",
    "error_description": "Chat ID can't be empty"
}
Код Описание Значение
400 CHAT_ID_EMPTY Chat ID can't be empty
403 WRONG_AUTH_TYPE Access for this method not allowed by session authorization

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.