Maytapi
Maytapi/Документация//sendMessage
/sendMessageЛюбой тип файла, один эндпоинтAPI медиа-сообщений WhatsApp
Отправляйте фото, видео, GIF, документы PDF, Excel и Word, аудио и стикеры со своего номера WhatsApp или размещайте фото над сообщением с кнопками. Один эндпоинт sendMessage: передайте URL или base64, тип файла определится автоматически.
- фото, видео и GIF
- PDF, Excel и Word
- файлы до 50 МБ
- медиа в кнопках
Любые файлы, которые передаёт WhatsApp
Один и тот же эндпоинт и заголовки для всех типов — меняются только поле type и несколько параметров.
-
type: media
Изображения
Изображения JPG, PNG и WebP с необязательной подписью. Включите isHd, чтобы отправлять более чёткие фото, где это поддерживает WhatsApp.
-
type: media
Видео
Видео MP4 с подписью, которые воспроизводятся прямо в чате. Для круглого видеосообщения используйте type: shortVideo.
-
isGif: true
GIF
Отправьте короткий MP4 с isGif, и WhatsApp будет проигрывать его по кругу, как GIF.
-
type: media + filename
PDF, Excel и Word
Счета, прайс-листы и отчёты в PDF, XLSX или DOCX с именем файла, которое увидит клиент.
-
type: media
Аудио
Отправляйте аудиофайлы OGG (Opus) и MP3 по URL или в base64.
-
type: sticker
Стикеры
Стикер WebP отправляется так же, как изображение.
Отправляйте любой файл по URL или в base64
Укажите публичный URL в поле message или передайте файл в base64. Добавьте подпись через text и включите isHd для более чётких изображений.
- ✓Фото, видео и аудио по URL или в base64
- ✓Подпись к каждому медиа-сообщению
- ✓Файлы до 50 МБ
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "media",
"message": "https://example.com/new-arrival.jpg",
"text": "New arrival: classic sneaker, $59",
"isHd": true
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "media",
"message": "https://example.com/unboxing.mp4",
"text": "How to set up your order"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "media",
"message": "data:image/png;base64,iVBORw0KG...",
"text": "Screenshot"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "media",
"message": "https://example.com/welcome.ogg"
}'Файлы PDF, Excel и Word с вашим именем файла
Отправляйте счета, прайс-листы и отчёты как документы. Укажите filename, и клиент увидит invoice-10482.pdf вместо случайного имени.
- ✓PDF, XLSX, DOCX и другие документы
- ✓Своё имя файла и подпись
- ✓Работает в чатах, группах и каналах
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "media",
"message": "https://example.com/files/inv-10482.pdf",
"filename": "invoice-10482.pdf",
"text": "Your invoice for order #10482"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "media",
"message": "https://example.com/files/prices-oct.xlsx",
"filename": "price-list-october.xlsx",
"text": "This month’s price list"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "media",
"message": "https://example.com/files/contract.docx",
"filename": "service-agreement.docx"
}'GIF, стикеры и видеосообщения
Добавьте isGif к короткому MP4, и WhatsApp проигрывает его по кругу, как GIF. Стикеры отправляются файлами WebP, а shortVideo отправляет круглое видеосообщение.
- ✓isGif: true для зацикленных GIF
- ✓Стикеры WebP и круглые видеосообщения
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "media",
"message": "https://example.com/sale.mp4",
"text": "Weekend sale starts now",
"isGif": true
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "sticker",
"message": "https://example.com/thanks.webp"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "shortVideo",
"message": "https://example.com/hello.mp4"
}'Фото над сообщением с кнопками
Сообщения с кнопками тоже принимают поле media: покажите фото товара, посылки или промо-баннер над кнопками «Отследить заказ» или «Купить».
- ✓Поле media в сообщениях buttons
- ✓Кнопки ответа, ссылки, звонка и копирования кода
- ✓Необязательные заголовок и подвал вокруг медиа
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "buttons",
"message": "Classic sneaker, sizes 38–45",
"media": "https://example.com/sneaker.jpg",
"buttons": [
{
"id": "buy",
"text": "Buy now"
},
{
"id": "sizes",
"text": "See sizes"
}
]
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "buttons",
"message": "10% off your next order",
"title": "Thank you!",
"footer": "Valid until Sunday",
"media": "https://example.com/banner.jpg",
"buttons": [
{
"url": "https://example.com/shop",
"text": "Open the shop"
},
{
"code": "THANKS10",
"text": "Copy code"
}
]
}'Что отправляют команды через медиа-API
-
Счета и чеки
Отправляйте PDF-счёт или чек прямо в WhatsApp клиента после оплаты.
-
Прайс-листы
Отправляйте прайс-лист месяца в Excel или PDF дилерам и оптовым клиентам.
-
Поддержка со скриншотами
Отправляйте инструкции в картинках, короткие видео и голосовые из хелпдеска.
-
Фото товаров с кнопками
Показывайте фото товара с кнопками «Купить» и «Подробнее», когда клиент спрашивает о нём.
-
Промо-видео и GIF
Объявляйте распродажу в сообществе или канале коротким видео или зацикленным GIF.
-
Отчёты для клиентов
Отправляйте ежедневные или еженедельные отчёты документами на номер каждого клиента.
Вопросы о медиа-сообщениях
Задайте любой вопрос поддержке в WhatsApp. Среднее время ответа — меньше 24 часов.
Центр помощи →Какого размера может быть файл?
Через sendMessage можно отправлять файлы до 50 МБ. Очень большие видео могут дольше загружаться в WhatsApp.
Можно отправить файл, не размещая его в интернете?
Да. Передайте файл как data URL в base64 в поле message вместо публичной ссылки.
Нужно ли одобрение шаблонов для медиа?
Нет. Maytapi отправляет с вашего номера через WhatsApp Web, поэтому фото, видео, документы и любые другие медиа уходят без проверки шаблонов Meta.
Можно ли отправлять медиа в группы и каналы?
Да. Укажите id группы или канала в to_number; каналы тоже принимают фото, видео, документы, GIF и стикеры.
Другие возможности WhatsApp API
Получите ключ и отправьте первое сообщение за десять минут
Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.