Отправить Файл
Отправка файла в существующий чат (только с открытым диалоговым окном). Нужен только один параметр адресата - chatId, phone или bsuid. В BSUID-centric режиме chatId может быть [email protected], bsuid@lid, [email protected] или username@username. Поле phone принимает телефон или BSUID; bsuid можно передать отдельным полем.
Два режима:
- URL / base64: передайте
body+filename(как раньше). - По mediaId: передайте числовой WABA
mediaIdиз/uploadMediaвместе сmediaType(image|video|audio|document). Не передавайтеbodyиmediaIdодновременно.
Для голосового сообщения WhatsApp отправьте audio (лучше OGG/OPUS) с voice: true (работает и с URL/base64, и с mediaId + mediaType=audio).
Стикеры: используйте /sendSticker, а не /sendFile.
Кириллические символы в URL файла не поддерживаются — кодируйте URL.
JWT tokentoken<token>- body
body?stringИсточник файла, если не используете mediaId:
- HTTP/HTTPS URL (https://...)
- Base64 data URI, например data:image/jpeg;base64,/9j/...
- Файл в поле формы
Обязателен вместе с filename, если не переданы mediaId + mediaType.
filename?stringИмя файла с расширением, например 1.jpg или hello.xlsx. Обязателен с body; не нужен при отправке по mediaId.
caption?stringТекст под файлом. При отправке изображения может использоваться с "mentionedPhones", Пример: "Изображение для @78005553535"
mediaId?stringЧисловой WABA media id из /uploadMedia. Альтернатива body/filename. Требует mediaType. Не комбинируйте с body.
mediaType?stringОбязателен при mediaId. Для стикеров используйте /sendSticker.
"image""video""audio""document"voice?booleanЕсли true и медиа — audio, отправить как голосовое сообщение WhatsApp. Предпочтительно OGG/OPUS. Работает с URL/base64 или mediaId + mediaType=audio.
falsequotedMsgId?stringИдентификатор цитируемого сообщения (Cloud API)
chatId?stringОбязателен, если не указаны phone и bsuid
ID чата из списка сообщений. Примеры: [email protected], RU.1504711984690866@lid, username@username или [email protected] (группа). Используется вместо параметра phone.
phone?stringОбязателен, если не указаны chatId и bsuid
Идентификатор получателя. Принимает номер телефона с кодом страны или BSUID, например RU.1504711984690866.
Для chatId используйте полные ID чатов: [email protected], bsuid@lid, username@username или [email protected].
bsuid?stringНеобязательная альтернатива phone/chatId
BSUID получателя без суффикса @lid. Пример: RU.1504711984690866.
Server response example
application/json- response
sent?booleanid?stringУникальный идентификатор сообщения
message?stringУведомление о статусе отправки сообщения
description?stringКомментарий к результату отправки
curl -X POST 'https://api.1msg.io/123/sendFile' \ -H 'Content-Type: application/json' \ -d '{ "body": "https://example.com/file.pdf", "filename": "invoice.pdf", "caption": "Your invoice", "phone": "12020721369"}'{ "sent": true, "id": "gBGGeRhGZTEfAgkJCh2wAz4ZH-8", "message": "Sent to [email protected]", "description": "Message has been sent to the provider"}