¶ Подготовительные шаги
Создайте нового бота через BotFather в Telegram. Подробнее о создании бота читайте в статье.
Интегрировать бота с чатом не нужно, так как бот предназначен только для получения ID видео.
¶ Загрузка файла в систему
Для того чтобы загрузить файл в систему TWIN, необходимо выполнить API-запрос на добавление файла с использованием любого инструмента, предназначенного для отправки API-запросов. Например, с помощью Postman.
- Зарегистрируйтесь в Postman и откройте его.
- Нажмите на кнопку Import в верхнем левом углу.
- Вставьте CURL запроса в открывшемся окне:
curl --location 'https://bot.twin24.ai/api/v1/files'
--form 'private="false"' \
--form 'file[0]=@""'
Запрос будет автоматически импортирован.
- Перейдите на вкладку Authorization в параметрах запроса.
- Выберите тип авторизации Bearer token в поле Type.
- Вставьте токен авторизации TWIN в поле Token. Скопировать токен можно из настроек профиля в личном кабинете – для этого нажмите на название учетной записи, и скопируйте API токен из открывшегося окна.
- Перейдите на вкладку Body параметров запроса.
- Нажмите на поле Select file чтобы загрузить в него файл.
- Нажмите кнопку Send для отправки запроса. В ответе сервера будет получено поле id — это и есть идентификатор загруженного в систему файла.
- Скопируйте данный идентификатор — он требуется для отправки файла из сценария.
¶ Отправка файла в сценарии
-
Перейдите в раздел Сценарии ботов личного кабинета.
-
Откройте нужный сценарий в редакторе. Если у вас нет сценария, создайте новый.
-
Добавьте блок Результат в том месте, где должна происходить отправка видеофайла, и объявите в нем следующие переменные:
chat_id—{messengerUserId}.bot_token— токен бота Telegram, который отображается в BotFather после создания бота.file_id— идентификатор файла в системе TWIN, полученный ранее.
- Установите блок Выражение, и проведите к нему стрелку из блока Результат.
- Нажмите Открыть редактор в параметрах блока.
- Вставьте выражение в появившемся окне:
$response = http.request("https://api.telegram.org/bot" :: $bot_token :: "/sendVideoNote","POST").
header("Content-Type", "multipart/form-data").
body({"chat_id":$chat_id}).
file($file_id, "video_note").
send()
$code = $response.statusCode
$body = $response.body
- Нажмите кнопку Сохранить в редакторе выражения. В данном блоке происходит отправка видео.
¶ Проверка получения видеосообщения
Если пользователь ограничил получение голосовых сообщений, то кружок не будет отправлен, так как он считается голосовым сообщением, в отличие от обычного видео, прикрепленного в качестве файла.
- Добавьте блок Условие после блока Выражение, в котором происходит отправка видео.
- Из блока Условие проведите стрелку, идущую дальше по сценарию.
- Выберите тип выходных данных в параметрах стрелки По умолчанию.
- Проведите еще одну стрелку из блока Условие — она должна идти в часть сценария, в которой будет происходить отправка какой-либо информации вместо отправки видеофайла. Например, это может быть блок Информация, содержащий текст или картинку.
- Выберите тип выходных данных в параметрах стрелки Условие И.
- Добавьте условие
{code} = 400.
При использовании такой структуры, если ограничена передача видео, будет отправлено содержимое дополнительного блока Информация.