Документация MAX API

Прием и отправка сообщений через HTTP-запросы для работы с MAX - работа с чатами, контактами, группами.

5 дней пробный период

Описание MAX API для сервиса Wappi

Методы отправки сообщений

Вы можете отправить сообщение в Max синхронной или асинхронной командой. Асинхронные методы выполняют запросы с постановкой в очередь, в ответе придет сообщение о постановке в очередь и id задачи. Синхронные методы отправления сообщений выполняются сразу и позволяют получить в ответе результат запроса

Особенности API

Это так называемый пользовательский MAX API, в котором можно авторизовать личный аккаунт в мессенджере Max по номеру телефона.

Токен авторизации передается в заголовке Authorization HTTP запроса. Profile_id передается query параметром в каждом запросе.

Безопасность

Этот API не предназначен для флуда, спама, накруток - мессенджер MAX может вас забанить. Рекомендуем использовать свои собственные http прокси для подключения.

Тестирование API

Чтобы протестировать API необходимо авторизоваться. Для этого на данной странице нажмите Authorize, в появившемся окне в поле Value вставьте ваш токен api. Токен можно найти в дашборде на странице вашего профиля

Личный кабинет >

Коллекция Postman

Для удобства тестирования нашего API можете воспользоваться коллекцией Postman. Там же можно найти примеры реализованных методов на разных языках программирования.

В коллекцию >

Методы API

Типы уведомлений Webhook

Webhook на статус отправленного сообщения

Есть несколько статусов отправленных сообщений - pending, delivered, read, undelivered, temporary ban, 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"
  }
}

Свернуть

Webhook на статус профиля

Есть несколько статусов профиля - 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
    }
  ]
}

Свернуть

Webhook на статус приложения


{
  "messages": [
    {
      "wh_type": "application_status",
      "profile_id": "81ad40e9-b023",
      "status": "online",
      "phone": "79991112233",
      "timestamp": "2025-08-01T22:04:44.198883039+03:00",
      "time": 1682967884
    }
  ]
}

Свернуть

Webhook на входящее сообщение


{
  "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
    }
  ]
}

Свернуть

Webhook на входящее изображение

Все изображения отдаются ссылками на скачивание, у которых есть время жизни.


{
  "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
    }
  ]
}

Свернуть

Webhook на входящее видео

Все видео отдаются ссылками на скачивание, у которых есть время жизни.


{
  "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
    }
  ]
}

Свернуть

Webhook на входящий документ или файл

Все документы и файлы отдаются ссылками на скачивание, у которых есть время жизни.


{
  "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
    }
  ]
}

Свернуть

Webhook на входящее голосовое сообщение


  {
    "messages": [
      {
        "id": "5908",
        "profile_id": "51a8107a-5442",
        "wh_type": "incoming_message",
        "timestamp": "2025-03-17T15:21:59+03:00",
        "time": 1742214119,
        "body": "JVBERi0xLjcNCiXi48/TDQo1IDAgb2JqD",
        "type": "ptt",
        "from": "60227586",
        "to": "5279188641",
        "senderName": "Sinn",
        "chatId": "60227586",
        "caption": "",
        "from_where": "phone",
        "mimetype": "audio/ogg",
        "contact_name": "Sinn",
        "contact_phone": "",
        "contact_username": "sinay",
        "username": "sinay",
        "is_forwarded": false,
        "isReply": false,
        "is_edited": false,
        "stanza_id": "",
        "is_me": false,
        "chat_type": "user",
        "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
        "picture": "",
        "wappi_bot_id": "",
        "is_deleted": false,
        "is_bot": false,
        "length_seconds": 1,
        "file_link": "https://wapi-u.storage.yandexcloud.net/51a",
        "file_link_expire": 1742473320
      }
    ]
  }

Свернуть

Webhook на входящее аудио или голосовое сообщение

Все аудио отдаются ссылками на скачивание, у которых есть время жизни.


{
  "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
    }
  ]
}

Свернуть

Webhook на входящую геолокацию


{
    "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
      }
    ]
  }

Свернуть

Webhook на входящий контакт


{
  "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
    }
  ]
}

Свернуть

Webhook на исходящее сообщение API


{
  "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
    }
  ]
}

Свернуть

Webhook на исходящее сообщение с телефона


{
  "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
    }
  ]
}

Свернуть

Частые вопросы

Можно ли получить бан за использование сервиса?

Бан за использование сервиса получить нельзя, но можно получить блокировку за нарушения правил MAX. Например за массовые рассылки, спам и жалобы получателей.

Не нашли ответ на свой вопрос?

Наша поддержка всегда готова помочь

Тарифы MAX API

Бесплатный пробный период 5 дней

1 месяц
3 месяца-10%
6 месяцев-15%
12 месяцев-30%

MAX

700 ₽

600 ₽~~700 ₽~~

550 ₽~~700 ₽~~

500 ₽~~700 ₽~~

за 1 профиль в месяц

Профиль это один подключенный аккаунт мессенджера. В рамках одного профиля можно менять номера.

API:
- MAX API
Сервисы:
- Агрегатор мессенджеров
- Чат-боты
- Рассылка сообщений
- ИИ-ассистент
- Виджет на сайт
Готовые интеграции:
- Битрикс24
- amoCRM
- и другие
Безлимит на сообщения

Скидки при оплате 10+ профилей

Начать бесплатно

Что еще предлагаем?

Становитесь техническим партнером и внедряйте мессенджеры в свою CRM или сервис с эксклюзивными условиями:

Скидки от объема
Подневная тарификация
Постоплата
Индивидуальные условия

Подробнее здесь