Документация Max API
Описание Max API для сервиса Wappi
Это так называемый пользовательский Max API, в котором можно авторизовать личный аккаунт в мессенджере Max по номеру телефона. С помощью этого API можно осуществлять прием и отправку сообщений через HTTP-запросы, а также работать с чатами, контактами и группами. Вы сможете написать сообщение первым любому номеру.
Бета-версия. Max API в активной разработке, возможна нестабильная работа. Обновления и новые методы выпускаются регулярно.
МЕТОДЫ ОТПРАВКИ СООБЩЕНИЯ
Вы можете отправить сообщение в Max синхронной или асинхронной командой. Асинхронные методы выполняют запросы с постановкой в очередь, в ответе придет сообщение о постановке в очередь и id задачи. Синхронные методы отправления сообщений выполняются сразу и позволяют получить в ответе результат запроса.
БЕЗОПАСНОСТЬ
Если вы используете наш API для флуда, спама, накруток - Max может вас забанить. Рекомендуем использовать свои собственные http прокси для подключения.
ОСОБЕННОСТИ API
Токен авторизации передается в заголовке Authorization HTTP запроса. Profile_id передается query параметром в каждом запросе.
ТЕСТИРОВАНИЕ API
Чтобы протестировать API необходимо авторизоваться. Для этого на данной странице нажмите Authorize, в появившемся окне в поле Value вставьте ваш токен api. Токен можно найти в дашборде на странице вашего профиля - Вход в личный кабинет.
КОЛЛЕКЦИЯ POSTMAN
Для удобства тестирования нашего API можете воспользоваться коллекцией Postman. Там же можно найти примеры реализованных методов на разных языках программирования.
Типы уведомлений Webhook
Есть несколько статусов отправленных сообщений - delivered, read, error.
{
"messages": {
"id": "114986604267657812",
"profile_id": "d6f3286b-e584",
"wh_type": "delivery_status",
"timestamp": "2025-08-07T11:45:41.554596021+03:00",
"time": 1754556339533,
"from": "79602041981",
"to": "79115576368",
"chat_id": "1820755",
"status": "delivered",
"task_id": "c47ab086-8a2a-49a2-9904-6dd39bcf4886"
}
}
Показывает авторизацию номера в мессенджере. Есть несколько статусов профиля - online, offline
{
"messages": [
{
"wh_type": "authorization_status",
"profile_id": "71ad40e9-b023",
"status": "offline",
"reason": "logout from api",
"phone": "79502041990",
"timestamp": "2025-07-13T17:00:02.57417156+03:00",
"time": 1699884002
}
]
}
Показывает статус приложения (контейнера), есть несколько статусов - online, offline
{
"messages": [
{
"wh_type": "application_status",
"profile_id": "81ad40e9-b023",
"status": "online",
"phone": "79991112233",
"timestamp": "2025-08-01T22:04:44.198883039+03:00",
"time": 1682967884
}
]
}
{
"messages": [
{
"id": "114992218890840885",
"profile_id": "d6f3286b-e584",
"wh_type": "incoming_message",
"timestamp": "2025-08-08T11:33:31+03:00",
"time": 1754642011884,
"body": "Текстовое сообщение",
"type": "text",
"from": "79115576368",
"to": "79602041981",
"senderName": "Max",
"senderLastName": "RAD",
"chatId": "1820755",
"caption": null,
"from_where": "phone",
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79115576368",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": false,
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"is_blacklist": false
}
]
}
Все изображения отдаются ссылками на скачивание, у которых есть время жизни.
{
"messages": [
{
"id": "114986632090512620",
"profile_id": "d6f3286b-e584",
"wh_type": "incoming_message",
"timestamp": "2025-08-07T11:52:44+03:00",
"time": 1754556764076,
"body": "https://wapi-uploads7d.storage.yandexcloud.net/d6f3286b-e584/46ff3965-f13d-40be-b71a-3725681ada2c.webp?X-Am084",
"type": "image",
"from": "79115576368",
"to": "79602041981",
"senderName": "Max",
"senderLastName": "RAD",
"chatId": "1820755",
"caption": null,
"from_where": "phone",
"mimetype": "image/webp",
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79115576368",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": false,
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"file_link": "https://wapi-uploads7d.storage.yandexcloud.net/d6f3286b-e58446ff3965-f13d-40be-b71a-3725681ada2c.webp?X-Amz687e90f18eedc66acb69e099e245523084",
"file_link_expire": 1754729564,
"media_info": {
"width": 1440,
"height": 1920,
"size": 0,
"duration": 0,
"is_round": false
},
"is_blacklist": false
}
]
}
Все видео отдаются ссылками на скачивание, у которых есть время жизни.
{
"messages": [
{
"id": "114986807251847681",
"profile_id": "d6f3286b-e584",
"wh_type": "incoming_message",
"timestamp": "2025-08-07T12:37:16+03:00",
"time": 1754559436826,
"body": "https://wapi-uploads7d.storage.yandexcloud.net/d6f3286b-e584/8809545796204.mp4?X-Aa893ee",
"type": "video",
"from": "79115576368",
"to": "79602041981",
"senderName": "Max",
"senderLastName": "RAD",
"chatId": "1820755",
"caption": null,
"from_where": "phone",
"mimetype": "video/mp4",
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79115576368",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": false,
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"file_link": "https://wapi-uploads7d.storage.yandexcloud.net/d6f3286b-e584/8809545796204.mp4?X-d0a893ee",
"file_link_expire": 1754732238,
"media_info": {
"width": 720,
"height": 1280,
"size": 0,
"duration": 0,
"is_round": false
},
"is_blacklist": false
}
]
}
Все документы и файлы отдаются ссылками на скачивание, у которых есть время жизни.
{
"messages": [
{
"id": "114986635801860743",
"profile_id": "d6f3286b-e584",
"wh_type": "incoming_message",
"timestamp": "2025-08-07T11:53:40+03:00",
"time": 1754556820707,
"body": "https://wapi-uploads7d.storage.yandexcloud.net/d6f3286b-e584/82.txt?X-A112ab",
"type": "document",
"from": "79115576368",
"to": "79602041981",
"senderName": "Max",
"senderLastName": "RAD",
"chatId": "1820755",
"caption": null,
"from_where": "phone",
"file_name": "текст.txt",
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79115576368",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": false,
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"file_link": "https://wapi-uploads7d.storage.yandexcloud.net/d6f3286b-e584/82.txt?X-Am112ab",
"file_link_expire": 1754729620,
"media_info": {
"width": 0,
"height": 0,
"size": 0,
"duration": 0,
"is_round": false
},
"is_blacklist": false
}
]
}
Все аудио отдаются ссылками на скачивание, у которых есть время жизни.
{
"messages": [
{
"id": "114986632723455254",
"profile_id": "d6f3286b-e584",
"wh_type": "incoming_message",
"timestamp": "2025-08-07T11:52:53+03:00",
"time": 1754556773734,
"body": "https://wapi-uploads7d.storage.yandexcloud.net/d6f3286b-e584/8809510275692.mp3?X-A5f27b8",
"type": "audio",
"from": "79115576368",
"to": "79602041981",
"senderName": "Max",
"senderLastName": "RAD",
"chatId": "1820755",
"caption": null,
"from_where": "phone",
"mimetype": "audio/mpeg",
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79115576368",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": false,
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"file_link": "https://wapi-uploads7d.storage.yandexcloud.net/d6f3286b-e584/8809510275692.mp3?X-Amz5f27b8",
"file_link_expire": 1754729573,
"media_info": {
"width": 0,
"height": 0,
"size": 0,
"duration": 3530,
"is_round": false
},
"is_blacklist": false
}
]
}
{
"messages": [
{
"id": "114986633608132594",
"profile_id": "d6f3286b-e584",
"wh_type": "incoming_message",
"timestamp": "2025-08-07T11:53:07+03:00",
"time": 1754556787233,
"body": "Location { Name: , Latitude: 64.596070, Longitude: 39.847370, DegreesLatitude: 0.000000, DegreesLongitude: 0.000000, Description: , JPEGThumbnail: }",
"type": "location",
"from": "79115576368",
"to": "79602041981",
"senderName": "Max",
"senderLastName": "RAD",
"chatId": "1820755",
"caption": null,
"from_where": "phone",
"location": {
"latitude": 64.59607,
"longitude": 39.84737,
"description": "",
"degreesLatitude": 0,
"degreesLongitude": 0,
"name": ""
},
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79115576368",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": false,
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"media_info": {
"width": 0,
"height": 0,
"size": 0,
"duration": 0,
"is_round": false
},
"is_blacklist": false
}
]
}
{
"messages": [
{
"id": "114986634530931463",
"profile_id": "d6f3286b-e584",
"wh_type": "incoming_message",
"timestamp": "2025-08-07T11:53:21+03:00",
"time": 1754556801314,
"body": "Contact { DisplayName: Владислав Васильевич, Phone: +79212410555, Vcard: BEGIN:VCARD\r\nVERSION:3.0\r\nPRODID:ez-vcard 0.10.3\r\nTEL;TYPE=CELL,VOICE,pref:+79212410555\r\nFN:Владислав Васильевич\r\nEND:VCARD\r\n }",
"type": "vcard",
"from": "79115576368",
"to": "79602041981",
"senderName": "Max",
"senderLastName": "RAD",
"chatId": "1820755",
"caption": null,
"from_where": "phone",
"contact": {
"display_name": "Владислав Васильевич",
"phone": "+79212410555",
"vcard": "BEGIN:VCARD\r\nVERSION:3.0\r\nPRODID:ez-vcard 0.10.3\r\nTEL;TYPE=CELL,VOICE,pref:+79212410555\r\nFN:Владислав Васильевич\r\nEND:VCARD\r\n"
},
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79115576368",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": false,
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"media_info": {
"width": 0,
"height": 0,
"size": 0,
"duration": 0,
"is_round": false
},
"is_blacklist": false
}
]
}
{
"messages": [
{
"id": "114986892458668556",
"profile_id": "d6f3286b-e584",
"wh_type": "outgoing_message_api",
"timestamp": "2025-08-07T12:58:56+03:00",
"time": 1754560736979,
"body": "Текстовое сообщение",
"type": "text",
"from": "79602041981",
"to": "79115576368",
"senderName": "Mi",
"senderLastName": "Mi",
"chatId": "1820755",
"caption": null,
"from_where": "api",
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79602041981",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": true,
"task_id": "2c7c54b6-f923-4fa8-b035-b6ad9a881aab",
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"is_blacklist": false
}
]
}
{
"messages": [
{
"id": "114992166609179805",
"profile_id": "d6f3286b-e584",
"wh_type": "outgoing_message_phone",
"timestamp": "2025-08-08T11:20:14+03:00",
"time": 1754641214129,
"body": "Текстовое сообщение с телефона",
"type": "text",
"from": "79602041981",
"to": "79115576368",
"senderName": "Mi",
"senderLastName": "",
"chatId": "1820755",
"caption": null,
"from_where": "phone",
"contact_name": "Макс Моряк",
"contact_last_name": "",
"contact_max_name": "Max",
"contact_max_last_name": "RAD",
"contact_phone": "79115576368",
"contact_username": "",
"phone": "79602041981",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"is_me": true,
"isGif": false,
"thumbnail": "",
"picture": "",
"wappi_bot_id": "",
"is_deleted": false,
"is_bot": false,
"is_blacklist": false
}
]
}