Перейти к содержанию

SendFileByUpload#

Метод предназначен для отправки файла, загружаемого через форму (form-data). Сообщение будет добавлено в очередь на отправку. Скорость отправки сообщений из очереди регулирует параметр Интервал отправки сообщений.

Файлы видео, аудио и изображений отправляются как и в родном WhatsApp с возможностью просмотра и прослушки. Документы отправляются так же как в родном WhatsApp. Тип отправляемого файла и способ его отправки определяется по расширению файла.

Максимальный размер отправляемых файлов равен 37 Мбайт.

Запрос#

Для отправки файла требуется выполнить запрос по адресу:

POST https://api.green-api.com/waInstance{{idInstance}}/SendFileByUpload/{{apiTokenInstance}}

Для получения параметров запроса idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Параметры запроса#

Параметр Тип Обязательный Описание
chatId string Да Идентификатор чата
file file Да Отправляемый файл
caption string Нет Описание под файлом. Описание добавляется к видео, изображениям и документам

Пример тела запроса#

Пример кода на Python

import requests

url = "https://api.green-api.com/waInstance{{idInstance}}/sendFileByUpload/{{apiTokenInstance}}"

payload = {'chatId': '79001234567@c.us',
'caption': 'Описание'}
files = [
  ('file', open('/C:/window.jpg','rb'))
]
headers= {}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.text.encode('utf8'))

Ответ#

Поля ответа#

Поле Тип Описание
idMessage string Идентификатор отправленного сообщения

Пример тела ответа#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Ошибки SendFileByUpload#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки