API
Вы можете отправлять сообщения на ваш виджет чатбот. Для этого необходимо выполнить POST запрос по адресу: https://api.cavuer.com/messages/generateResponse.
В Headers запроса необходимо добавить ключ: x-cavuer-api-key. В качестве значения ключа необходимо использовать API ключ, который можно создать в личном кабинете в разделе Профиль (подробнее в разделе Начало работы).
Параметры запроса
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
chatId | string | Да | Уникальный идентификатор чата. При последующих запросах по данному идентификатору сообщения будут отправляться в ранее созданный чат |
text | string | Да | Текст сообщения |
uniqueIdentifier | string | Да | Уникальный идентификатор чатбота. Идентификатор widget чатбота из личного кабинета |
chatType | string | Нет | Определение чата. Возможные значения: "user", "group". По умолчанию установлено значение “user”, если параметр не указан |
participantId | string | если chatType: group | Идентификатор участника группы |
chatName | string | Нет | Название чата |
Пример тела запроса:
{
"chatId": "1234567890",
"content": {
"text": "Привет. Вы используете Cavuer ИИ-бот"
},
"uniqueIdentifier": "CAV36pzjv4qwwlq",
"chatType": "user",
"chatName": "Widget"
}
При успешно выполненном запросе вы получите ответ сервера 200.
Возможные ошибки:
- 400 - данные запроса не валидны. Исправьте ошибку в параметрах запроса;
- 401 - указан неверный api ключ в хедере, или ключ не указан вовсе.