Отправка сообщения в открытую сессию бота

Метод: POST

Authorization: Bearer Token

URL: https://twin24.ai/bot/api/v1/dialogs/DIALOG_ID

Вместо DIALOG_ID нужно указать идентификатор открытого диалога/сессии

cURL

curl --location 'https://twin24.ai/bot/api/v1/dialogs/DIALOG_ID' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TOKEN' \
--data-raw '{
    "returnAnswerAsync": false, 
    "callbackUrl": "https://webhook.site/bce7d22e-dde6-4427-b391-ebbdfda44de6", 
    "callbackData": "Some data", 
    "message": "Привет, Мир!"
}'

Тело запроса

{
    "returnAnswerAsync": false,
    "callbackUrl": "https://webhook.site/bce7d22e-dde6-4427-b391-ebbdfda44de6",
    "callbackData": "Some data",
    "message": "Привет, Мир!"
}

Описание полей метода:

Поле	Тип	Обязательно	Описание
returnAnswerAsync	boolean	нет	Возвращать ли ответа ассинхронно true — вернет результат на callbackUrl false — вернет результат сразу в ответе на запрос
callbackUrl	string	нет	URL для отправки результата работы бота в асснихронном режиме
callbackData	string	нет	Дополнительные данные при отправке результата работы бота в асснихронном режиме
message	string	нет	Сообщение клиента боту

Ответ в формате JSON

{
    "dialogId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", 
    "botId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", 
    "status": "OK", 
    "language": "RU", 
    "result": { 
        "initialVariables": { 
            "var": "Просто переменная" 
        },
        "date": "04.03.2024", 
        "evaluation": "5", 
        "confirmation": "Подтверждение", 
        "nps": "NPS", 
        "status": "01", 
        "Результат": "Значение произвольного результата" 
    },
    "messages": [ 
        {
            "body": "Просто переменная\nПеременная из метадаты\nIvanIvanov1998", 
            "actions": [], 
            "substitutions": { 
                "{var}": { 
                    "value": "Просто переменная", 
                    "type": "NAME", 
                    "name": "var", 
                    "formatted": "Просто переменная" 
                },
                "{clientMetadata.var}": { 
                    "value": "Переменная из метадаты", 
                    "type": "NAME", 
                    "name": "clientMetadata.var", 
                    "formatted": "Переменная из метадаты" 
                },
                "{clientNickname}": { 
                    "value": "IvanIvanov1998", 
                    "type": "NAME", 
                    "name": "clientNickname", 
                    "formatted": "IvanIvanov1998" 
                },
                "nodeId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", 
                "botId": "bce7d22e-dde6-4427-b391-ebbdfda44de6" 
            },
            "answers": [], 
            "keyboard": [], 
            "meta": [], 
            "attachments": [ 
                "bce7d22e-dde6-4427-b391-ebbdfda44de6" 
            ]
        },
        {
            "body": "Как дела?", 
            "actions": [], 
            "substitutions": { 
                "nodeId": "bce7d22e-dde6-4427-b391-ebbdfda44de6", 
                "botId": "bce7d22e-dde6-4427-b391-ebbdfda44de6" 
            },
            "answers": [ 
                "1", 
                "2" 
            ],
            "keyboard": { 
                "buttonsInRow": 1, 
                "buttons": [ 
                    {
                        "type": "text", 
                        "text": "1" 
                    },
                    {
                        "type": "text", 
                        "text": "2" 
                    }
                ]
            },
            "meta": [], 
            "attachments": [] 
        }
    ]
}

Описание полей ответа:

Поле	Тип	Описание
dialogId	string	Идентификатор диалога
botId	string	Идентификатор бота/сценария
status	string	Статус сообщения. Возможные значения: OK, STOP, HELP
language	string	Язык бота/сценария
result	object	Объект с результатами диалога
\| initialVariables	object	Объект со стартовыми переменными диалога
\| \| var	string	Произвольная стартовая переменная диалога
\| date	string	Значение поля "дата" Устанавливается в сценарии в блоке "Результат"
\| evaluation	string	Значение поля "оценка" Устанавливается в сценарии в блоке "Результат"
\| confirmation	string	Значение поля "Подтверждение" Устанавливается в сценарии в блоке "Результат"
\| nps	string	Значение поля "NPS" Устанавливается в сценарии в блоке "Результат"
\| status	string	Значение поля "статус" Устанавливается в сценарии в блоке "Результат"
\| Результат	string	Значение произвольного результата заданого пользователем в сценарии Устанавливается в сценарии в блоке "Результат"
messages	List[object]	Массив сообщений от бота
\| body	string	Текст сообщения
\| actions	List	Дополнительные действия в блоке
\| substitutions	object	Развернутая информация об использованный в сообщении переменных и блоке в сценарии
\| \| {var}	object	Вызов переменной в блоке
\| \| \| value	string	Значение переменной
\| \| \| type	string	Тип переменной
\| \| \| name	string	Имя переменной
\| \| \| formatted	string	Форматированное значение переменной
\| \| nodeId	string	Идентификатор блока с сообщением
\| \| botId	string	Идентификатор бота/сценария, в котором находится блок
\| answers	List[string]	Массив вариантов ответов для пользователя
\| keyboard	object	Объект клавиатуры для сообщения
\| \| buttonsInRow	int	Количество кнопок в одном ряду
\| \| buttons	List[object]	Массив кнопок
\| \| \| type	string	Тип кнопки
\| \| \| text	string	Текст на кнопке
\| meta	List	Дополнительная мета информация
\| attachments	List[string]	Массив идентификаторов вложений в блоке

Быстрые ссылки

Дерево страниц