Кастомный блок может самостоятельно публиковать сообщение в чате. Например, блок Case.one в результате работы может отправить сообщение в чат со ссылкой на созданное дело.
Для отправки ботом текстового сообщения в чат выполните запрос:
POST /api/vertex/v1/dialog/send_message
Описание запроса:
|
Наименование |
Формат |
Примечание |
|
token |
Строка |
Tокен для отправки сообщения в сервис. Обязательный параметр |
|
text |
Строка |
Текст сообщения. Обязательный параметр |
|
typing |
Да/Нет |
После отправки сообщения показывает виджет набора текста. |
Пример запроса:
{
"token": string|required,
"text": string|required,
"typing": boolean|null
}
Описание ответа:
В случае успешного запроса, вернется сообщение с идентификатором сообщения (целое число):
{
'message_id': int,
'created_at': int
}
400 - не прошла валидация данных. Не заполнен параметр «text»:В случае ошибки вернется ответ:
{
'message': string
}
403 - доступ запрещен:
{
'status': string
}
Параметр «status» может иметь значения:
- «token_invalid» - не прошла проверка токена на подлинность. Возможно, токен был поврежден. Полезная нагрузка была заменена;
- «instance_not_exist» - инстанс, заданный в токене, не существует;
- «instance_blocked» - инстанс, заданный в токене, заблокирован;
- «dialog_not_exist» - диалог, заданный в токене, не существует;
- «dialog_completed» - диалог, заданный в токене, имеет статус «завершен»;
- «dialog_pause» - диалог, заданный в токене, имеет статус «на паузе»;
- «dialog_interrupted» -диалог, заданный в токене, имеет статус «прерванный»;
- «vertex_not_work» - данный блок сейчас не находится в работе в диалоге.
Комментарии
0 комментариев
Войдите в службу, чтобы оставить комментарий.