Документация 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

Все методы MAX APIПолный справочник - 55 методовСвернутьРазвернуть

Работа с профилем10 методов

POSTСоздать профиль/maxapi/profile/add

URL: https://wappi.pro/maxapi/profile/add?name=новый3&webhook_url=https://wappi.pro

Описание метода

Метод предназначен для создания нового профиля.

Вы передаете имя нового профиля, а его profile_id автоматически генерируется системой и возвращается в ответе.

Query Params

ПараметрЗначениеОписание

nameновый3Обязательный параметр. Имя нового профиля.

webhook_urlhttps://wappi.proНеобязательный параметр. Установка URL ссылки на вебхук.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

Тело запроса не передается.

Responses

Создать профиль200

{
  "profile_id": "21f018f2-647a",
  "status": "done",
  "time": "2026-03-06T13:03:50+03:00",
  "timestamp": 1772791430
}

POSTУдалить профиль/maxapi/profile/delete

URL: https://wappi.pro/maxapi/profile/delete?profile_id={{profile_id}}

Описание метода

Удаление существующего профиля. При удалении профиля все данные, оплаты и чат-боты, связанные с этим профилем, будут безвозвратно удалены. Авторизация также удаляется.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Удалить профиль200

{
  "detail": "Profile cea791a3-8a21 deleted",
  "status": "done",
  "time": "2025-08-06T12:09:10+03:00",
  "timestamp": 1754471350
}

GETПолучить статус и настройки профиля/maxapi/sync/get/status

URL: https://wappi.pro/maxapi/sync/get/status?profile_id={{profile_id}}

Описание метода

Получение статуса и настроек профиля.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить статус и настройки профиля200

{
  "app_status": "close",
  "authorized": false,
  "authorized_at": null,
  "checked_at": "2025-08-06T12:08:15.617842+03:00",
  "last_activity": 0,
  "logouted_at": null,
  "message_count": 0,
  "name": "новый3",
  "payment_expired_at": "2025-08-07T00:00:00Z",
  "payment_notification": true,
  "phone": "",
  "platform": "max",
  "profile_id": "d6f3286b-e584",
  "proxy": "",
  "uuid": "d6f3286b-e584",
  "webhook_types": [
    "incoming_message",
    "delivery_status",
    "authorization_status"
  ],
  "webhook_url": "",
  "worked_days": 0
}

GETПолучить все профили/maxapi/profile/all/get

URL: https://wappi.pro/maxapi/profile/all/get

Описание метода

Получение сведений о всех профилях MAX в аккаунте.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить все профили200

{
  "profiles": [
    {
      "app_status": "",
      "proxy": "",
      "profile_id": "5dbf254b-8290",
      "name": "max2",
      "webhook_url": "",
      "authorized": true,
      "uuid": "5dbf254b-8290",
      "is_subscribe": false,
      "checked_at": "2025-07-28T21:44:52.159424+03:00",
      "authorized_at": "2025-08-04T19:29:15.65488+03:00",
      "logouted_at": null,
      "phone": "79111104491",
      "worked_days": 0,
      "webhook_types": [
        "incoming_message",
        "delivery_status",
        "authorization_status"
      ],
      "wh_types": null,
      "last_activity": 0,
      "message_count": 1,
      "payment_notification": true,
      "deleted_at": null,
      "platform": "max"
    },
    {
      "app_status": "",
      "proxy": "",
      "profile_id": "7ef2017c-2f43",
      "name": "новый2",
      "webhook_url": "",
      "authorized": false,
      "uuid": "7ef2017c-2f43",
      "is_subscribe": false,
      "checked_at": "2025-08-04T19:22:49.679688+03:00",
      "authorized_at": null,
      "logouted_at": null,
      "phone": "",
      "worked_days": 0,
      "webhook_types": [
        "incoming_message",
        "delivery_status",
        "authorization_status"
      ],
      "wh_types": null,
      "last_activity": 0,
      "message_count": 0,
      "payment_notification": true,
      "deleted_at": null,
      "platform": "max"
    },
    {
      "app_status": "",
      "proxy": "",
      "profile_id": "3a91f18a-1be9",
      "name": "Профиль",
      "webhook_url": "https://webhook.site/6b374985-cdcc-450c-905e-0b3124dd5268",
      "authorized": true,
      "uuid": "3a91f18a-1be9",
      "is_subscribe": false,
      "checked_at": "2025-08-04T19:21:17.272388+03:00",
      "authorized_at": "2025-08-04T19:45:15.086389+03:00",
      "logouted_at": "2025-08-04T19:38:17.382368+03:00",
      "phone": "79815435353",
      "worked_days": 0,
      "webhook_types": [
        "incoming_message",
        "delivery_status",
        "authorization_status"
      ],
      "wh_types": null,
      "last_activity": 0,
      "message_count": 0,
      "payment_notification": true,
      "deleted_at": null,
      "platform": "max"
    },
    {
      "app_status": "",
      "proxy": "",
      "profile_id": "d6f3286b-e584",
      "name": "новый3",
      "webhook_url": "https://webhook.site/944561a8-0a8f-4598-ae01-bd485d09cfd3",
      "authorized": true,
      "uuid": "d6f3286b-e584",
      "is_subscribe": false,
      "checked_at": "2025-08-06T12:08:15.617842+03:00",
      "authorized_at": "2025-08-07T02:26:44.823245+03:00",
      "logouted_at": null,
      "phone": "79815345353",
      "worked_days": 0,
      "webhook_types": [
        "authorization_status",
        "incoming_message",
        "delivery_status",
        "outgoing_message_phone",
        "outgoing_message_api",
        "application_status"
      ],
      "wh_types": null,
      "last_activity": 0,
      "message_count": 15,
      "payment_notification": true,
      "deleted_at": null,
      "platform": "max"
    },
    {
      "app_status": "",
      "proxy": "",
      "profile_id": "bf005295-6f91",
      "name": "MAXTEST",
      "webhook_url": "https://webhook.site/6b374985-cdcc-450c-905e-0b3124dd5268",
      "authorized": true,
      "uuid": "bf005295-6f91",
      "is_subscribe": false,
      "checked_at": "2025-07-24T17:46:40.336174+03:00",
      "authorized_at": "2025-08-07T02:23:12.396377+03:00",
      "logouted_at": "2025-08-03T17:05:20.749941+03:00",
      "phone": "79115576361",
      "worked_days": 0,
      "webhook_types": [
        "authorization_status",
        "incoming_message",
        "delivery_status",
        "outgoing_message_phone",
        "outgoing_message_api",
        "application_status"
      ],
      "wh_types": null,
      "last_activity": 0,
      "message_count": 140,
      "payment_notification": true,
      "deleted_at": null,
      "platform": "max"
    }
  ],
  "status": "done"
}

GETПерезагрузить профиль/maxapi/profile/restart

URL: https://wappi.pro/maxapi/profile/restart?profile_id={{profile_id}}

Описание метода

Перезагрузка приложения (профиля).

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Перезагрузить профиль200

{
  "detail": "Your profile has been restarted",
  "status": "done"
}

GETАвторизовать по QR/maxapi/sync/auth/qr

URL: https://wappi.pro/maxapi/sync/auth/qr?profile_id={{profile_id}}

Описание метода

Метод для авторизации в MAX по QR коду. Запрос позволяет получить QR код с неавторизованного профиля.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

Тело запроса не передается.

Responses

Авторизовать по QR200

{
  "status": "done",
  "timestamp": 0,
  "time": "2026-02-20T16:44:19+03:00",
  "detail": "",
  "task_id": "",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-20T16:44:19.906753354+03:00",
  "uuid": "15396b7f-9383"
}

POSTВвести облачный пароль 2fa/maxapi/sync/auth/2fa

URL: https://wappi.pro/maxapi/sync/auth/2fa?profile_id={{profile_id}}

Описание метода

Метод позволяет ввести облачный пароль двухфакторной авторизации, чтобы авторизоваться в MAX

Request Body

Параметр	Тип данных	Обяз.	Описание
pwd_code	string	Да	Пароль двухфакторной авторизации (2FA), установленный в аккаунте MAX.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "pwd_code": "string"
}

Responses

Ввести облачный пароль 2fa200

{
  "status": "done",
  "detail": "auth_success",
  "uuid": "fae370e3-0a5е"
}

GETВыйти из max/maxapi/profile/logout

URL: https://wappi.pro/maxapi/profile/logout?profile_id={{profile_id}}

Описание метода

Разавторизация в MAX.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса urlencoded

Тело запроса не передается.

Responses

Выйти из max200

{
  "status": "done",
  "timestamp": 1754569518,
  "time": "2025-08-07T15:25:18+03:00",
  "detail": "logout success",
  "task_id": "0b64c11c-6f51-4ed3-939b-e94c965d1477",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2025-08-07T15:25:18.772003061+03:00",
  "uuid": "d6f3286b-e584"
}

POSTОплатить профиль с баланса/payments/balance/add_days

URL: https://wappi.pro/payments/balance/add_days

Описание метода

Метод позволяет оплатить один или несколько профилей за счёт средств на балансе Wappi с применением выбранного тарифа.

Request Body

Параметр	Тип данных	Обяз.	Описание
profile_uuid	string	Да	ID профиля, для которого выполняется оплата Можно получить в личном кабинете на странице конкретного профиля.
tariff_id	integer	Да	ID выбранного тарифа Доступные тарифы: 1 - Базовый 1 месяц; 2 - Базовый 3 месяца; 3 - Базовый 6 месяцев; 4 - Базовый 12 месяцев; 5001 - Полный 1 месяц; 5002 - Полный 3 месяца; 5003 - Полный 6 месяцев; 5004 - Полный 12 месяцев.
profile_ids	array\[string\]	Нет	Массив ID дополнительных профилей для оплаты Если указаны, оплата применяется ко всем профилям из profile_uuid и profile_ids.
code	string	Нет	Промо-код на скидку

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "profile_uuid": "uuid",
  "tariff_id": 1,
  "profile_ids": [
    "uuid",
    "uuid2"
  ],
  "code": "promo_code"
}

Responses

Оплатить профиль с баланса200

/dashboard/15396b7f-4263

GETПолучить историю авторизаций профиля/panel/profile/auth/history

URL: https://wappi.pro/panel/profile/auth/history?profile_id={{profile_id}}

Описание метода

Получение истории авторизаций в профиле.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить историю авторизаций профиля200

{
  "auth_history": [
    {
      "type": "login",
      "phone": "79765656542",
      "created_at": "2026-02-19T14:26:17.615257+03:00",
      "reason": ""
    },
    {
      "type": "logout",
      "phone": "79765656542",
      "created_at": "2026-02-19T14:25:16.919082+03:00",
      "reason": ""
    },
    {
      "type": "login",
      "phone": "79765656542",
      "created_at": "2026-02-19T14:19:15.688593+03:00",
      "reason": ""
    }
  ],
  "status": "done"
}

Работа с сообщениями / Синхронные методы13 методов

POSTОтправить текстовое сообщение/maxapi/sync/message/send

URL: https://wappi.pro/maxapi/sync/message/send?profile_id={{profile_id}}&bot_id=18383820&ttl=600

Описание метода

Отправка текстового сообщения.

Сообщение может быть отправлено как по recipient (телефон), так и по chat_id (идентификатор чата) или user_id (идентификатор пользователя) которые указываются в Body. Если указаны все три, то приоритет будет у user_id.

Дополнительно может быть передан объект manager — информация о менеджере, от имени которого отправляется сообщение.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`
chat_id	string	Да\*	Идентификатор существующего чата. Имеет приоритет над `recipient`. Пример: `"-12307927"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
body	string	Да	Текст сообщения. Пример: `"Привет! Как ты?"`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

\* Обязателен один из параметров: recipient или chat_id или user_id. Если указано несколько параметров одновременно, используется следующий приоритет: user_id → chat_id → recipient

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

bot_id18383820Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее сообщение по API. Например информация о сервисе-источнике запроса.

ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "recipient": "79602763846",
  "chat_id": "-71254750819698",
  "user_id": 5372054,
  "body": "Привет! Как ты? Что нового?",
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить текстовое сообщение200

{
  "status": "done",
  "timestamp": 1772784680,
  "time": "2026-03-06T11:11:20+03:00",
  "detail": "Message sent successfully",
  "task_id": "e1d43511948cf1c588a3ff89b627f447",
  "command_start": "2026-03-06T11:11:20.525822354+03:00",
  "command_end": "2026-03-06T11:11:20.591227699+03:00",
  "uuid": "15396b7f-4263",
  "message_id": "116181216826565519"
}

POSTОтправить медиа по ссылке/maxapi/async/message/file/url/send

URL: https://wappi.pro/maxapi/async/message/file/url/send?profile_id={{profile_id}}&bot_id=163628382&ttl=600

Описание метода

Отправка сообщения с изображением, видео или документом. К изображению или видео можно добавить подпись. К документу можно добавить имя файла.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`
chat_id	string	Да\*	Идентификатор чата. Используется для отправки сообщения в существующий чат. Имеет приоритет над `recipient`.Пример: `"-2125475081969"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
url	string	Да	Прямая ссылка на файл (изображение, видео или документ), доступная для скачивания сервером. Пример: `"https://example.com/file.pdf"`
file_name	string	Нет	Имя файла Используется для документов
caption	string	Нет	Подпись к медиафайлу. Используется для изображений и видео. Пример: `"Медиа по ссылке"`
as_file	boolean	Нет	Отправить медиа как файл. Используется для изображений и видео, позволяет выбрать отправлять как файл или нет. Пример: `true`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

bot_id163628382Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее сообщение по API. Например информация о сервисе-источнике запроса.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "recipient": "79639486243",
  "chat_id": "-71254750819698",
  "user_id": 5372034,
  "url": "https://i.pinimg.com/736x/5e/11/5e/5e115ed0dd799a2f44f735af96ec225a.jpg",
  "file_name": "Имя файла",
  "caption": "Подпись к файлу",
  "as_file": true,
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить медиа по ссылке200

{
  "status": "done",
  "timestamp": 1772784208,
  "time": "2026-03-06T11:03:28+03:00",
  "detail": "Message sent to queue",
  "task_id": "3b3080bb71515c58302b5368c3dbec9f",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": "15396b7f-4263"
}

POSTОтметить сообщение прочитанным/maxapi/sync/message/mark/read

URL: https://wappi.pro/maxapi/sync/message/mark/read?profile_id={{profile_id}}

Описание метода

Метод позволяет отметить сообщение прочитанным.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
message_id	string	Да	Идентификатор сообщения, которое необходимо отметить как прочитанное. Пример: `"3085"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "message_id": "116158580677630247"
}

Responses

Отметить сообщение прочитанным200

{
  "status": "done",
  "timestamp": 1771504047,
  "time": "2026-02-19T15:27:27+03:00",
  "detail": "Messages marked as read successfully",
  "task_id": "e737ff44db9e6d6ef89a63f691a96116",
  "command_start": "2026-02-19T15:27:27.797327607+03:00",
  "command_end": "2026-02-19T15:27:27.978478432+03:00",
  "uuid": "15396b7f-4263"
}

POSTОтправить реакцию на сообщение/maxapi/sync/message/reaction

URL: https://wappi.pro/maxapi/sync/message/reaction?profile_id={{profile_id}}&bot_id=18383820

Описание метода

Отправка реакции на сообщение. Повторный вызов метода, если в параметре body передано новое значение, изменяет реакцию.

Дополнительно может быть передан объект manager — информация о менеджере, от имени которого отправляется реакция.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
body	string	Да	Реакция в виде одного эмодзи. Пример: `"👍"`
message_id	string	Да	Идентификатор сообщения, на которое отправляется реакция. Пример: `"132132132123132132132"`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "body": "👍",
  "message_id": "116158580677630247",
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить реакцию на сообщение200

{
  "status": "done",
  "timestamp": 1772785045,
  "time": "2026-03-06T11:17:25+03:00",
  "detail": "Reaction set successfully",
  "task_id": "1f646ee7ce50db4c5065d8390ed3b320",
  "command_start": "2026-03-06T11:17:25.893223744+03:00",
  "command_end": "2026-03-06T11:17:25.952880184+03:00",
  "uuid": "15396b7f-4263"
}

POSTОтветить на сообщение/maxapi/sync/message/reply

URL: https://wappi.pro/maxapi/sync/message/reply?profile_id={{profile_id}}&bot_id=18383820

Описание метода

Метод позволяет отправить ответ на конкретное сообщение. Если в теле запроса указано поле url, будет отправлено сообщение с файлом. Если поле url отсутствует, отправляется текстовый ответ.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
body	string	Да\*	Текст ответа. Пример: `"тестовый ответ на сообщение"`
message_id	string	Да	Идентификатор сообщения, на которое отправляется ответ. Пример: `"114998436624933775"`
url	string	Да\*	Прямая ссылка на файл для отправки вместе с ответом. Если поле отсутствует, отправляется только текст. Пример: `"https://example.com/file.jpg"`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

\* Обязателен как минимум один из параметров: body или url. Допустимо использование двух параметров одновременно.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "body": "тестовый ответ на сообщение",
  "message_id": "116136317123974440",
  "url": "https://img.freepik.com/free-photo/cute-kitten-sitting-staring-playful-fluffy-looking-camera-generated-by-artificial-intelligence_188544-113029.jpg?semt=ais_hybrid&w=740",
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Ответить на сообщение200

{
  "status": "done",
  "timestamp": 1772792734,
  "time": "2026-03-06T13:25:34+03:00",
  "detail": "Reply message sent successfully",
  "task_id": "311a33e90cbb1c9ad85acdab7611b5df",
  "command_start": "2026-03-06T13:25:33.630768599+03:00",
  "command_end": "2026-03-06T13:25:34.045627437+03:00",
  "uuid": "15396b7f-4263",
  "message_id": "116181744607703486"
}

POSTИзменить сообщение/maxapi/sync/message/edit

URL: https://wappi.pro/maxapi/sync/message/edit?profile_id={{profile_id}}&bot_id=18383820

Описание метода

Метод позволяет изменить текст ранее отправленного сообщения. При необходимости можно заменить прикреплённый к сообщению файл, передав параметр url.

Дополнительно может быть передан объект manager — информация о менеджере, от имени которого изменяется сообщение.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
body	string	Да\*	Новый текст сообщения. Пример: `"Измененное сообщение"`
url	string	Да\*	Ссылка на новый файл, если требуется заменить вложение. Пример: `"https://example.com/file.jpg"`
message_id	string	Да	Идентификатор сообщения, которое необходимо изменить. Пример: `"3079"`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

\* Обязателен как минимум один из параметров: body или url. Параметры могут быть переданы одновременно. При изменении вложения (url) текст исходного сообщения не сохраняется автоматически. Для сохранения текста его необходимо повторно передать в параметре body.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "body": "Измененное сообщение",
  "url": "https://img.freepik.com/free-photo/cute-kitten-sitting-staring-playful-fluffy-looking-camera-generated-by-artificial-intelligence_188544-113029.jpg",
  "message_id": "116155034852547211",
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Изменить сообщение200

{
  "status": "done",
  "timestamp": 1772792762,
  "time": "2026-03-06T13:26:02+03:00",
  "detail": "Message edited successfully",
  "task_id": "923933bd8e73cfba4c4b0a38787e922c",
  "command_start": "2026-03-06T13:26:02.206168862+03:00",
  "command_end": "2026-03-06T13:26:02.766814588+03:00",
  "uuid": "15396b7f-4263",
  "message_id": "116155034852547211"
}

POSTПереслать сообщение/maxapi/sync/message/forward

URL: https://wappi.pro/maxapi/sync/message/forward?profile_id={{profile_id}}&bot_id=18383820

Описание метода

Метод позволяет переслать ранее полученное или отправленное сообщение другому получателю.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
message_id	string	Да	Идентификатор сообщения, которое необходимо переслать.Пример: `"116097585839898064"`
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`
chat_id	string	Да\*	Идентификатор чата. Используется для отправки сообщения в существующий чат. Имеет приоритет над `recipient`.Пример: `"-2125475081969"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "message_id": "116148440525051227",
  "recipient": "79522345680",
  "chat_id": "-71254750819698",
  "user_id": 5372054,
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Переслать сообщение200

{
  "status": "done",
  "timestamp": 1772284564,
  "time": "2026-02-28T16:16:04+03:00",
  "detail": "Message forwarded successfully",
  "task_id": "2abb05aa07cfe4c4147fdd1dc59907da",
  "command_start": "2026-02-28T16:16:04.271698776+03:00",
  "command_end": "2026-02-28T16:16:04.419473858+03:00",
  "uuid": "15396b7f-4263",
  "message_id": "116148441213904078"
}

POSTОтправить локацию/maxapi/sync/message/location/send

URL: https://wappi.pro/maxapi/sync/message/location/send?profile_id={{profile_id}}&bot_id=18383820

Описание метода

Отправка геолокации.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`
chat_id	string	Да\*	Идентификатор чата Имеет приоритет над `recipient`.Пример: `"-71254750819698"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
latitude	number	Да	Широта Десятичные градусы. Пример: `55.750446`
longitude	number	Да	Долгота Десятичные градусы. Пример: `37.617494`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "recipient": "79115576367",
  "chat_id": "-71254750819698",
  "user_id": 5372043,
  "latitude": 55.750446,
  "longitude": 37.617494,
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить локацию200

{
  "status": "done",
  "timestamp": 1772789429,
  "time": "2026-03-06T12:30:29+03:00",
  "detail": "Location sent successfully",
  "task_id": "0b92f6a0b24adb212efbe6a01f8f4457",
  "command_start": "2026-03-06T12:30:28.978471614+03:00",
  "command_end": "2026-03-06T12:30:29.063953427+03:00",
  "uuid": "15396b7f-4263",
  "message_id": "116181528022221235"
}

POSTОтправить контакт/maxapi/sync/contact/send

URL: https://wappi.pro/maxapi/sync/contact/send?profile_id={{profile_id}}&bot_id=18383820

Описание метода

Отправка контакта.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
phone	string	Да	Номер телефона передаваемого контакта Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Примеры: `"79115556677"`
name	string	Нет	Имя контакта, которое будет отображаться у получателя. Пример: `"Имя контакта"`
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Примеры: "79115556677"
chat_id	string	Да\*	Идентификатор чата для отправки контакта. Имеет приоритет над `recipient`.Пример: `"71219698"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "phone": "79387475656",
  "recipient": "79769879898",
  "chat_id": "-71254750819698",
  "user_id": 5372043,
  "name": "Имя контакта",
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить контакт200

{
  "status": "done",
  "timestamp": 1772789551,
  "time": "2026-03-06T12:32:31+03:00",
  "detail": "Contact sent successfully",
  "task_id": "20009549779908ecaee4b547eff8401e",
  "command_start": "2026-03-06T12:32:31.010883784+03:00",
  "command_end": "2026-03-06T12:32:31.223714541+03:00",
  "uuid": "15396b7f-4263",
  "message_id": "116181536028101218"
}

POSTУдалить сообщение/maxapi/sync/message/delete

URL: https://wappi.pro/maxapi/sync/message/delete?profile_id={{profile_id}}

Описание метода

Удаление сообщения.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
message_id	string	Да	Идентификатор сообщения, которое необходимо удалить Пример: `"116102904933976674"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "message_id": "116102904933976674"
}

Responses

Удалить сообщение200

{
  "status": "done",
  "timestamp": 1771590521,
  "time": "2026-02-20T15:28:41+03:00",
  "detail": "Message deleted successfully",
  "task_id": "8be834577b7b20d712a3c9bb98f86d45",
  "command_start": "2026-02-20T15:28:40.40293792+03:00",
  "command_end": "2026-02-20T15:28:41.059439643+03:00",
  "uuid": "15396b7f-4263"
}

GETПолучить сообщения из чата/maxapi/sync/messages/get

URL: https://wappi.pro/maxapi/sync/messages/get?profile_id={{profile_id}}&chat_id=-71254750819698&limit=2&date=2024-02-22T15:50:51&offset=0&mark_all=true&order=desc

Описание метода

Получение сообщений из конкретного чата.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

chat_id-71254750819698Обязательный параметр. ID чата из списка сообщений.

limit2Необязательный параметр. Количество сообщений для получения. Если не указывать, то по умолчанию установлено значение 100. Максимальное значение 100.

date2024-02-22T15:50:51Необязательный параметр. Дата, с которой вывести список сообщений. Формат YYYY-mm-ddTHH:MM:ss (например 2023-12-31T12:00:00).

offset0Необязательный параметр. От какого по счету элемента вывести список сообщений, где 0 это самое новое сообщение. Если не указывать, то по умолчанию установлено значение 0.

mark_alltrueНеобязательный параметр. Значения true или false. Если true, то помечает все непрочитанные сообщения в чате прочитанными. Если не указывать, то по умолчанию стоит значение false. Работает только для личных чатов, для групп не работает.

orderdescНеобязательный параметр. Значения desc или asc. Если desc - сортирует от новых к старым, если asc - от старых к новым. Если не указывать, то по умолчанию стоит desc

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить сообщения из чата200

{
  "status": "done",
  "timestamp": 1772470744,
  "time": "2026-03-02T19:59:04+03:00",
  "detail": "Successfully fetched 2 messages (hasMore: true)",
  "task_id": "7fbfec7f6904ba7f59e6b88b5b1c42dc",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-03-02T19:59:04.149632167+03:00",
  "uuid": "15396b7f-4263",
  "messages": [
    {
      "id": "116158580677630247",
      "type": "text",
      "from": "79116543434",
      "to": "-71254750819698",
      "fromMe": true,
      "senderName": "erva",
      "contact_name": "гг",
      "username": "",
      "phone": "79116543434",
      "time": 1772439280359,
      "body": "Привет! Как ты? Что нового?",
      "stanzaId": "",
      "chatId": "-71254750819698",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "file_name": "",
      "isRead": false,
      "delivery_status": "read",
      "s3Info": {},
      "poll_votes": null,
      "mimetype": "",
      "from_where": "api",
      "isEdited": false,
      "isGif": false,
      "isFromAPI": true,
      "isDeleted": false,
      "location": null,
      "isPinned": false,
      "reactions": [
        {
          "reaction": "👍",
          "count": 1,
          "user_id": "15349106",
          "contact_name": "erva",
          "type": "add"
        }
      ],
      "wappi_bot_id": "",
      "task_id": "9ff09c9a5dd7e24102f80eb860e5a429",
      "template_id": "",
      "manager": {
        "id": "38200203",
        "name": "Светлана",
        "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
        "description": "описание пример"
      },
      "crm_entities": {
        "crm_type": "",
        "crm_id": "",
        "message_id": "",
        "chat_id": "",
        "manager_id": ""
      },
      "is_blacklist": false,
      "billable": false,
      "attaches": null
    },
    {
      "id": "116155047953199354",
      "type": "vcard",
      "from": "79116543434",
      "to": "-71254750819698",
      "fromMe": true,
      "senderName": "erva",
      "contact_name": "",
      "username": "",
      "phone": "79116543434",
      "time": 1772385375262,
      "body": [
        {
          "Key": "displayname",
          "Value": "Имя контакта "
        },
        {
          "Key": "phone",
          "Value": ""
        },
        {
          "Key": "vcard",
          "Value": "BEGIN:VCARD\r\nVERSION:3.0\r\nPRODID:ez-vcard 0.10.3\r\nTEL;TYPE=CELL,VOICE,pref:\r\nFN:Имя контакта \r\nEND:VCARD\r\n"
        }
      ],
      "stanzaId": "",
      "chatId": "-71254750819698",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "file_name": "",
      "isRead": false,
      "delivery_status": "read",
      "s3Info": {},
      "poll_votes": null,
      "mimetype": "",
      "from_where": "api",
      "isEdited": false,
      "isGif": false,
      "isFromAPI": true,
      "isDeleted": false,
      "location": null,
      "isPinned": false,
      "reactions": null,
      "wappi_bot_id": "",
      "task_id": "d9be0aafe2ad1ae191c8d5eeb4408c77",
      "template_id": "",
      "manager": {
        "id": "38200203",
        "name": "Светлана",
        "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
        "description": "описание пример"
      },
      "crm_entities": {
        "crm_type": "",
        "crm_id": "",
        "message_id": "",
        "chat_id": "",
        "manager_id": ""
      },
      "contact": {
        "display_name": "Имя контакта ",
        "vcard": "BEGIN:VCARD\r\nVERSION:3.0\r\nPRODID:ez-vcard 0.10.3\r\nTEL;TYPE=CELL,VOICE,pref:\r\nFN:Имя контакта \r\nEND:VCARD\r\n"
      },
      "is_blacklist": false,
      "billable": false,
      "attaches": null
    }
  ],
  "has_more": true
}

GETПолучить сообщение по ID/maxapi/sync/messages/id/get

URL: https://wappi.pro/maxapi/sync/messages/id/get?profile_id={{profile_id}}&message_id=114997934844772126

Описание метода

Получение конкретного сообщения.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

message_id114997934844772126Обязательный параметр. ID сообщения

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить сообщение по ID200

{
  "status": "done",
  "timestamp": 1771594539,
  "time": "2026-02-20T16:35:39+03:00",
  "detail": "Successfully fetched message",
  "task_id": "188400dc21f0694e589ab0c912bc2048",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-20T16:35:39.061682352+03:00",
  "uuid": "15396b7f-4263",
  "message": {
    "id": "116103215172438421",
    "type": "document",
    "from": "79522536474",
    "to": "79602876553",
    "fromMe": true,
    "senderName": "Оксана",
    "contact_name": "Виктор",
    "username": "",
    "phone": "79522536474",
    "time": 1771594469794,
    "body": "",
    "stanzaId": "",
    "chatId": "12307927",
    "isForwarded": false,
    "isReply": false,
    "caption": "",
    "file_name": "таблица.xml",
    "isRead": false,
    "delivery_status": "",
    "s3Info": {
      "url": "https://wapi-uploads3d.storage.yandexcloud.net/15396b7f-4263/%D1%82%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0.xml?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEx61R4C7kz0v5oC6y60Gx%2F20260220%2Fru-central1%2Fs3%2Faws4_request&X-Amz-Date=20260220T133449Z&X-Amz-Expires=259200&X-Amz-SignedHeaders=host&x-id=GetObject&X-Amz-Signature=f9a04f121b80cb3aae063d5ca03585e3c315a31bacc463c23c2990fa0eaddffb",
      "expire": 1771853689
    },
    "poll_votes": null,
    "mimetype": "",
    "from_where": "phone",
    "isEdited": false,
    "isGif": false,
    "isFromAPI": true,
    "isDeleted": false,
    "location": null,
    "isPinned": false,
    "reactions": null,
    "media_info": {
      "width": 0,
      "height": 0,
      "size": 0,
      "duration": 0,
      "is_round": false,
      "is_group": false,
      "grouped_id": ""
    },
    "wappi_bot_id": "",
    "task_id": "",
    "template_id": "",
    "crm_entities": {
      "crm_type": "",
      "crm_id": "",
      "message_id": "",
      "chat_id": "",
      "manager_id": ""
    },
    "is_blacklist": false,
    "billable": false,
    "attaches": [
      {
        "id": "116103215172438420_FILE",
        "type": "FILE",
        "url": "https://wapi-uploads7d.storage.yandexcloud.net/15396b7f-4263/%D1%82%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0%2811%29.xml?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEx61R4C7kz0v5oC6y60Gx%2F20260220%2Fru-central1%2Fs3%2Faws4_request&X-Amz-Date=20260220T133430Z&X-Amz-Expires=172800&X-Amz-SignedHeaders=host&x-id=GetObject&X-Amz-Signature=339009f469fed59134a92e7bb5802993ac89142ae19f172a2fe4d4abf587b968",
        "caption": "",
        "mimetype": "",
        "file_name": "таблица.xml",
        "size": 3423
      }
    ]
  }
}

GETСкачать медиа из сообщения/maxapi/sync/message/media/download

URL: https://wappi.pro/maxapi/sync/message/media/download?profile_id={{profile_id}}&message_id=5880

Описание метода

Метод позволяет скачать файл из конкретного сообщения.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

message_id5880Обязательный параметр. ID сообщения, из которого необходимо скачать файл

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Скачать медиа из сообщения200

{
  "status": "done",
  "timestamp": 1771594489,
  "time": "2026-02-20T16:34:49+03:00",
  "detail": "Media downloaded successfully: таблица.xml",
  "task_id": "2c00d494bb6798690d55a78da67ec909",
  "command_start": "2026-02-20T16:34:48.910184976+03:00",
  "command_end": "2026-02-20T16:34:49.226809399+03:00",
  "uuid": "15396b7f-4263",
  "file_link": "https://wapi-uploads3d.storage.yandexcloud.net/15396b7f-4263/%D1%82%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0.xml?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEx61R4C7kz0v5oC6y60Gx%2F20260220%2Fru-central1%2Fs3%2Faws4_request&X-Amz-Date=20260220T133449Z&X-Amz-Expires=259200&X-Amz-SignedHeaders=host&x-id=GetObject&X-Amz-Signature=f9a04f121b80cb3aae063d5ca03585e3c315a31bacc463c23c2990fa0eaddffb",
  "file_link_expire": 1771853689
}

Работа с сообщениями / Асинхронные методы6 методов

POSTОтправить текстовое сообщение/maxapi/async/message/send

URL: https://wappi.pro/maxapi/async/message/send?profile_id={{profile_id}}&timeout_from=1&timeout_to=3&bot_id=1&ttl=600

Описание метода

Отправка текстового сообщения.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`
chat_id	string	Да\*	Идентификатор существующего чата. Имеет приоритет над `recipient`. Пример: `"-12307927"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
body	string	Да	Текст сообщения. Пример: `"Привет! Как ты?"`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

timeout_from1Необязательный параметр. Минимальное время задержки, указывается в секундах

timeout_to3Необязательный параметр. Максимальное время задержки, указывается в секундах

bot_id1Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке. Например информацией о сервисе-источнике запроса.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "recipient": "79118276363",
  "chat_id": "-71254750819698",
  "user_id": 5372659,
  "body": "Привет! Как ты? Что нового?",
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить текстовое сообщение200

{
  "status": "done",
  "timestamp": 1772790494,
  "time": "2026-03-06T12:48:14+03:00",
  "detail": "Message sent to queue",
  "task_id": "60955b93617518577b76e613a1ce5b01",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": ""
}

POSTОтправить медиа по ссылке/maxapi/async/message/file/url/send

URL: https://wappi.pro/maxapi/async/message/file/url/send?profile_id={{profile_id}}&bot_id=1&timeout_from=1&timeout_to=3&ttl=600

Описание метода

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`
chat_id	string	Да\*	Идентификатор чата. Используется для отправки сообщения в существующий чат. Имеет приоритет над `recipient`.Пример: `"-2125475081969"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
url	string	Да	Прямая ссылка на файл (изображение, видео или документ), доступная для скачивания сервером. Пример: `"https://example.com/file.pdf"`
file_name	string	Нет	Имя файла Используется для документов
caption	string	Нет	Подпись к медиафайлу. Используется для изображений и видео. Пример: `"Медиа по ссылке"`
as_file	boolean	Нет	Отправить медиа как файл. Используется для изображений и видео, позволяется выбрать отправлять как файл или нет. Пример: `true`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

timeout_from1Необязательный параметр. Минимальное время задержки, указывается в секундах

timeout_to3Необязательный параметр. Максимальное время задержки, указывается в секундах

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "recipient": "79639486243",
  "chat_id": "-71254750819698",
  "user_id": 5372659,
  "url": "https://disk.sample.cat/samples/xml/sample-1.xml",
  "file_name": "таблица.xml",
  "caption": "Медиа по ссылке",
  "as_file": true,
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить медиа по ссылке200

{
  "status": "done",
  "timestamp": 1772790587,
  "time": "2026-03-06T12:49:47+03:00",
  "detail": "Message sent to queue",
  "task_id": "5667b6b37a8de92d175bd120223618bf",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": "15396b7f-4263"
}

POSTОтправить локацию/maxapi/async/message/location/send

URL: https://wappi.pro/maxapi/async/message/location/send?profile_id={{profile_id}}&timeout_from=1&timeout_to=3&bot_id=1

Описание метода

Отправка геолокации.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`
chat_id	string	Да\*	Идентификатор чата Имеет приоритет над `recipient`.Пример: `"-71254750819698"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
latitude	number	Да	Широта Десятичные градусы. Пример: `55.750446`
longitude	number	Да	Долгота Десятичные градусы. Пример: `37.617494`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

timeout_from1Необязательный параметр. Минимальное время задержки, указывается в секундах

timeout_to3Необязательный параметр. Максимальное время задержки, указывается в секундах

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "recipient": "79815432736",
  "chat_id": "-71254750819698",
  "user_id": 5372559,
  "latitude": 55.750446,
  "longitude": 37.617494,
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить локацию200

{
  "status": "done",
  "timestamp": 1772790651,
  "time": "2026-03-06T12:50:51+03:00",
  "detail": "Message sent to queue",
  "task_id": "5a05289bf1fa6d7455d26782fe3ffac9",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": ""
}

POSTОтправить контакт/maxapi/async/contact/send

URL: https://wappi.pro/maxapi/async/contact/send?profile_id={{profile_id}}&timeout_from=1&timeout_to=3&bot_id=1

Описание метода

Отправка контакта.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
phone	string	Да	Номер телефона передаваемого контакта Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Примеры: `"79115556677"`
name	string	Нет	Имя контакта, которое будет отображаться у получателя. Пример: `"Имя контакта"`
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Примеры: "79115556677"
chat_id	string	Да\*	Идентификатор чата для отправки контакта. Имеет приоритет над `recipient`.Пример: `"71219698"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

timeout_from1Необязательный параметр. Минимальное время задержки, указывается в секундах

timeout_to3Необязательный параметр. Максимальное время задержки, указывается в секундах

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "phone": "79632341981",
  "recipient": "79839487565",
  "chat_id": "-71254750819698",
  "user_id": 5372559,
  "name": "Имя контакта",
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Отправить контакт200

{
  "status": "done",
  "timestamp": 1772790724,
  "time": "2026-03-06T12:52:04+03:00",
  "detail": "Message sent to queue",
  "task_id": "17cfd63dc3584bbe8910d960626bb9db",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": ""
}

POSTПереслать сообщение/maxapi/async/message/forward

URL: https://wappi.pro/maxapi/async/message/forward?profile_id={{profile_id}}&timeout_from=1&timeout_to=3&bot_id=1

Описание метода

Метод позволяет переслать ранее полученное или отправленное сообщение другому получателю.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
message_id	string	Да	Идентификатор сообщения, которое необходимо переслать.Пример: `"116097585839898064"`
recipient	string	Да\*	Номер получателя сообщения. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`
chat_id	string	Да\*	Идентификатор чата. Используется для отправки сообщения в существующий чат. Имеет приоритет над `recipient`.Пример: `"-2125475081969"`
user_id	number	Да\*	Идентификатор существующего пользователя. Имеет приоритет над `chat_id`. Идентификатор пользователя можно получить из ответов методов (например `contact.id` в методе "Получить контакт") или вебхуков (например `contact_max_user_id` в вебхуке с типом `outgoing_message_api`). Пример: `5372054`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

timeout_from1Необязательный параметр. Минимальное время задержки, указывается в секундах

timeout_to3Необязательный параметр. Максимальное время задержки, указывается в секундах

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "message_id": "116136317123974440",
  "recipient": "79602432312",
  "chat_id": "-71254750819698",
  "user_id": 5372559,
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Переслать сообщение200

{
  "status": "done",
  "timestamp": 1772790862,
  "time": "2026-03-06T12:54:22+03:00",
  "detail": "Message sent to queue",
  "task_id": "41c6ca3d5a770ccab8ea599026ea1aec",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": ""
}

POSTОтветить на сообщение/maxapi/async/message/reply

URL: https://wappi.pro/maxapi/async/message/reply?profile_id={{profile_id}}&timeout_from=1&timeout_to=3&bot_id=18383820

Описание метода

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
body	string	Да\*	Текст ответа. Пример: `"тестовый ответ на сообщение"`
message_id	string	Да	Идентификатор сообщения, на которое отправляется ответ.Пример: `"114998436624933775"`
url	string	Да\*	Прямая ссылка на файл для отправки вместе с ответом. Если поле отсутствует, отправляется только текст. Пример: `"https://example.com/file.jpg"`
manager	object	Нет	Объект с информацией о менеджере, от имени которого отправляется сообщение.
manager.id	string	Нет	Идентификатор менеджера. Пример: `"38200203"`
manager.name	string	Нет	Имя менеджера. Пример: `"Светлана"`
manager.ava_link	string	Нет	Ссылка на аватар менеджера. Пример: `"https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"`
manager.description	string	Нет	Описание. Любая необходимая дополнительная информация

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

timeout_from1Необязательный параметр. Минимальное время задержки, указывается в секундах

timeout_to3Необязательный параметр. Максимальное время задержки, указывается в секундах

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "body": "тестовый ответ на сообщение",
  "message_id": "116136317123974440",
  "url": "https://img.freepik.com/free-photo/cute-kitten-sitting-staring-playful-fluffy-looking-camera-generated-by-artificial-intelligence_188544-113029.jpg?semt=ais_hybrid&w=740",
  "manager": {
    "name": "Светлана",
    "id": "38200203",
    "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
    "description": "описание пример"
  }
}

Responses

Ответить на сообщение200

{
  "status": "done",
  "timestamp": 1772790904,
  "time": "2026-03-06T12:55:04+03:00",
  "detail": "Message sent to queue",
  "task_id": "2e56b189ec916b62826cb38fe627eb30",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": ""
}

Работа с чатами4 метода

POSTПолучить список чатов/maxapi/sync/chats/get

URL: https://wappi.pro/maxapi/sync/chats/get?profile_id={{profile_id}}&limit=3&show_all=false&offset=0&order=desc

Описание метода

Получение списка всех чатов в подключенном аккаунте Max.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

limit3Необязательный параметр. Количество чатов для получения. Если не указывать, то по умолчанию установлено значение 200.

show_allfalseНеобязательный параметр. Позволяет получить все чаты. Значение может быть true или false. Если не указывать параметр, то по умолчанию false.

offset0Необязательный параметр. Определяет от какого по счету элемента вывести список чатов, где 0 это самый новый чат. Если не указывать, то по умолчанию установлено значение 0.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить список чатов200

{
  "status": "done",
  "timestamp": 1772312897,
  "time": "2026-03-01T00:08:17+03:00",
  "detail": "Chats fetched",
  "task_id": "",
  "command_start": "2026-03-01T00:08:17.284441794+03:00",
  "command_end": "2026-03-01T00:08:17.297524576+03:00",
  "uuid": "15396b7f-4263",
  "dialogs": [
    {
      "id": "205160429",
      "type": "DIALOG",
      "isGroup": false,
      "image": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NotN-9L5XE70IkEJTdjoKLx3h3lgMsSZV0bvElZIkv3kBQ",
      "thumbnail": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NotN-9L5XE70IkEJTdjoKLx3h3lgMsSZV0bvElZIkv3kBQ",
      "avatar_updated_at": 0,
      "last_message_delivery_status": "",
      "last_message_id": "116148674465001269",
      "last_timestamp": 1772288123550,
      "last_message_type": "text",
      "last_message_sender": {
        "id": "",
        "number": "",
        "pushname": "",
        "isMe": false
      },
      "last_message_data": "📎 Вложение",
      "name": "Анна",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "item_name": "",
      "item_link": "",
      "is_wappi_pinned": false,
      "participants": [
        {
          "user_id": "15349106",
          "is_admin": true,
          "is_creator": true,
          "name": "",
          "username": "",
          "phone": "",
          "is_bot": false,
          "is_me": true,
          "inviter_id": "",
          "invite_timestamp": 1772288123549
        },
        {
          "user_id": "214977183",
          "is_admin": false,
          "is_creator": false,
          "name": "",
          "username": "",
          "phone": "",
          "is_bot": false,
          "is_me": false,
          "inviter_id": "",
          "invite_timestamp": 0
        }
      ],
      "phone": "79116265432",
      "manager": {
        "id": "",
        "name": "",
        "ava_link": "",
        "description": ""
      }
    }
  ],
  "total_count": 53
}

GETПолучить список чатов с фильтром/maxapi/sync/chats/filter

URL: https://wappi.pro/maxapi/sync/chats/filter?profile_id={{profile_id}}&client_name=7960

Описание метода

Получение списка чатов в подключенном аккаунте MAX с применением фильтра. В параметре _client_name_ можно указать часть номера или слова для фильтрации по номеру телефона, имени чата и последнему сообщению.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

client_name7960Необязательный параметр. Можно указать часть номера или слова для фильтрации по номеру телефона, имени чата и последнему сообщению чата.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

Тело запроса не передается.

Responses

Получить список чатов с фильтром200

{
  "status": "done",
  "timestamp": 1773649423,
  "time": "2026-03-16T11:23:43+03:00",
  "detail": "Chats fetched",
  "task_id": "",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": "",
  "dialogs": [
    {
      "id": "224449775",
      "type": "DIALOG",
      "isGroup": false,
      "image": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NottOVnIJkY9NIc-al2fTUZvB3lgMsSZV0bvElZIkv3kBQ",
      "thumbnail": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NottOVnIJkY9NIc-al2fTUZvB3lgMsSZV0bvElZIkv3kBQ",
      "avatar_updated_at": 0,
      "last_message_delivery_status": "",
      "last_message_id": "116234258672414517",
      "last_timestamp": 1773594034918,
      "last_message_type": "text",
      "last_message_sender": {
        "id": "",
        "number": "",
        "pushname": "",
        "isMe": false
      },
      "last_message_data": "📎 Вложение",
      "name": "Антикошка сетки на окна",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "item_name": "",
      "item_link": "",
      "is_wappi_pinned": false,
      "participants": [
        {
          "user_id": "15349106",
          "is_admin": true,
          "is_creator": true,
          "name": "",
          "username": "",
          "phone": "",
          "is_bot": false,
          "is_me": true,
          "inviter_id": "",
          "invite_timestamp": 1773594034917
        },
        {
          "user_id": "227205533",
          "is_admin": false,
          "is_creator": false,
          "name": "Антикошка сетки на окна",
          "username": "",
          "phone": "79156736464",
          "is_bot": false,
          "is_me": false,
          "inviter_id": "",
          "invite_timestamp": 0
        }
      ],
      "phone": "79156736464",
      "manager": {
        "id": "",
        "name": "",
        "ava_link": "",
        "description": ""
      }
    }
  ],
  "total_count": 1
}

GETПолучить список чатов по дням/maxapi/sync/chats/days/get

URL: https://wappi.pro/maxapi/sync/chats/days/get?profile_id={{profile_id}}&offset=0&limit=7&order=desc&is_archived=true&is_deleted=true

Описание метода

Получение списка всех чатов в подключенном аккаунте MAX с использованием фильтрации по количеству дней в выборке, которое указывается в параметре limit. Если не указывать, то по умолчанию установлено значение 20.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

offset0Необязательный параметр. Отступ от текущего момента в днях. Если не указывать, то по умолчанию установлено значение 0.

limit7Необязательный параметр. Количество дней в выборке. Если не указывать, то по умолчанию установлено значение 20.

orderdescНеобязательный параметр. Сортировка. Возможные варианты asc и desc. По умолчанию desc

is_archivedtrueНеобязательный параметр. Фильтр по архивным чатам. Возможные значения true и false. По умолчанию false.

is_deletedtrueНеобязательный параметр. Фильтр по удаленным чатам. Возможные значения true и false. По умолчанию false.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

Тело запроса не передается.

Responses

Получить список чатов по дням200

{
  "status": "done",
  "timestamp": 1773734860,
  "time": "2026-03-17T11:07:40+03:00",
  "detail": "Chats fetched",
  "task_id": "",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "0001-01-01T00:00:00Z",
  "uuid": "",
  "dialogs": [
    {
      "id": "223439692",
      "type": "DIALOG",
      "isGroup": false,
      "image": "",
      "thumbnail": "",
      "avatar_updated_at": 0,
      "last_message_delivery_status": "",
      "last_message_id": "116242873116553013",
      "last_timestamp": 1773725480904,
      "last_message_type": "system",
      "last_message_sender": {
        "id": "",
        "number": "",
        "pushname": "",
        "isMe": false
      },
      "last_message_data": "Теперь в MAX!",
      "name": "Юлия Борисовна",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "item_name": "",
      "item_link": "",
      "is_wappi_pinned": false,
      "participants": [
        {
          "user_id": "15349106",
          "is_admin": true,
          "is_creator": true,
          "name": "",
          "username": "",
          "phone": "",
          "is_bot": false,
          "is_me": true,
          "inviter_id": "",
          "invite_timestamp": 1773725480903
        },
        {
          "user_id": "230383166",
          "is_admin": false,
          "is_creator": false,
          "name": "Юлия Борисовна",
          "username": "",
          "phone": "79817902510",
          "is_bot": false,
          "is_me": false,
          "inviter_id": "",
          "invite_timestamp": 0
        }
      ],
      "phone": "79817902510",
      "manager": {
        "id": "",
        "name": "",
        "ava_link": "",
        "description": ""
      }
    },
    {
      "id": "224449775",
      "type": "DIALOG",
      "isGroup": false,
      "image": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NottOVnIJkY9NIc-al2fTUZvB3lgMsSZV0bvElZIkv3kBQ",
      "thumbnail": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NottOVnIJkY9NIc-al2fTUZvB3lgMsSZV0bvElZIkv3kBQ",
      "avatar_updated_at": 0,
      "last_message_delivery_status": "",
      "last_message_id": "116234258672414517",
      "last_timestamp": 1773594034918,
      "last_message_type": "text",
      "last_message_sender": {
        "id": "",
        "number": "",
        "pushname": "",
        "isMe": false
      },
      "last_message_data": "📎 Вложение",
      "name": "Антикошка",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "item_name": "",
      "item_link": "",
      "is_wappi_pinned": false,
      "participants": [
        {
          "user_id": "15349106",
          "is_admin": true,
          "is_creator": true,
          "name": "",
          "username": "",
          "phone": "",
          "is_bot": false,
          "is_me": true,
          "inviter_id": "",
          "invite_timestamp": 1773648308479
        },
        {
          "user_id": "227205533",
          "is_admin": false,
          "is_creator": false,
          "name": "Антикошка",
          "username": "",
          "phone": "79156734943",
          "is_bot": false,
          "is_me": false,
          "inviter_id": "",
          "invite_timestamp": 0
        }
      ],
      "phone": "79156734943",
      "manager": {
        "id": "",
        "name": "",
        "ava_link": "",
        "description": ""
      }
    }
  ],
  "total_count": 2
}

POSTУстановить статус "печатает"/maxapi/sync/chats/typing/start

URL: https://wappi.pro/maxapi/sync/chats/typing/start?profile_id={{profile_id}}

Описание метода

Метод позволяет установить статус "печатает".

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "recipient": "7911555222333"
}

Работа с контактами4 метода

GETПолучить контакты/maxapi/sync/contacts/get

URL: https://wappi.pro/maxapi/sync/contacts/get?profile_id={{profile_id}}

Описание метода

Получение всех контактов авторизованного номера Max.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить контакты200

{
  "status": "done",
  "timestamp": 1772304896,
  "time": "2026-02-28T21:54:56+03:00",
  "detail": "Successfully retrieved contacts",
  "task_id": "e1355488ae7ebbb20b59624090291beb",
  "command_start": "2026-02-28T21:54:56.319915879+03:00",
  "command_end": "2026-02-28T21:54:56.206904089+03:00",
  "uuid": "15396b7f-4263",
  "contacts": [
    {
      "id": 40081123,
      "accountStatus": 0,
      "names": [
        {
          "name": "Унаватуна 1",
          "firstName": "Унаватуна 1",
          "lastName": "",
          "type": "CUSTOM"
        },
        {
          "name": "Настя",
          "firstName": "Настя",
          "lastName": "",
          "type": "ONEME"
        }
      ],
      "phone": 79126573920,
      "options": [
        "TT",
        "ONEME"
      ],
      "updateTime": 1755888050835,
      "photoId": 85119203,
      "baseUrl": "https://i.oneme.ru/i?r=BUGhUou04b028GIQiF8sPj1ESMoEpchxha3Avo_VQzzdaWxqEPk3UdFqZT8kwdtrVi7FGqBwvU1WTQQJEfXzc7SX",
      "baseRawUrl": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NotjvmjQrOeHcDXKj3jiosM2x3lgMsSZV0bvElZIkv3kBQ"
    }
  ]
}

GETПолучить контакт/maxapi/sync/contact/get

URL: https://wappi.pro/maxapi/sync/contact/get?recipient=123456789&phone=79915576368&profile_id={{profile_id}}

Описание метода

Получение данных конкретного контакта.

Query Params

ПараметрЗначениеОписание

recipient123456789Обязательный параметр (если не указан номер телефона в phone). Айди контакта.

phone79915576368Обязательный параметр (если не указан айди контакта в recipient). Номер телефона должен начинаться с кода страны. Для России и Казахстана это всегда 7, затем 10 цифр.

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить контакт200

{
  "status": "done",
  "timestamp": 1772305117,
  "time": "2026-02-28T21:58:37+03:00",
  "detail": "Successfully retrieved contacts",
  "task_id": "3c3fcd6114b5881197d1aa517a3b71d3",
  "command_start": "2026-02-28T21:58:37.658184469+03:00",
  "command_end": "2026-02-28T21:58:37.54297263+03:00",
  "uuid": "15396b7f-4263",
  "contact": {
    "id": 5372069,
    "accountStatus": 0,
    "names": [
      {
        "name": "Сережа",
        "firstName": "Сережа",
        "lastName": "Варгунов",
        "type": "CUSTOM"
      },
      {
        "name": "Serg",
        "firstName": "Serg",
        "lastName": "",
        "type": "ONEME"
      }
    ],
    "phone": 79816593725,
    "options": [
      "TT",
      "ONEME"
    ],
    "updateTime": 1759659756900,
    "photoId": 371346597,
    "baseUrl": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NotX6aHGN_-uJI_EY4Wei407B3lgMsSZV0bvElZIkv3kBQ",
    "baseRawUrl": "https://i.oneme.ru/i?r=BTE2sh_eZW7g8kugOdIm2NotX6aHGN_-uJI_EY4Wei407B3lgMsSZV0bvElZIkv3kBQ"
  },
  "chat_id": "12312227"
}

POSTДобавить контакт/maxapi/sync/contact/add

URL: https://wappi.pro/maxapi/sync/contact/add?profile_id={{profile_id}}

Описание метода

Добавить номер в свои контакты.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
phone	string	Да	Номер телефона контакта. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами).Пример: `"79082257537"`
name	string	Да	Имя контакта. Пример: `"Сударушка"`
last_name	string	Нет	Фамилия контакта. Пример: `"Кафе"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "phone": "79082257537",
  "name": "Сударушка-2",
  "last_name": "Кафе"
}

Responses

Добавить контакт200

{
  "status": "done",
  "timestamp": 1772439569,
  "time": "2026-03-02T11:19:29+03:00",
  "detail": "Contact added successfully",
  "task_id": "576659188d79116d3b8d77cbfbfad43a",
  "command_start": "2026-03-02T11:19:29.176807608+03:00",
  "command_end": "2026-03-02T11:19:29.223723488+03:00",
  "uuid": "15396b7f-4263",
  "contact": {
    "id": 32441031,
    "accountStatus": 0,
    "names": [
      {
        "name": "",
        "firstName": "Сударушка",
        "lastName": "Кафе",
        "type": "CUSTOM"
      },
      {
        "name": "",
        "firstName": "Svetik",
        "lastName": "",
        "type": "ONEME"
      }
    ],
    "phone": 79082256453,
    "options": null,
    "updateTime": 0
  },
  "chat_id": "17119157"
}

GETПроверить зарегистрирован ли номер/maxapi/sync/contact/check

URL: https://wappi.pro/maxapi/sync/contact/check?profile_id={{profile_id}}&phone=79602041980&user_id=5353720

Описание метода

Проверка зарегистрирован ли номер в Max.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

phone79602041980Условно обязательный параметр (обязателен, если не указан user_id. Если указаны оба приоритет у user_id). Номер телефона для проверки

user_id5353720Условно обязательный параметр (обязателен, если не указан phone. Если указаны оба приоритет у user_id). Идентификатор пользователя для проверки

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Проверить зарегистрирован ли номер200

{
  "status": "done",
  "timestamp": 1777368007,
  "time": "2026-04-28T12:20:07+03:00",
  "detail": "not found",
  "task_id": "",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-04-28T12:20:07.552775817+03:00",
  "uuid": "15396b7f-4263",
  "phone": "79118726262",
  "on_max": false,
  "chat_id": "",
  "user_id": 0
}

Работа с webhook (уведомлениями)4 метода

GETПолучить ссылку на webhook/maxapi/webhook/url/get

URL: https://wappi.pro/maxapi/webhook/url/get?profile_id={{profile_id}}

Описание метода

Получение ссылки на webhook, которая установлена для данного профиля.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить ссылку на webhook200

{
  "detail": "WebHook установлен на адрес https://webhook.site/a7cae568",
  "status": "done",
  "url": "https://webhook.site/a7cae568",
  "auth": "",
  "installed": true
}

POSTУстановить ссылку на webhook/maxapi/webhook/url/set

URL: https://wappi.pro/maxapi/webhook/url/set?profile_id={{profile_id}}&url=https://webhook.site/4c0822de-d95b-49e4-a44f-7832b15f7505&auth=34hlaksduoiyurtxm

Описание метода

Установка ссылки на webhook.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

urlhttps://webhook.site/4c0822de-d95b-49e4-a44f-7832b15f7505Обязательный параметр. URL ссылки на вебхук.

auth34hlaksduoiyurtxmНеобязательный параметр. Авторизация в вебхуке

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Установить ссылку на webhook200

{
  "status": "done",
  "timestamp": 1772440382,
  "time": "2026-03-02T11:33:02+03:00",
  "detail": "webhook url: https://webhook.site/4c0822de-d95b-49e4-a44f-7832b15f7505",
  "task_id": "eb084391-6a1c-487e-bb6f-ab4b112d3b93",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-03-02T11:33:02.388438365+03:00",
  "uuid": "15396b7f-4263"
}

POSTУдалить ссылку на webhook/maxapi/webhook/url/delete

URL: https://wappi.pro/maxapi/webhook/url/delete?profile_id={{profile_id}}

Описание метода

Удаление ссылки на webhook.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Удалить ссылку на webhook200

{
  "status": "done",
  "timestamp": 1772440477,
  "time": "2026-03-02T11:34:37+03:00",
  "detail": "webhook was deleted",
  "task_id": "2788f4b4-cc6d-43c5-951a-4f62cf363ba8",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-03-02T11:34:37.282008039+03:00",
  "uuid": "15396b7f-4263"
}

POSTНастройка типов webhook уведомлений/maxapi/webhook/types/set

URL: https://wappi.pro/maxapi/webhook/types/set?profile_id={{profile_id}}

Описание метода

Метод позволяет задать список типов webhook-уведомлений, которые будут отправляться для профиля. При повторном вызове метода список типов полностью перезаписывается.

Request Body

Тип данных	Обяз.	Описание
array\[string\]	Да	Массив типов webhook-уведомлений, которые необходимо получать.\*

Типы webhook'ов**:

Тип	Описание
authorization_status	Статусы авторизации профиля (online, offline).
incoming_message	Все входящие сообщения.
delivery_status	Статусы доставки отправленных сообщений (pending, delivered, read).
outgoing_message_api	Исходящие сообщения, отправленные через API.
outgoing_message_phone	Исходящие сообщения, отправленные с телефона.
application_status	Статусы авторизации приложения (online, offline).

\*Если тип webhook не указан в массиве — уведомления данного типа отправляться не будут.

**По умолчанию для каждого нового профиля устанавливаются такие настройки: authorization_status, incoming_message, delivery_status.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

[
  "authorization_status",
  "incoming_message",
  "delivery_status",
  "outgoing_message_phone",
  "outgoing_message_api",
  "application_status"
]

Responses

Настройка типов webhook уведомлений200

{
  "status": "done",
  "timestamp": 1772441238,
  "time": "2026-03-02T11:47:18+03:00",
  "detail": "webhook types: [authorization_status incoming_message delivery_status outgoing_message_phone outgoing_message_api application_status]",
  "task_id": "3785a1d3-fae3-477a-afc7-58b90dd2622c",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-03-02T11:47:18.635713968+03:00",
  "uuid": "15396b7f-4263"
}

Работа с группами12 методов

POSTСоздать группу/maxapi/sync/group/create

URL: https://wappi.pro/maxapi/sync/group/create?profile_id={{profile_id}}

Описание метода

Метод создаёт новую группу от имени указанного профиля и приглашает в неё участников.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
name	string	Да	Название создаваемой группы. Пример: `"Тестовая группа"`
participants	array\[string\]	Да	Массив номеров телефонов участников группы. Допускаются различные форматы записи номера (со знаком `+`, пробелами, скобками, дефисами). Пример: `["79116294181", "79217304491"]` Указывается как минимум один участник группы.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "name": "Тестовая группа",
  "participants": [
    "79815437282",
    "79826543232"
  ]
}

Responses

Создать группу200

{
  "status": "done",
  "timestamp": 1771059859,
  "time": "2026-02-14T12:04:19+03:00",
  "detail": "Group created successfully: -71096128746917",
  "task_id": "e4560797a21f71ca62c7abfd9363a6dc",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-14T12:04:19.02964634+03:00",
  "uuid": "75a40704-162c"
}

POSTПокинуть группу/maxapi/sync/group/leave

URL: https://wappi.pro/maxapi/sync/group/leave?profile_id={{profile_id}}&group_id=-71592520742258

Описание метода

Метод позволяет профилю выйти из группы. Если профиль является владельцем группы, перед выходом необходимо передать права владельца другому участнику с помощью метода передачи владения группой.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

group_id-71592520742258Обязательный параметр. Указывается id группы, из которой надо выйти.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Покинуть группу200

{
  "status": "done",
  "timestamp": 1771589151,
  "time": "2026-02-20T15:05:51+03:00",
  "detail": "Left group successfully",
  "task_id": "73505e1a8ac6aa24de385f6b4dda29df",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-20T15:05:51.480868752+03:00",
  "uuid": "75a40704-162c"
}

POSTДобавить участника в группу/maxapi/sync/group/participant/add

URL: https://wappi.pro/maxapi/sync/group/participant/add?profile_id={{profile_id}}

Описание метода

Метод позволяет добавить одного или нескольких участников в существующую группу.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
group_id	string	Да	Идентификатор группы.Пример: `"-71592477554034"`
participants	array\[string\]	Да	Массив номеров телефонов участников, которых необходимо добавить в группу. Допускаются различные форматы записи номера.Пример: `["79816253736"]`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-71592477554034",
  "participants": [
    "79816253736"
  ]
}

Responses

Добавить участника в группу200

{
  "status": "done",
  "timestamp": 1771160176,
  "time": "2026-02-15T15:56:16+03:00",
  "detail": "Added 1 participants successfully",
  "task_id": "47b89e20c82ffa0edcfb145ecde17c59",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-15T15:56:16.244467341+03:00",
  "uuid": "75a40704-162c"
}

POSTУдалить участника из группы/maxapi/sync/group/participant/remove

URL: https://wappi.pro/maxapi/sync/group/participant/remove?profile_id={{profile_id}}

Описание метода

Метод позволяет удалить участника из группы.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
group_id	string	Да	Идентификатор группы.Пример: `"-71132569253285"`
participant	string	Да	Номер телефона участника, которого необходимо удалить из группы.Пример: `"79211940220"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-71592477554034",
  "participant": "798152463774"
}

Responses

Удалить участника из группы200

{
  "status": "done",
  "timestamp": 1771588542,
  "time": "2026-02-20T14:55:42+03:00",
  "detail": "Removed 1 participants successfully",
  "task_id": "c3c68c8bc846a89a29bf7d6d4609fbe0",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-20T14:55:42.442727327+03:00",
  "uuid": "75a40704-162c"
}

POSTДобавить контакту права администратора/maxapi/sync/group/admin/promote

URL: https://wappi.pro/maxapi/sync/group/admin/promote?profile_id={{profile_id}}

Описание метода

Метод позволяет назначить участника группы администратором.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
group_id	string	Да	Идентификатор группы.Пример: `"-71592477554034"`
participant	string	Да	Номер телефона участника, которому назначаются права администратора.Пример: `"79115576367"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-71592477554034",
  "participant": "798173645252"
}

Responses

Добавить контакту права администратора200

{
  "status": "done",
  "timestamp": 1771160701,
  "time": "2026-02-15T16:05:01+03:00",
  "detail": "Promoted 1 participants successfully",
  "task_id": "f77113ea7a2baa3a916d1f8d56352dfa",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-15T16:05:01.856033096+03:00",
  "uuid": "75a40704-162c"
}

POSTУбрать у контакта права администратора/maxapi/sync/group/admin/demote

URL: https://wappi.pro/maxapi/sync/group/admin/demote?profile_id={{profile_id}}

Описание метода

Метод позволяет снять права администратора у участника группы.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
group_id	string	Да	Идентификатор группы.Пример: `"-71132569253285"`
participant	string	Да	Номер телефона участника, у которого необходимо снять права администратора.Пример: `"79115576361"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-71592477554034",
  "participant": "79816253434"
}

Responses

Убрать у контакта права администратора200

{
  "status": "done",
  "timestamp": 1771160808,
  "time": "2026-02-15T16:06:48+03:00",
  "detail": "Demoted 1 participants successfully",
  "task_id": "f90b5b32056dc121c74dbe51ae08ddf1",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-15T16:06:48.546611539+03:00",
  "uuid": "75a40704-162c"
}

POSTУстановить описание группы/maxapi/sync/group/description/set

URL: https://wappi.pro/maxapi/sync/group/description/set?profile_id={{profile_id}}

Описание метода

Метод позволяет установить или изменить описание группы.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
group_id	string	Да	Идентификатор группы.Пример: `"-71132569253285"`
description	string	Да	Новое описание группы.Пример: `"Тестовое описание группы"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-71592477554034",
  "description": "Тестовое описание группы"
}

Responses

Установить описание группы200

{
  "status": "done",
  "timestamp": 1771160468,
  "time": "2026-02-15T16:01:08+03:00",
  "detail": "Group description set successfully",
  "task_id": "41a4a3424e437482bb7c76bacecc24ed",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-15T16:01:08.803828084+03:00",
  "uuid": "75a40704-162c"
}

POSTУстановить имя группы/maxapi/sync/group/name/set

URL: https://wappi.pro/maxapi/sync/group/name/set?profile_id={{profile_id}}

Описание метода

Метод позволяет изменить название существующей группы.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
group_id	string	Да	Идентификатор группы.Пример: `"-71592477554034"`
name	string	Да	Новое название группы.Пример: `"Тестовое имя группы"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-71592477554034",
  "name": "Тестовое имя группы"
}

Responses

Установить имя группы200

{
  "status": "done",
  "timestamp": 1771588227,
  "time": "2026-02-20T14:50:27+03:00",
  "detail": "Group name set successfully",
  "task_id": "46dab302b56e2daf6d62df2989f84c3a",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-20T14:50:27.075454925+03:00",
  "uuid": "75a40704-162c"
}

POSTУстановить аватарку группы/maxapi/sync/group/avatar/set

URL: https://wappi.pro/maxapi/sync/group/avatar/set?profile_id={{profile_id}}

Описание метода

Метод позволяет установить/изменить аватар существующей группы.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-120363166535391471",
  "url": "ehk"
}

POSTПередать права на группу другому юзеру/maxapi/sync/group/ownership/transfer

URL: https://wappi.pro/maxapi/sync/group/ownership/transfer?profile_id={{profile_id}}

Описание метода

Метод позволяет передать права владения группой другому участнику.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
group_id	string	Да	Идентификатор группы. Пример: `"-71592520742258"`
participant	string	Да	Номер телефона участника группы, которому передаются права владельца. Пример: `"79816253736"`

Метод может быть вызван только текущим владельцем группы. Указанный participant должен быть участником группы. После успешного выполнения права владельца переходят указанному участнику

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-71592520742258",
  "participant": "79816253736"
}

Responses

Передать права на группу другому юзеру200

{
  "status": "done",
  "timestamp": 1771589099,
  "time": "2026-02-20T15:04:59+03:00",
  "detail": "Ownership transferred successfully",
  "task_id": "8367d8511e0bacf83dbdf23bbf2130ae",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-02-20T15:04:59.418645695+03:00",
  "uuid": "75a40704-162c"
}

POSTОтправить invite-ссылку группы/maxapi/sync/group/invitelink/send

URL: https://wappi.pro/maxapi/sync/group/invitelink/send?profile_id={{profile_id}}

Описание метода

Получает актуальную invite-ссылку группы MAX с устройства и отправляет её обычным сообщением получателю.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
group_id	string	Да	Идентификатор группы.Пример: `"-71592477554034"`
recipient	string	Да	Получатель сообщения. Может быть передан как номер телефона или идентификатор чата. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: `"79115556677"`

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

{
  "group_id": "-76668806002034",
  "recipient": "79110000000"
}

GETПолучить invite-ссылку группы/maxapi/sync/group/invitelink/get

URL: https://wappi.pro/maxapi/sync/group/invitelink/get?profile_id={{profile_id}}&group_id=-76668806002034

Описание метода

Метод позволяет получить актуальную invite-ссылку группы MAX с устройства по group_id.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

group_id-76668806002034Обязательный параметр. Идентификатор группы.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить invite-ссылку группы200

{
  "status": "done",
  "timestamp": 1783440739,
  "time": "2026-07-07T19:12:19+03:00",
  "detail": "https://max.ru/u/f9LHodD0cOJyJJfwwJ5lpzJc2VX-gIYs0nv4jaJOpuK7hTAUx35m5DKODPU",
  "task_id": "913024f2e90ddeea26e24fed3fad956a",
  "command_start": "0001-01-01T00:00:00Z",
  "command_end": "2026-07-07T19:12:19.504337013+03:00",
  "uuid": "15396b7f-4263"
}

Работа с очередью2 метода

GETПолучить данные по задаче/maxapi/task/get

URL: https://wappi.pro/maxapi/task/get?profile_id={{profile_id}}&task_id=e90c9626-d9d6-407a-a860-a75d93f32aa2

Описание метода

Получение данных по конкретной задаче.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

task_ide90c9626-d9d6-407a-a860-a75d93f32aa2Обязательный параметр. Task_id можно получить в ответах в методах по отправке сообщений.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить данные по задаче200

{
  "status": "done",
  "task": {
    "task_id": "3785a1d3-fae3-477a-afc7-58b90dd2622c",
    "command_start": "0001-01-01T00:00:00Z",
    "uuid": "15396b7f-4263",
    "response": {
      "status": "done",
      "timestamp": 1772441238,
      "time": "2026-03-02T11:47:18+03:00",
      "detail": "webhook types: [authorization_status incoming_message delivery_status outgoing_message_phone outgoing_message_api application_status]",
      "task_id": "3785a1d3-fae3-477a-afc7-58b90dd2622c",
      "command_start": "0001-01-01T00:00:00Z",
      "command_end": "2026-03-02T08:47:18.635Z",
      "uuid": "15396b7f-4263",
      "delivery_status": "error"
    },
    "filter": {}
  }
}

GETПолучить данные по всем задачам/maxapi/tasks/get

URL: https://wappi.pro/maxapi/tasks/get?profile_id={{profile_id}}&limit=2&offset=0

Описание метода

Получение данных по всем задачам.

Query Params

ПараметрЗначениеОписание

profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

limit2Необязательный параметр. Количество задач для получения.

offset0Необязательный параметр. Определяет от какого по счету элемента вывести список задач, где 0 это самая новая задача. Если не указывать, то по умолчанию установлено значение 0.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Responses

Получить данные по всем задачам200

{
  "status": "done",
  "tasks": [
    {
      "task_id": "9ff09c9a5dd7e24102f80eb860e5a429",
      "command_start": "2026-03-02T08:14:40.489Z",
      "command": "sendMessage",
      "recipient": "79602763846",
      "uuid": "15396b7f-4263",
      "body": "Привет! Как ты? Что нового?",
      "response": {
        "status": "done",
        "timestamp": 1772439280,
        "time": "2026-03-02T11:14:40+03:00",
        "detail": "Message sent successfully",
        "task_id": "9ff09c9a5dd7e24102f80eb860e5a429",
        "command_start": "2026-03-02T08:14:40.489Z",
        "command_end": "2026-03-02T08:14:40.334Z",
        "uuid": "15396b7f-4263",
        "message_id": "116158580677630247",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "18383820",
      "manager": {
        "id": "38200203",
        "name": "Светлана",
        "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
        "description": "описание пример"
      },
      "chat_id": "-71254750819698"
    },
    {
      "task_id": "d9be0aafe2ad1ae191c8d5eeb4408c77",
      "command_start": "2026-03-01T17:16:15.368Z",
      "command": "sendContact",
      "recipient": "79839487565",
      "uuid": "15396b7f-4263",
      "body": "Имя контакта",
      "phone": "79632341981",
      "response": {
        "status": "done",
        "timestamp": 1772385375,
        "time": "2026-03-01T20:16:15+03:00",
        "detail": "Contact sent successfully",
        "task_id": "d9be0aafe2ad1ae191c8d5eeb4408c77",
        "command_start": "2026-03-01T17:16:15.368Z",
        "command_end": "2026-03-01T17:16:15.216Z",
        "uuid": "15396b7f-4263",
        "message_id": "116155047953199354",
        "delivery_status": "pending"
      },
      "filter": {},
      "wappi_bot_id": "1",
      "manager": {
        "id": "38200203",
        "name": "Светлана",
        "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
        "description": "описание пример"
      },
      "chat_id": "-71254750819698",
      "timeout_from": 1,
      "timeout_to": 3
    }
  ]
}

Тестирование методов

Как протестировать методы MAX API

01Получите токен

Откройте личный кабинет и скопируйте API-токен из профиля MAX.

02Передайте profile_id

Добавляйте profile_id в query и Authorization в headers каждого запроса.

03Проверьте метод

Выберите endpoint слева, скопируйте CURL или откройте Postman collection.

04Подключите webhook

Настройте уведомления, чтобы получать статусы и входящие сообщения.

Список методов

Работа с профилем10

Работа с сообщениями19

Синхронные методы13

Асинхронные методы6

Работа с чатами4

Работа с контактами4

Работа с webhook (уведомлениями)4

Работа с группами12

Работа с очередью2

Создать профиль

Работа с профилем

POST

Подробная информацияURL, описание, параметры, headers, тело запроса, responses и CURLСвернутьРазвернуть

POSThttps://wappi.pro/maxapi/profile/add?name=новый3&webhook_url=https://wappi.pro

Описание метода

Метод предназначен для создания нового профиля.

Вы передаете имя нового профиля, а его profile_id автоматически генерируется системой и возвращается в ответе.

Query Params

ПараметрЗначениеОписание

nameновый3Обязательный параметр. Имя нового профиля.

webhook_urlhttps://wappi.proНеобязательный параметр. Установка URL ссылки на вебхук.

Headers

КлючЗначениеОписание

Authorization{{Token}}—

Тело запроса raw

Тело запроса не передается.

Responses

Создать профиль200

{
  "profile_id": "21f018f2-647a",
  "status": "done",
  "time": "2026-03-06T13:03:50+03:00",
  "timestamp": 1772791430
}

Пример CURL запроса

curl --request POST 'https://wappi.pro/maxapi/profile/add?name=новый3&webhook_url=https://wappi.pro' \
    --header 'Authorization: {{Token}}'

Тест запроса

API tokenprofile_id

POSThttps://wappi.pro/maxapi/profile/add?name=%D0%BD%D0%BE%D0%B2%D1%8B%D0%B93&webhook_url=https%3A%2F%2Fwappi.pro

Query Params

Тело запроса

Введите token, чтобы отправить тестовый запрос на https://wappi.pro.

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

01Укажите адрес

Webhook - это URL для событий. Указать его можно в личном кабинете или через API.

02Выберите события

В личном кабинете или через API выберите типы: входящие, доставки, статусы профиля.

03Примите запрос

Ваш сервер должен принять POST-запрос с JSON и быстро вернуть успешный HTTP-ответ.

04Проверьте тестом

Для проверки вставьте временный URL из webhook.site или похожего сервиса.

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, ACCOUNT_SPAM_RESTRICTED, CHECK_PHONE_FLOODWAIT


{
  "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 месяца-5%
6 месяцев-10%
12 месяцев-20%

MAXБазовый

700 ₽

650 ₽~~700 ₽~~

630 ₽~~700 ₽~~

550 ₽~~700 ₽~~

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

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

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

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

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

MAXПолный

1690 ₽

1600 ₽~~1690 ₽~~

1500 ₽~~1690 ₽~~

1350 ₽~~1690 ₽~~

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

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

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

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

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

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

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

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

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

Стать партнером