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

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

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

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

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

Сообщение в WhatsApp можно отправить синхронно или асинхронно: асинхронный метод ставит задачу в очередь и возвращает ID, а синхронный сразу отправляет и отдает результат.

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

Профиль WhatsApp можно авторизовать по номеру телефона или QR-коду.

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

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

API WhatsApp работает на основе протокола WhatsApp WEB и исключает бан. Несмотря на это, стоит быть осторожным с анти-спам системой WhatsApp, подробнее об этом в Вопросах.

Whatsapp MCP сервер

Подключайте Whatsapp API к Claude, ChatGPT и Cursor через MCP сервер Wappi. Ассистент поможет быстрее находить методы, собирать запросы и связывать мессенджер с вашей CRM или сервисом.

Подробнее про MCP >

Коллекция Postman

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

В коллекцию >

Методы

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

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

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

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

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

Метод предназначен для создания нового профиля WhatsApp. Идентификатор нового профиля profile_id генерируется автоматически и возвращается в ответе.

Query Params

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

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

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

Headers

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

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

Responses

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

{
  "profile_id": "91d1a9f5-1eae",
  "status": "done",
  "time": "2026-08-04T13:19:57+03:00",
  "timestamp": 1785838797
}

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

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

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

Метод позволяет удалить указанный профиль WhatsApp. Авторизация при этом тоже удаляется

Query Params

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

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

Headers

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

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

Responses

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

{
  "detail": "Profile 91d1a9f5-1eae deleted",
  "status": "done",
  "time": "2026-08-04T13:23:28+03:00",
  "timestamp": 1785839008
}

GETПолучить QR/api/sync/qr/get

URL: https://wappi.pro/api/sync/qr/get?profile_id={{profile_id}}

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

Метод возвращает QR-код для авторизации профиля WhatsApp в формате base64.

Query Params

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

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

Headers

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

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

Responses

Получить QR200

{
  "status": "done",
  "timestamp": 1786543571,
  "time": "2026-08-12T17:06:11+03:00",
  "event": "code",
  "qrCode": "data:image/png;base64,iVBORw///8AAABVwtNe86h+5OS08AAAAASUVORK5CYII=",
  "task_id": "5d70201232590c9b2c6593845882d931",
  "uuid": "5efde003-d699"
}

GETПолучить код авторизации/api/sync/auth/code

URL: https://wappi.pro/api/sync/auth/code?profile_id={{profile_id}}&phone=79110000000

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

Метод для авторизации в Whatsapp по номеру телефона. Позволяет получить код для авторизации с неавторизованного профиля. Код действителен 160 секунд.

Query Params

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

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

phone79110000000Обязательный параметр. Номер телефона, на который зарегистрирован Whatsapp.

Headers

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

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

Responses

Получить код авторизации200

{
  "status": "done",
  "timestamp": 1786543618,
  "time": "2026-08-12T17:06:58+03:00",
  "code": "JTBA",
  "phone": "",
  "task_id": "ee653061b31741872ad7da07d2fb4a1c",
  "uuid": "5efde003-d699",
  "time_left": 160
}

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

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

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

Метод возвращает текущий статус авторизации и настройки профиля WhatsApp.

Query Params

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

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

Headers

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

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

Responses

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

{
  "app_status": "open",
  "authorized": true,
  "authorized_at": "2026-08-04T13:29:51.133579+03:00",
  "checked_at": "2025-11-27T22:07:05.945678+03:00",
  "last_activity": 0,
  "logouted_at": "2026-08-02T03:34:19.528665+03:00",
  "message_count": 20,
  "name": "testovi4ok",
  "payment_expired_at": "2026-09-03T00:00:00Z",
  "payment_notification": false,
  "phone": "",
  "platform": "wz",
  "profile_id": "5efde003-d699",
  "proxy": "",
  "uuid": "5efde003-d699",
  "webhook_types": [
    "delivery_status",
    "incoming_message",
    "authorization_status",
    "application_status",
    "incoming_call",
    "outgoing_message_api",
    "outgoing_message_phone"
  ],
  "webhook_url": "https://webhook.site/5c4a78d1-9804-4f5e-aaf0-f8d8ba39fdb1",
  "worked_days": 0
}

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

URL: https://wappi.pro/api/profile/all/get?profile_id={{profile_id}}

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

Метод возвращает список профилей WhatsApp и информацию об их текущем состоянии.

Query Params

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

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

Headers

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

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

Responses

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

{
  "profiles": [
    {
      "app_status": "open",
      "proxy": "",
      "profile_id": "a1b2c3d4-e5f6",
      "name": "Основной профиль",
      "webhook_url": "https://example.com/webhook/whatsapp",
      "authorized": true,
      "uuid": "a1b2c3d4-e5f6",
      "is_subscribe": false,
      "checked_at": "2026-08-04T12:30:00+03:00",
      "authorized_at": "2026-08-04T12:00:00+03:00",
      "logouted_at": "2026-08-02T03:30:00+03:00",
      "phone": "79990000001",
      "worked_days": 0,
      "webhook_types": [
        "delivery_status",
        "incoming_message",
        "authorization_status",
        "application_status",
        "incoming_call",
        "outgoing_message_api",
        "outgoing_message_phone"
      ],
      "last_activity": 0,
      "message_count": 20,
      "payment_notification": false,
      "deleted_at": null,
      "platform": "wz"
    },
    {
      "app_status": "close",
      "proxy": "",
      "profile_id": "f6e5d4c3-b2a1",
      "name": "Дополнительный профиль",
      "webhook_url": "",
      "authorized": false,
      "uuid": "f6e5d4c3-b2a1",
      "is_subscribe": false,
      "checked_at": "2026-07-20T12:20:00+03:00",
      "authorized_at": null,
      "logouted_at": null,
      "phone": "",
      "worked_days": 0,
      "webhook_types": [
        "incoming_message",
        "delivery_status",
        "authorization_status"
      ],
      "last_activity": 0,
      "message_count": 0,
      "payment_notification": true,
      "deleted_at": null,
      "platform": "wz"
    }
  ],
  "status": "done"
}

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

URL: https://wappi.pro/api/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Выйти из whatsapp/api/profile/logout

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

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

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

Query Params

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

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

Headers

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

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

Responses

Выйти из whatsapp200

{
  "status": "done",
  "timestamp": 1786543553,
  "time": "2026-08-12T17:05:53+03:00",
  "detail": "ok! You are logouted",
  "task_id": "fbd30896fc54b2279fa2d8a9b12f5a24",
  "uuid": "5efde003-d699"
}

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 of string	Нет	Массив ID дополнительных профилей для оплаты Если указаны, оплата применяется ко всем профилям из profile_uuid и profile_ids.
`code`	string	Нет	Промо-код на скидку

Headers

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

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

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

{
  "profile_uuid": "5efde003-d699",
  "tariff_id": 1,
  "profile_ids": [
    "uuid",
    "uuid2"
  ],
  "code": "promo_code"
}

Responses

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

/dashboard/5efde003-d699

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

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

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

Метод возвращает историю авторизаций и выходов из указанного профиля WhatsApp.

Query Params

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

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

Headers

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

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

Responses

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

{
  "auth_history": [
    {
      "type": "login",
      "phone": "79990000001",
      "created_at": "2026-08-04T13:29:50.168972+03:00",
      "reason": ""
    },
    {
      "type": "logout",
      "phone": "",
      "created_at": "2026-08-02T03:34:19.521480+03:00",
      "reason": ""
    },
    {
      "type": "login",
      "phone": "79990000001",
      "created_at": "2026-07-16T17:04:04.775653+03:00",
      "reason": ""
    },
    {
      "type": "logout",
      "phone": "",
      "created_at": "2026-07-15T11:29:37.871261+03:00",
      "reason": ""
    },
    {
      "type": "login",
      "phone": "79990000001",
      "created_at": "2026-07-13T12:07:54.065273+03:00",
      "reason": ""
    },
    {
      "type": "logout",
      "phone": "",
      "created_at": "2025-12-05T16:31:44.674037+03:00",
      "reason": "logout"
    },
    {
      "type": "login",
      "phone": "79990000002",
      "created_at": "2025-12-05T15:23:00.701214+03:00",
      "reason": ""
    }
  ],
  "status": "done"
}

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

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

URL: https://wappi.pro/api/sync/message/send?profile_id={{profile_id}}&bot_id=test

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

Метод отправляет текстовое сообщение в указанный чат WhatsApp. Сообщение может быть отправлено по номеру телефона получателя или уникальному идентификатору чата.

Request Body

Параметр	Тип	Обязательный	Описание
`body`	string	Да	Текст отправляемого сообщения.
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`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_idtestНеобязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.

Headers

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

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

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

{
    "recipient":"79110000000",
    //"chat_id": "21225800000000@lid",
    "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": 1785856820,
  "time": "2026-08-04T18:20:20+03:00",
  "message_id": "3EB037AB78829BD9965EB0",
  "task_id": "1177208239e3af8c77faca82c3a2a28c",
  "uuid": "5efde003-d699"
}

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

URL: https://wappi.pro/api/sync/message/file/url/send?profile_id={{profile_id}}&bot_id=test

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`url`	string	Да	Прямая ссылка на изображение, видео или документ, который необходимо отправить.
`caption`	string	Нет	Подпись к изображению, видео или документу.
`file_name`	string	Нет	Имя отправляемого документа с расширением файла. Например: `"name.pdf"`. Используется при отправке документа.
`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": "79110000000",
    //"chat_id": "21225800000000@lid",
    "url":"https://i.pinimg.com/originals/5a/b4/47/5ab447a717b052550087adf5cacba543.png",
    "caption": "Тестовое описание",
    //"file_name": "name.pdf",
    "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": 1785918793,
  "time": "2026-08-05T11:33:13+03:00",
  "message_id": "3EB034CFCF068344E93EE9",
  "task_id": "d80c25ef0cda38bb2cfd1c017ab90085",
  "uuid": "5efde003-d699"
}

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

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

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`latitude`	number	Да	Широта местоположения в десятичном формате. Например: `55.750446`.
`longitude`	number	Да	Долгота местоположения в десятичном формате. Например: `37.617494`.
`address`	string	Нет	Адрес местоположения. Например: `"улица Торцева, 23А, Северодвинск, Архангельская область, 164520"`.
`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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000",
    "latitude" : 55.750446,
    "longitude": 37.617494,
    "address": "улица Торцева, 23А, Северодвинск, Архангельская область, 164520",
    "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": 1786010487,
  "time": "2026-08-06T13:01:27+03:00",
  "message_id": "3EB01748D0A0063AE4239C",
  "task_id": "c558a121ac5b838397c2073a9961f8ab",
  "uuid": "5efde003-d699"
}

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

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

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

Метод отправляет контакт в указанный чат WhatsApp. Для отправки необходимо указать номер телефона и имя передаваемого контакта.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`phone`	string	Да	Номер телефона передаваемого контакта. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79110000000`.
`name`	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}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

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

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

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

{
    "phone": "79110000000",
    //"chat_id": "21225800000000@lid",
    "recipient": "79210000000",
    "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": 1786011342,
  "time": "2026-08-06T13:15:42+03:00",
  "message_id": "3EB05C7FABC36476B1C288",
  "task_id": "75f40893956be816e32475c8f8c80bcc",
  "uuid": "5efde003-d699"
}

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

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

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

Метод добавляет реакцию к указанному сообщению WhatsApp. Для отправки необходимо передать идентификатор сообщения и эмодзи реакции.

Request Body

Параметр	Тип	Обязательный	Описание
`body`	string	Да	Эмодзи реакции, которую необходимо добавить к сообщению. Например: `"👍"`.
`message_id`	string	Да	Уникальный идентификатор сообщения, к которому необходимо добавить реакцию. Например: `"3EB062BCDDDA1B9DBFB395"`.
`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": "3EB062BCDDDA1B9DBFB395",
  "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": 1786016360,
  "time": "2026-08-06T14:39:20+03:00",
  "message_id": "3EB079EB80B60F2942F690",
  "task_id": "1b7f282dfdeb155de18aca7ce4fedb1c",
  "uuid": "5efde003-d699"
}

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

URL: https://wappi.pro/api/sync/message/mark/read?profile_id={{profile_id}}&mark_all=true

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

Метод отмечает указанное сообщение WhatsApp как прочитанное. При передаче параметра mark_all=true прочитанными отмечаются все сообщения в соответствующем чате.

Request Body

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

Query Params

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

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

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

Headers

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

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

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

{
  "message_id": "3EB06267BB02054ABBB757"
}

Responses

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

{
  "status": "done",
  "timestamp": 1786021219,
  "time": "2026-08-06T16:00:19+03:00",
  "task_id": "064bee98df7c7497056958b28d26cde1",
  "uuid": "5efde003-d699"
}

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

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

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

Метод пересылает указанное сообщение в выбранный чат WhatsApp. В WhatsApp пересланное сообщение создаётся как новое, поэтому в ответе возвращается message_id нового сообщения.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`message_id`	string	Да	Уникальный идентификатор сообщения, которое необходимо переслать. Например: `"3EB06267BB02054ABBB757"`.
`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

{
    //"chat_id": "21225800000000@lid",
    "recipient": "79110000000",    
    "message_id":"3EB06267BB02054ABBB757",
    "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": 1786021547,
  "time": "2026-08-06T16:05:47+03:00",
  "message_id": "3EB01DBC6A59DA84ABC4A3",
  "task_id": "376dce669bde2888a6a94d6202ca9bae",
  "uuid": "5efde003-d699"
}

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

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

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`body`	string	Да	Текст ответа на сообщение. При передаче параметра `url` используется как подпись к отправляемому файлу.
`message_id`	string	Да	Уникальный идентификатор сообщения, на которое необходимо ответить. Например: `"3EB06267BB02054ABBB757"`.
`url`	string	Нет	Прямая ссылка на файл, который необходимо отправить в ответе на сообщение. Если параметр не передан, отправляется только текст из параметра `body`.
`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": "3EB06267BB02054ABBB757",
  "url": "https://freetestdata.com/wp-content/uploads/2022/02/Free_Test_Data_117KB_JPG.jpg",
  "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": 1786021914,
  "time": "2026-08-06T16:11:54+03:00",
  "message_id": "3EB0854BDDF48DC62DFAFA",
  "task_id": "38da9b3457bfed72cf43f3d489fce549",
  "uuid": "5efde003-d699"
}

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

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

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

Метод удаляет указанное сообщение WhatsApp.

Request Body

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

Query Params

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

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

Headers

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

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

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

{
  "message_id": "3EB01DBC6A59DA84ABC4A3"
}

Responses

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

{
  "status": "done",
  "timestamp": 1786022249,
  "time": "2026-08-06T16:17:29+03:00",
  "task_id": "6b775d73ef32b16856e9d7514bc51d56",
  "uuid": "5efde003-d699"
}

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

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

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

Метод изменяет текст указанного сообщения WhatsApp. Изменить текст сообщения можно только в течение 15 минут после отправки.

Request Body

Параметр	Тип	Обязательный	Описание
`message_id`	string	Да	Уникальный идентификатор сообщения, которое необходимо изменить. Например: `"3EB032B996432595D5FFEA"`.
`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}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.

Headers

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

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

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

{
  "message_id": "3EB032B996432595D5FFEA",
  "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": 1786022461,
  "time": "2026-08-06T16:21:01+03:00",
  "message_id": "3EB0D3439311FD12D190CB",
  "task_id": "65f0f132c661efd5c58ab2c40a5007d0",
  "uuid": "5efde003-d699"
}

POSTСоздать опрос/api/sync/poll/create

URL: https://wappi.pro/api/sync/poll/create?profile_id={{profile_id}}&bot_id=test

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`body`	string	Да	Текст вопроса опроса. Например: `"Тестовый опрос"`.
`poll_options`	array of strings	Да	Массив вариантов ответа. Например: `["да", "нет", "не знаю", "где я?"]`.
`poll_select_count`	integer	Да	Количество вариантов ответа, которые пользователь может выбрать. При значении `1` можно выбрать только один вариант.

Query Params

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

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

Headers

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

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

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

{
    "recipient": "79110000000",
    //"chat_id": "21225800000000@lid",
    "body": "Тестовый опрос",
    "poll_options": ["да", "нет", "не знаю", "где я?"],
    "poll_select_count": 1
}

Responses

Создать опрос200

{
  "status": "done",
  "timestamp": 1786022724,
  "time": "2026-08-06T16:25:24+03:00",
  "message_id": "3EB066D7AE261698E993A0",
  "task_id": "472ce62dd5fa67bb416114dcf2a31bb0",
  "uuid": "5efde003-d699"
}

POSTПоиск сообщений/api/sync/messages/search

URL: https://wappi.pro/api/sync/messages/search?profile_id={{profile_id}}

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`body`	string	Да	Текст, по которому выполняется поиск сообщений. Например: `"привет"`.
`recipient`	string	Нет	Номер телефона участника чата, в котором необходимо выполнить поиск. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79110000000`. Если `recipient` и `chat_id` не переданы, поиск выполняется по всем чатам профиля.
`chat_id`	string	Нет	Уникальный идентификатор чата WhatsApp, в котором необходимо выполнить поиск. Например: `21225800000000@lid`. Если `recipient` и `chat_id` не переданы, поиск выполняется по всем чатам профиля.

Query Params

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

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

Headers

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

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

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

{
    "body": "привет",
    //"recipient": "79110000000",
    "chat_id": "21225800000000@lid"
}

Responses

Поиск сообщений200

{
  "status": "success",
  "timestamp": 1786023004,
  "time": "2026-08-06T16:30:04+03:00",
  "messages": null,
  "total_count": 1,
  "task_id": "a1b2c3d4e5f6478890abcdef12345678",
  "uuid": "a1b2c3d4-e5f6",
  "results": [
    {
      "chat": {
        "id": "79990000001@s.whatsapp.net",
        "type": "",
        "isGroup": false,
        "image": "",
        "thumbnail": "https://fs.wappi.pro/fs/downloadFile/a1b2c3d4-e5f6/avatars/tumb_79990000001.jpg",
        "avatar_updated_at": 1785839510,
        "last_message_delivery_status": "",
        "last_message_id": "",
        "last_timestamp": 0,
        "last_message_type": "",
        "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,
        "is_wappi_archived": false,
        "wappi_tags": null,
        "phone": "79990000001",
        "manager": {
          "id": "",
          "name": "",
          "ava_link": "",
          "description": ""
        }
      },
      "message": {
        "id": "3EB0000000000000000000",
        "type": "chat",
        "from": "21225800000000@lid",
        "to": "79990000001@c.us",
        "fromMe": true,
        "senderName": "Имя отправителя",
        "contact_name": "",
        "username": "",
        "phone": "",
        "time": 1783933997,
        "body": "Тестовое сообщение",
        "stanzaId": "",
        "chatId": "79990000001@c.us",
        "isForwarded": false,
        "isReply": false,
        "caption": "",
        "file_name": "",
        "isRead": true,
        "delivery_status": "read",
        "s3Info": {},
        "poll_votes": null,
        "mimetype": "",
        "from_where": "phone",
        "isEdited": false,
        "isGif": false,
        "isFromAPI": false,
        "isDeleted": false,
        "location": null,
        "isPinned": false,
        "reactions": null,
        "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": null
      }
    }
  ]
}

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

URL: https://wappi.pro/api/sync/messages/get?profile_id={{profile_id}}&chat_id=79110000000&limit=1&date=2019-11-02T23:16:58&offset=0&mark_all=true&order=desc&reverse=false

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

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

Query Params

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

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

chat_id79110000000Обязательный параметр. ID чата из списка сообщений. Примеры: 13475634251@c.us - id чата 79115556677 - номер телефона чата 134756342511567456345@g.us - id чата группы

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

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

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

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

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

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786023000,
  "time": "2026-08-06T16:30:00+03:00",
  "messages": [
    {
      "id": "3EB0000000000000000000",
      "type": "poll",
      "from": "79990000001@c.us",
      "to": "79990000002@c.us",
      "fromMe": true,
      "senderName": "Имя отправителя",
      "contact_name": "",
      "username": "",
      "phone": "",
      "time": 1786022700,
      "body": "Тестовый опрос",
      "stanzaId": "",
      "chatId": "79990000002@c.us",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "file_name": "",
      "isRead": true,
      "delivery_status": "delivered",
      "s3Info": {},
      "poll_votes": {},
      "poll_options": [
        "да",
        "нет",
        "не знаю",
        "другой вариант"
      ],
      "mimetype": "",
      "from_where": "api",
      "isEdited": false,
      "isGif": false,
      "isFromAPI": true,
      "isDeleted": false,
      "location": null,
      "isPinned": false,
      "reactions": null,
      "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": null
    }
  ],
  "total_count": 38,
  "task_id": "a1b2c3d4e5f6478890abcdef12345678",
  "uuid": "a1b2c3d4-e5f6",
  "results": null
}

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

URL: https://wappi.pro/api/sync/messages/id/get?profile_id={{profile_id}}&message_id=3EB066D7AE261698E993A0

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

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

Query Params

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

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

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

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786023000,
  "time": "2026-08-06T16:30:00+03:00",
  "message": {
    "id": "3EB0000000000000000000",
    "type": "poll",
    "from": "79990000001@c.us",
    "to": "79990000002@c.us",
    "fromMe": true,
    "senderName": "Имя отправителя",
    "contact_name": "",
    "username": "",
    "phone": "",
    "time": 1786022700,
    "body": "Тестовый опрос",
    "stanzaId": "",
    "chatId": "79990000002@c.us",
    "isForwarded": false,
    "isReply": false,
    "caption": "",
    "file_name": "",
    "isRead": true,
    "delivery_status": "delivered",
    "s3Info": {},
    "poll_votes": null,
    "mimetype": "",
    "from_where": "",
    "isEdited": false,
    "isGif": false,
    "isFromAPI": true,
    "isDeleted": false,
    "location": null,
    "isPinned": false,
    "reactions": null,
    "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": null
  },
  "task_id": "a1b2c3d4e5f6478890abcdef12345678",
  "uuid": "a1b2c3d4-e5f6"
}

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

URL: https://wappi.pro/api/sync/message/media/download?profile_id={{profile_id}}&message_id=3EB0DAEBE8EB99F2B946E9

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

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

Query Params

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

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

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

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786023372,
  "time": "2026-08-06T16:36:12+03:00",
  "task_id": "734e58a1f69ee4d9c8d0be5aafc18a2f",
  "uuid": "5efde003-d699",
  "file_name": "3dff55ff-987c-47ee-89e9-4a734e8bfc6f.jpg",
  "media_type": "image",
  "mime_type": "image/jpeg",
  "file_link": "https://...",
  "file_link_expire": 1786282572
}

GETПолучить все сообщения профиля/api/sync/messages/all/get

URL: https://wappi.pro/api/sync/messages/all/get?profile_id={{profile_id}}&limit=5&offset=0&date=2023-05-02T23:16:58&order=desc

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

Получение всех сообщений в профиле.

Query Params

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

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

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

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

Headers

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

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

Responses

Получить все сообщения профиля200

{
  "status": "done",
  "timestamp": 1786023000,
  "time": "2026-08-06T16:30:00+03:00",
  "messages": [
    {
      "id": "3EB0000000000000000001",
      "type": "image",
      "from": "79990000001@c.us",
      "to": "79990000002@c.us",
      "fromMe": true,
      "senderName": "Имя отправителя",
      "contact_name": "",
      "username": "",
      "phone": "",
      "time": 1786022900,
      "body": {
        "JPEGThumbnail": "<BASE64_JPEG_THUMBNAIL>",
        "URL": "https://example.com/whatsapp/media/image-1.jpg",
        "contextInfo": {
          "disappearingMode": {
            "initiator": 0
          }
        },
        "directPath": "/whatsapp/media/image-1",
        "fileEncSHA256": "ZXhhbXBsZS1lbmNyeXB0ZWQtaGFzaA==",
        "fileLength": 225695,
        "fileSHA256": "ZXhhbXBsZS1maWxlLWhhc2g=",
        "height": 865,
        "mediaKey": "ZXhhbXBsZS1tZWRpYS1rZXk=",
        "mediaKeyTimestamp": 1786022898,
        "mimetype": "image/jpeg",
        "viewOnce": false,
        "width": 1600
      },
      "stanzaId": "",
      "chatId": "79990000002@c.us",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "file_name": "",
      "isRead": true,
      "delivery_status": "delivered",
      "s3Info": {
        "url": "https://storage.example.com/profile-a1b2c3d4/image-1.jpg",
        "expire": 1786282000
      },
      "poll_votes": null,
      "mimetype": "",
      "from_where": "phone",
      "isEdited": false,
      "isGif": false,
      "isFromAPI": false,
      "isDeleted": false,
      "location": null,
      "isPinned": false,
      "reactions": null,
      "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": null
    },
    {
      "id": "3EB0000000000000000002",
      "type": "poll",
      "from": "79990000001@c.us",
      "to": "79990000002@c.us",
      "fromMe": true,
      "senderName": "Имя отправителя",
      "contact_name": "",
      "username": "",
      "phone": "",
      "time": 1786022700,
      "body": "Тестовый опрос",
      "stanzaId": "",
      "chatId": "79990000002@c.us",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "file_name": "",
      "isRead": true,
      "delivery_status": "delivered",
      "s3Info": {},
      "poll_votes": {},
      "poll_options": [
        "да",
        "нет",
        "не знаю",
        "другой вариант"
      ],
      "mimetype": "",
      "from_where": "api",
      "isEdited": false,
      "isGif": false,
      "isFromAPI": true,
      "isDeleted": false,
      "location": null,
      "isPinned": false,
      "reactions": null,
      "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": null
    },
    {
      "id": "3EB0000000000000000003",
      "type": "image",
      "from": "79990000001@c.us",
      "to": "79990000002@c.us",
      "fromMe": true,
      "senderName": "Имя отправителя",
      "contact_name": "",
      "username": "",
      "phone": "",
      "time": 1786022500,
      "body": {
        "JPEGThumbnail": "<BASE64_JPEG_THUMBNAIL>",
        "URL": "https://example.com/whatsapp/media/image-2.jpg",
        "contextInfo": {
          "disappearingMode": {
            "initiator": 0
          }
        },
        "directPath": "/whatsapp/media/image-2",
        "fileEncSHA256": "ZXhhbXBsZS1lbmNyeXB0ZWQtaGFzaC0y",
        "fileLength": 145895,
        "fileSHA256": "ZXhhbXBsZS1maWxlLWhhc2gtMg==",
        "height": 865,
        "mediaKey": "ZXhhbXBsZS1tZWRpYS1rZXktMg==",
        "mediaKeyTimestamp": 1785857000,
        "mimetype": "image/jpeg",
        "viewOnce": false,
        "width": 1600
      },
      "stanzaId": "",
      "chatId": "79990000002@c.us",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "file_name": "",
      "isRead": true,
      "delivery_status": "delivered",
      "s3Info": {
        "url": "https://storage.example.com/profile-a1b2c3d4/image-2.jpg",
        "expire": 1786206000
      },
      "poll_votes": null,
      "mimetype": "",
      "from_where": "phone",
      "isEdited": false,
      "isGif": false,
      "isFromAPI": false,
      "isDeleted": false,
      "location": null,
      "isPinned": false,
      "reactions": null,
      "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": null
    },
    {
      "id": "3EB0000000000000000004",
      "type": "chat",
      "from": "79990000001@c.us",
      "to": "79990000002@c.us",
      "fromMe": true,
      "senderName": "Имя отправителя",
      "contact_name": "",
      "username": "",
      "phone": "",
      "time": 1786022300,
      "body": "Изменённый текст сообщения",
      "stanzaId": "",
      "chatId": "79990000002@c.us",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "file_name": "",
      "isRead": true,
      "delivery_status": "delivered",
      "s3Info": {},
      "poll_votes": null,
      "mimetype": "",
      "from_where": "phone",
      "isEdited": true,
      "isGif": false,
      "isFromAPI": false,
      "isDeleted": false,
      "location": null,
      "isPinned": false,
      "reactions": null,
      "wappi_bot_id": "",
      "task_id": "",
      "template_id": "",
      "manager": {
        "id": "manager-001",
        "name": "Имя менеджера",
        "ava_link": "https://example.com/avatars/manager.jpg",
        "description": "Дополнительная информация о менеджере"
      },
      "crm_entities": {
        "crm_type": "",
        "crm_id": "",
        "message_id": "",
        "chat_id": "",
        "manager_id": ""
      },
      "is_blacklist": false,
      "billable": false,
      "attaches": null
    },
    {
      "id": "3EB0000000000000000005",
      "type": "image",
      "from": "79990000001@c.us",
      "to": "79990000003@c.us",
      "fromMe": true,
      "senderName": "Имя отправителя",
      "contact_name": "",
      "username": "",
      "phone": "",
      "time": 1786021900,
      "body": {
        "JPEGThumbnail": "<BASE64_JPEG_THUMBNAIL>",
        "URL": "https://example.com/whatsapp/media/image-3.jpg",
        "caption": "Тестовый ответ на сообщение",
        "contextInfo": {
          "participant": "79990000003@c.us",
          "quotedMessage": {},
          "stanzaID": "3EB0000000000000000099"
        },
        "directPath": "/whatsapp/media/image-3",
        "fileEncSHA256": "ZXhhbXBsZS1lbmNyeXB0ZWQtaGFzaC0z",
        "fileLength": 120193,
        "fileSHA256": "ZXhhbXBsZS1maWxlLWhhc2gtMw==",
        "mediaKey": "ZXhhbXBsZS1tZWRpYS1rZXktMw==",
        "mimetype": "image/jpeg"
      },
      "stanzaId": "",
      "chatId": "79990000003@c.us",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "file_name": "",
      "isRead": false,
      "delivery_status": "delivered",
      "s3Info": {
        "url": "https://example.com/files/test-image.jpg",
        "expire": 1786205000
      },
      "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": "",
      "template_id": "",
      "manager": {
        "id": "manager-001",
        "name": "Имя менеджера",
        "ava_link": "https://example.com/avatars/manager.jpg",
        "description": "Дополнительная информация о менеджере"
      },
      "crm_entities": {
        "crm_type": "",
        "crm_id": "",
        "message_id": "",
        "chat_id": "",
        "manager_id": ""
      },
      "is_blacklist": false,
      "billable": false,
      "attaches": null
    }
  ],
  "total_count": 2285,
  "task_id": "a1b2c3d4e5f6478890abcdef12345678",
  "uuid": "a1b2c3d4-e5f6"
}

GETПолучить список отправленных сообщений (API)/api/sync/messages/history

URL: https://wappi.pro/api/sync/messages/history?profile_id={{profile_id}}&limit=3

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

Получение списка всех отправленных по API сообщений. Сообщений, отправленных с телефона или web whatsapp, в этом списке не будет.

Query Params

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

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

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

Headers

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

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

Responses

Получить список отправленных сообщений (API)200

{
  "status": "done",
  "detail": [
    {
      "delivered": "success",
      "recipient": "79115576367@c.us",
      "message": "тест",
      "caption": "",
      "created_at": "2023-12-04T17:47:23.008Z",
      "task_name": "sendMessage",
      "id": "3EB0C8A79F15F30021B86B",
      "task_id": "ad90cfc1-3d07-489f-ae3f-60a49e523178"
    }
  ],
  "all_messages_count": 1276
}

POSTОтправить кнопки/api/sync/message/buttons/send

URL: https://wappi.pro/api/sync/message/buttons/send?profile_id={{profile_id}}

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

МЕТОД ВРЕМЕННО НЕ РАБОТАЕТ. Отправка сообщения с кнопками.

Query Params

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

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

Headers

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

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

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

{
    "chat_id": "21225800000000@lid",
    //"recipient": "79995579399",
    "title": "Заголовок сообщения",
    "body": "Текст сообщения",
    "buttons": [
        {
            "body": "button text 1",
            "id": "1"
        },
        {
            "body": "button text 2",
            "id": "2"
        },
        {
            "body": "button text 3",
            "id": "3"
        }
    ]
}

POSTОтправить списки/api/sync/message/list/send

URL: https://wappi.pro/api/sync/message/list/send?profile_id={{profile_id}}

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

МЕТОД ВРЕМЕННО НЕ РАБОТАЕТ. Отправка сообщения со списком.

Query Params

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

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

Headers

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

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

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

{
    "chat_id": "21225800000000@lid",
    //"recipient": "79995579399",
    "title": "Заголовок сообщения",
    "body": "Текст сообщений",
    "btn_text": "НАЖМИ на меня 😀",
    "list": {
        "title": "Заголовок меню",
        "rows": [
            {
                "title": "Выбор 1",
                "id": "id1"
            },
            {
                "title": "Выбор 2",
                "id": "id2"
            },
            {
                "title": "Выбор 3",
                "id": "id3",
                "description": "Можно добавлять описание для секции"
            },
            {
                "title": "Выбор 4 😁",
                "description": "Можно  😁 добавлять эмоджики"
            },
            {
                "title": "Выбор 5",
                "description": "Оппппапапапа пана",
                "id": "test-4"
            },
            {
                "title": "Выбор 6",
                "description": "Оп2а пана",
                "id": "test-6"
            },
            {
                "title": "Выбор 7",
                "description": "Оп2а пана",
                "id": "test-7"
            },
            {
                "title": "Выбор 8",
                "description": "Оп2а пана",
                "id": "test-8"
            }
        ]
    }
}

POSTУстаревший - Отправить картинку (base64)/api/sync/message/img/send

URL: https://wappi.pro/api/sync/message/img/send?profile_id={{profile_id}}&bot_id=test

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

Метод отправляет изображение в указанный чат WhatsApp. Файл изображения передаётся в теле запроса в формате Base64. К изображению можно добавить подпись.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`caption`	string	Нет	Подпись к изображению.
`b64_file`	string	Да	Файл изображения, закодированный в формате Base64.

Query Params

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000",
    "caption": "Это картинка",
    "b64_file" : "iVBORw0KGgoAAAANSU"   
}

Responses

Отправить картинку (base64)200

{
  "status": "done",
  "timestamp": 1785919054,
  "time": "2026-08-05T11:37:34+03:00",
  "message_id": "3EB013E951AB5644361CB8",
  "task_id": "1e67a7982321f367a4370b58e23e76db",
  "uuid": "5efde003-d699"
}

POSTУстаревший - Отправить документ (base64)/api/sync/message/document/send

URL: https://wappi.pro/api/sync/message/document/send?profile_id={{profile_id}}&bot_id=test

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

Метод отправляет документ в указанный чат WhatsApp. Файл документа передаётся в теле запроса в формате Base64. Для документа допустимо указать имя файла. К документу можно добавить подпись.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`caption`	string	Нет	Подпись к документу.
`file_name`	string	Нет	Имя документа с расширением файла. Например: `"TestName.pdf"`.
`b64_file`	string	Да	Файл документа, закодированный в формате Base64. Передаётся без префикса MIME-типа.

Query Params

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000",
    "caption": "Это документ",
    "file_name": "TestName.pdf",
    "b64_file" : "JVBECg=="
}

Responses

Отправить документ (base64)200

{
  "status": "done",
  "timestamp": 1785929141,
  "time": "2026-08-05T14:25:41+03:00",
  "message_id": "3EB0CFF23C79D5D85E26C5",
  "task_id": "90af76c240a4dd8c04988687b50e111f",
  "uuid": "5efde003-d699"
}

POSTУстаревший - Отправить видео (base64)/api/sync/message/video/send

URL: https://wappi.pro/api/sync/message/video/send?profile_id={{profile_id}}&bot_id=test

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

Метод отправляет видео в указанный чат WhatsApp. Видеофайл передаётся в теле запроса в формате Base64. К видео можно добавить подпись.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`caption`	string	Нет	Подпись к видео.
`b64_file`	string	Да	Видеофайл, закодированный в формате Base64.

Query Params

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000",
    "caption": "Это видео",
    "b64_file":"AAAAGapn0PivgA=="
}

Responses

Отправить видео (base64)200

{
  "status": "done",
  "timestamp": 1785929691,
  "time": "2026-08-05T14:34:51+03:00",
  "message_id": "3EB062BCDDDA1B9DBFB395",
  "task_id": "60c5313a0ee4835fc6d7550b11f945de",
  "uuid": "5efde003-d699"
}

POSTУстаревший - Отправить аудио (base64)/api/sync/message/audio/send

URL: https://wappi.pro/api/sync/message/audio/send?profile_id={{profile_id}}&bot_id=test

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

Метод отправляет аудиофайл в указанный чат WhatsApp. Файл передаётся в теле запроса в формате Base64.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`b64_file`	string	Да	Аудиофайл, закодированный в формате Base64.

Query Params

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000",
    "b64_file" : "T2dnUwAw4RrqG9jvZa4F1qQU1y+H/"
}

Responses

Отправить аудио (base64)200

{
  "status": "done",
  "timestamp": 1785929355,
  "time": "2026-08-05T14:29:15+03:00",
  "message_id": "3EB0B6B602C510D396D594",
  "task_id": "367e48d05666393591a590da72665deb",
  "uuid": "5efde003-d699"
}

POSTУстаревший - Отправить файл/api/sync/message/file/send

URL: https://wappi.pro/api/sync/message/file/send?profile_id={{profile_id}}&chat_id=21225800000000@lid

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

Метод устарел. Для отправки различных файлов используйте метод "Отправить медиа по ссылке"

Query Params

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

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

chat_id21225800000000@lidОбязательный параметр (если не указан recipient). Идентификатор чата - получателя сообщения.

Headers

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

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

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

JVBERi0xLjMKJcTl8uXc5NAolJUVPRgo=

Responses

Отправить файл (устаревший)200

{
  "status": "done",
  "timestamp": 1679824190,
  "time": "2023-03-26T12:49:50+03:00",
  "message_id": "3EB0F4D080603C3C0C0A",
  "task_id": "bb2fc603-8e0f-4941-a9aa-ba8e96a47077"
}

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

POSTОтправка текстового сообщения асинхронно/api/async/message/send

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

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

Метод асинхронно отправляет текстовое сообщение в указанный чат WhatsApp. Сообщение ставится в очередь на отправку с учётом заданного интервала задержки и времени жизни задачи

Request Body

Параметр	Тип	Обязательный	Описание
`body`	string	Да	Текст отправляемого сообщения.
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`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Необязательный параметр. Максимальное время задержки, указывается в секундах

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000",    
    "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": 1786356416,
  "time": "2026-08-10T13:06:56+03:00",
  "detail": "Message sent to queue",
  "task_id": "f9e6dc6ec2954b53d26cac2dccec8c69"
}

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

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

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

Метод асинхронно отправляет изображение, видео или документ в указанный чат WhatsApp с постановкой сообщения в очередь. Можно задать интервал задержки перед отправкой: фактическая задержка выбирается случайным образом между значениями timeout_from и timeout_to. Если параметры задержки не указаны, используется стандартный интервал от 1 до 3 секунд.

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

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`url`	string	Да	Прямая ссылка на изображение, видео или документ, который необходимо отправить.
`caption`	string	Нет	Подпись к изображению, видео или документу.
`file_name`	string	Нет	Имя отправляемого документа с расширением файла. Например: `"name.pdf"`. Используется при отправке документа.
`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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000", 
    "url":"https://in-new.ru/public/documents/test.pdf",
    "caption": "Это подпись",
    "file_name": "name.pdf",
    "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": 1786357339,
  "time": "2026-08-10T13:22:19+03:00",
  "detail": "Message sent to queue",
  "task_id": "9e88eb21007cda8cec9db3b9f3bef361"
}

POSTОтправить локацию асинхронно/api/async/message/location/send

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

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

Метод асинхронно отправляет геолокацию в указанный чат WhatsApp с постановкой сообщения в очередь. Для отправки необходимо указать широту и долготу; дополнительно можно передать текстовый адрес. Можно задать интервал задержки перед отправкой: фактическая задержка выбирается случайным образом между значениями timeout_from и timeout_to. Если параметры задержки не указаны, используется стандартный интервал от 1 до 3 секунд.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`latitude`	number	Да	Широта географической точки. Например: `55.750446`.
`longitude`	number	Да	Долгота географической точки. Например: `37.617494`.
`address`	string	Нет	Текстовый адрес географической точки. Например: `"улица Торцева, 23А, Северодвинск, Архангельская область, 164520"`.
`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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000",
    "latitude" : 55.750446,
    "longitude": 37.617494,
    "address": "улица Торцева, 23А, Северодвинск, Архангельская область, 164520",
    "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": 1786358752,
  "time": "2026-08-10T13:45:52+03:00",
  "detail": "Message sent to queue",
  "task_id": "ba2cdcbd3ce5cf022afb948ffd177f43"
}

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

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

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

Метод асинхронно отправляет контакт в указанный чат WhatsApp с постановкой сообщения в очередь. Для отправки необходимо указать номер телефона и имя контакта. Можно задать интервал задержки перед отправкой: фактическая задержка выбирается случайным образом между значениями timeout_from и timeout_to. Если параметры задержки не указаны, используется стандартный интервал от 1 до 3 секунд.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`phone`	string	Да	Номер телефона отправляемого контакта. Например: `79110000000`.
`name`	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Необязательный параметр. Максимальное время задержки, указывается в секундах

Headers

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

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

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

{
    "phone": "79110000000",
    //"chat_id": "21225800000000@lid",
    "recipient": "79210000000",
    "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": 1786358994,
  "time": "2026-08-10T13:49:54+03:00",
  "detail": "Message sent to queue",
  "task_id": "8ec694ecb296ded70e3eaa7b37a0f8c0"
}

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

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

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

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

Можно задать интервал задержки перед отправкой: фактическая задержка выбирается случайным образом между значениями timeout_from и timeout_to. Если параметры задержки не указаны, используется стандартный интервал от 1 до 3 секунд.

В ответе на запрос возвращается идентификатор задачи task_id.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`message_id`	string	Да	Уникальный идентификатор сообщения, которое необходимо переслать. Например: `3EB06267BB02054ABBB757`.
`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

{
    //"chat_id": "21225800000000@lid",
    "recipient": "79110000000",    
    "message_id":"3EB06267BB02054ABBB757",
    "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": 1786359130,
  "time": "2026-08-10T13:52:10+03:00",
  "detail": "Message sent to queue",
  "task_id": "95b25dba6f9fa16b0fb7b61b936b8eb0"
}

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

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

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

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

В ответе на запрос возвращается идентификатор задачи task_id.

Request Body

Параметр	Тип	Обязательный	Описание
`body`	string	Да	Текст ответа на сообщение.
`message_id`	string	Да	Уникальный идентификатор сообщения, на которое необходимо ответить. Например: `3EB06267BB02054ABBB757`.
`url`	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Необязательный параметр. Максимальное время задержки, указывается в секундах

Headers

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

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

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

{
  "body": "тестовый ответ на сообщение",
  "message_id": "3EB06267BB02054ABBB757",
  "url": "https://freetestdata.com/wp-content/uploads/2022/02/Free_Test_Data_117KB_JPG.jpg",
  "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": 1786359318,
  "time": "2026-08-10T13:55:18+03:00",
  "detail": "Message sent to queue",
  "task_id": "ef7076ef3950ee034233124424413a77"
}

POSTСоздать опрос/api/async/poll/create

URL: https://wappi.pro/api/async/poll/create?profile_id={{profile_id}}&timeout_from=1&timeout_to=3&ttl=600&bot_id=test

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

Метод асинхронно создаёт и отправляет опрос в указанный чат WhatsApp с постановкой сообщения в очередь. Для опроса необходимо указать вопрос, варианты ответа и количество вариантов, которые пользователь может выбрать.

В ответе на запрос возвращается идентификатор задачи task_id.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`body`	string	Да	Текст вопроса опроса. Например: `"Тестовый опрос"`.
`poll_options`	array of strings	Да	Массив вариантов ответа. Например: `["да", "нет", "не знаю", "где я?"]`.
`poll_select_count`	integer	Да	Количество вариантов ответа, которые пользователь может выбрать. При значении `1` можно выбрать только один вариант.

Query Params

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

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

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000", 
    "body": "Тестовый опрос",
    "poll_options": ["да", "нет", "не знаю", "где я?"],
    "poll_select_count": 1
}

Responses

Создать опрос200

{
  "status": "done",
  "timestamp": 1786359494,
  "time": "2026-08-10T13:58:14+03:00",
  "detail": "Message sent to queue",
  "task_id": "e6d48f85afad419094e89472b874fc4d"
}

POSTУстаревший - Отправить картинку (base64) асинхронно/api/async/message/img/send

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

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

Метод асинхронно отправляет изображение в формате Base64 в указанный чат WhatsApp с постановкой сообщения в очередь. Можно задать интервал задержки перед отправкой: фактическая задержка выбирается случайным образом между значениями timeout_from и timeout_to. Если параметры задержки не указаны, используется стандартный интервал от 1 до 3 секунд.

К изображению можно добавить подпись.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`caption`	string	Нет	Подпись к изображению.
`b64_file`	string	Да	Изображение в формате Base64.

Query Params

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

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

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000", 
    "caption": "Это картинка",
    "b64_file" : "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
}

Responses

Устаревший - Отправить картинку (base64) асинхронно200

{
  "status": "done",
  "timestamp": 1786357628,
  "time": "2026-08-10T13:27:08+03:00",
  "detail": "Message sent to queue",
  "task_id": "66790ce16add6c36a764e77316b9ad75"
}

POSTУстаревший - Отправить документ (base64) асинхронно/api/async/message/document/send

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

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

Метод асинхронно отправляет документ в формате Base64 в указанный чат WhatsApp с постановкой сообщения в очередь. Можно задать интервал задержки перед отправкой: фактическая задержка выбирается случайным образом между значениями timeout_from и timeout_to. Если параметры задержки не указаны, используется стандартный интервал от 1 до 3 секунд.

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

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`caption`	string	Нет	Подпись к документу.
`file_name`	string	Да	Имя документа с расширением файла. Например: `"name.pdf"`.
`b64_file`	string	Да	Документ в формате Base64.

Query Params

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

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

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000", 
    "caption": "Это документ",
    "file_name": "name.pdf",
    "b64_file" : "JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUl0gL0NvdW50IDEgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCAyMDAgMTAwXSAvQ29udGVudHMgNCAwIFIgL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNSAwIFIgPj4gPj4gPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCA0NCA+PgpzdHJlYW0KQlQKL0YxIDEyIFRmCjIwIDUwIFRkCihUZXN0IGRvY3VtZW50KSBUagpFVAplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKPDwgL1R5cGUgL0ZvbnQgL1N1YnR5cGUgL1R5cGUxIC9CYXNlRm9udCAvSGVsdmV0aWNhID4+CmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1OCAwMDAwMCBuIAowMDAwMDAwMTE1IDAwMDAwIG4gCjAwMDAwMDAyNDEgMDAwMDAgbiAKMDAwMDAwMDMzNCAwMDAwMCBuIAp0cmFpbGVyCjw8IC9TaXplIDYgL1Jvb3QgMSAwIFIgPj4Kc3RhcnR4cmVmCjQwNAolJUVPRgo="
}

Responses

Устаревший - Отправить документ (base64) асинхронно200

{
  "status": "done",
  "timestamp": 1786357999,
  "time": "2026-08-10T13:33:19+03:00",
  "detail": "Message sent to queue",
  "task_id": "3991fa4a52ef905ac8481dd74c96e30f"
}

POSTУстаревший - Отправить видео (base64) асинхронно/api/async/message/video/send

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

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

Метод асинхронно отправляет видео в формате Base64 в указанный чат WhatsApp с постановкой сообщения в очередь. Можно задать интервал задержки перед отправкой: фактическая задержка выбирается случайным образом между значениями timeout_from и timeout_to. Если параметры задержки не указаны, используется стандартный интервал от 1 до 3 секунд.

К видео можно добавить подпись.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`caption`	string	Нет	Подпись к видео.
`b64_file`	string	Да	Видео в формате Base64.

Query Params

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

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

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000", 
    "caption": "Это видео",
    "b64_file":"AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAMObW9vdgAAAGxtdmhkAAAAAAAAAAAAAAAAAAAD6AAAA+gAAQAAAQAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAjl0cmFrAAAAXHRraGQAAAADAAAAAAAAAAAAAAABAAAAAAAAA+gAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAABAAAAAABAAAAAQAAAAAAAkZWR0cwAAABxlbHN0AAAAAAAAAAEAAAPoAAAAAAABAAAAAAGxbWRpYQAAACBtZGhkAAAAAAAAAAAAAAAAAABAAAAAQABVxAAAAAAALWhkbHIAAAAAAAAAAHZpZGUAAAAAAAAAAAAAAABWaWRlb0hhbmRsZXIAAAABXG1pbmYAAAAUdm1oZAAAAAEAAAAAAAAAAAAAACRkaW5mAAAAHGRyZWYAAAAAAAAAAQAAAAx1cmwgAAAAAQAAARxzdGJsAAAAuHN0c2QAAAAAAAAAAQAAAKhhdmMxAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAABAAEABIAAAASAAAAAAAAAABFUxhdmM2MS4xOS4xMDEgbGlieDI2NAAAAAAAAAAAAAAAGP//AAAALmF2Y0MBQsAe/+EAFmdCwB7ZHsBEAAADAAQAAAMACDxYuSABAAVoy4PLIAAAABBwYXNwAAAAAQAAAAEAAAAUYnRydAAAAAAAABQwAAAAAAAAABhzdHRzAAAAAAAAAAEAAAABAABAAAAAABxzdHNjAAAAAAAAAAEAAAABAAAAAQAAAAEAAAAUc3RzegAAAAAAAAKGAAAAAQAAABRzdGNvAAAAAAAAAAEAAAM+AAAAYXVkdGEAAABZbWV0YQAAAAAAAAAhaGRscgAAAAAAAAAAbWRpcmFwcGwAAAAAAAAAAAAAAAAsaWxzdAAAACSpdG9vAAAAHGRhdGEAAAABAAAAAExhdmY2MS43LjEwMwAAAAhmcmVlAAACjm1kYXQAAAJwBgX//2zcRem95tlIt5Ys2CDZI+7veDI2NCAtIGNvcmUgMTY0IHIzMTA4IDMxZTE5ZjkgLSBILjI2NC9NUEVHLTQgQVZDIGNvZGVjIC0gQ29weWxlZnQgMjAwMy0yMDIzIC0gaHR0cDovL3d3dy52aWRlb2xhbi5vcmcveDI2NC5odG1sIC0gb3B0aW9uczogY2FiYWM9MCByZWY9MyBkZWJsb2NrPTE6MDowIGFuYWx5c2U9MHgxOjB4MTExIG1lPWhleCBzdWJtZT03IHBzeT0xIHBzeV9yZD0xLjAwOjAuMDAgbWl4ZWRfcmVmPTEgbWVfcmFuZ2U9MTYgY2hyb21hX21lPTEgdHJlbGxpcz0xIDh4OGRjdD0wIGNxbT0wIGRlYWR6b25lPTIxLDExIGZhc3RfcHNraXA9MSBjaHJvbWFfcXBfb2Zmc2V0PS0yIHRocmVhZHM9MSBsb29rYWhlYWRfdGhyZWFkcz0xIHNsaWNlZF90aHJlYWRzPTAgbnI9MCBkZWNpbWF0ZT0xIGludGVybGFjZWQ9MCBibHVyYXlfY29tcGF0PTAgY29uc3RyYWluZWRfaW50cmE9MCBiZnJhbWVzPTAgd2VpZ2h0cD0wIGtleWludD0yNTAga2V5aW50X21pbj0xIHNjZW5lY3V0PTQwIGludHJhX3JlZnJlc2g9MCByY19sb29rYWhlYWQ9NDAgcmM9Y3JmIG1idHJlZT0xIGNyZj0yMy4wIHFjb21wPTAuNjAgcXBtaW49MCBxcG1heD02OSBxcHN0ZXA9NCBpcF9yYXRpbz0xLjQwIGFxPTE6MS4wMACAAAAADmWIhAV///8PRQABQt+A"
}

Responses

Устаревший - Отправить видео (base64) асинхронно200

{
  "status": "done",
  "timestamp": 1786358187,
  "time": "2026-08-10T13:36:27+03:00",
  "detail": "Message sent to queue",
  "task_id": "3a2db654e1f6452928e5d36f97352a52"
}

POSTУстаревший - Отправить аудио (base64) асинхронно/api/async/message/audio/send

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

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

Метод асинхронно отправляет аудиофайл в формате Base64 в указанный чат WhatsApp с постановкой сообщения в очередь. Можно задать интервал задержки перед отправкой: фактическая задержка выбирается случайным образом между значениями timeout_from и timeout_to. Если параметры задержки не указаны, используется стандартный интервал от 1 до 3 секунд.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Условно	Номер телефона получателя. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79115576362`. Обязателен, если не передан `chat_id`.
`chat_id`	string	Условно	Уникальный идентификатор чата WhatsApp. Например: `21225800000000@lid`. Обязателен, если не передан `recipient`.
`b64_file`	string	Да	Аудиофайл в формате Base64.

Query Params

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

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

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

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

Headers

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

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

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

{
    //"chat_id": "21225800000000@lid",
    "recipient" : "79110000000", 
    "b64_file" : "SUQzBAAAAAAAIlRTU0UAAAAOAAADTGF2ZjYxLjcuMTAzAAAAAAAAAAAAAAD/4zjAAAAAAAAAAAAASW5mbwAAAA8AAAAFAAADqABiYmJiYmJiYmJiYmJiYmJiYmJiiYmJiYmJiYmJiYmJiYmJiYmJiYmxsbGxsbGxsbGxsbGxsbGxsbGxsdjY2NjY2NjY2NjY2NjY2NjY2NjY//////////////////////////8AAAAATGF2YzYxLjE5AAAAAAAAAAAAAAAAJALAAAAAAAAAA6jdNnfqAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD/4yjEAB0oqohfTwAAC5tyUAB+/fv379/e9IDx48ePKUu/fv37/fhskEv4X4DuAtgQwwzjrejx48BCsHz+UOfKB/o9+sHDmIAffWDgYyAPvrAhzQD/KO78HwcBAEAQBAHwfB8HwICAIAgGAfB8PygIBjf/4Pg+BAQBAEHAcHwffUCCTSLvAEDITf////8AAEz/4yjEDh2p2mwBnJAADBEKgQwWEv3+P//mIx0YEDZ6hVGhy9pOg9WkggoeIQGd0pYGIYBGgeSBtIbMFkQWFf/ikQ+UNWjlCghQRDRcv//i5SaHOHOKJFSKmRFiLf//5iXS6ZF4vIl0upA1/+JQkDQlOnv//+xdEA4mVA13+a7rmu6//yy/7vP/ndmAkBQxo8L/4yjEGiAzohjRnzgB5hGFhAzmjAVgvMyLaCXMF5BnfMDXDCDG0IOYwJ8FuhNthnbBN73V7WKsrWsrSybLXmcffzuY6crzzHv6NLuZa97K5i39WUujlN0qxXpKOlZkp0o6VvP72Rlo9l/ava9lf0e6vaXuaQD//92fpJhMVQ5OdMb//6KXvvDyIKAhAKFQV6D/4yjEHCPiKnwJnGgAhNEwtJFxAoAjYzCKAsCQuYVGRjMPCoV/JxAJce5saAAaABKB0DmgrQg/+XETcvpIGiI8hGRoNRhiKfHr/6aakEFumpipiWK0y6ZKNjH/9Bbp2a76zUyUbGIlCgF/uTcnJBQCkgoBQ1//+DRoNAYPAoBiQSWadpnTXn6p3BWFUFfqOtb/4yjEDx45NjAB2EgAWcu7SMqSGQeZbHFhkVkinzRtMizY1HJeKAVMF+cXRQSl4YHQxLSoovK+y7mJO9YfZnTvT1WGX9h3SEKillZEKibFkSLYoUKHVULOA0DRYGlgqdBU6Ig6WDqwVgq7Ue///////////6Pf0ExBTUUzLjEwMKqqqqqqqqqqqqqqqqqqqqo="
}

Responses

Устаревший - Отправить аудио (base64) асинхронно200

{
  "status": "done",
  "timestamp": 1786358339,
  "time": "2026-08-10T13:38:59+03:00",
  "detail": "Message sent to queue",
  "task_id": "21113bbc0016d6c83190e247700e7898"
}

POSTУстаревший - Отправить файл асинхронно/api/async/message/file/send

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

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

Метод устарел. Для отправки различных файлов используйте метод "Отправить медиа по ссылке"

Query Params

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

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

recipient79110000000Обязательный параметр (если не указан chat_id). Получатель сообщения. Для ввода доступны форматы: ID контакта. Пример: 13475634251@c.us; Номер телефона. Пример: 79002224477. Номер должен начинаться с кода страны. Для России и Казахстана это всегда 7, затем 10 цифр. Сообщения на номера телефона с 8 не будут доставлены.

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

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

Headers

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

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

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

JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUl0gL0NvdW50IDEgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCAyMDAgMTAwXSAvQ29udGVudHMgNCAwIFIgL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNSAwIFIgPj4gPj4gPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCA0NCA+PgpzdHJlYW0KQlQKL0YxIDEyIFRmCjIwIDUwIFRkCihUZXN0IGRvY3VtZW50KSBUagpFVAplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKPDwgL1R5cGUgL0ZvbnQgL1N1YnR5cGUgL1R5cGUxIC9CYXNlRm9udCAvSGVsdmV0aWNhID4+CmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1OCAwMDAwMCBuIAowMDAwMDAwMTE1IDAwMDAwIG4gCjAwMDAwMDAyNDEgMDAwMDAgbiAKMDAwMDAwMDMzNCAwMDAwMCBuIAp0cmFpbGVyCjw8IC9TaXplIDYgL1Jvb3QgMSAwIFIgPj4Kc3RhcnR4cmVmCjQwNAolJUVPRgo=

Responses

Устаревший - Отправить файл асинхронно200

{
  "status": "done",
  "timestamp": 1786358496,
  "time": "2026-08-10T13:41:36+03:00",
  "detail": "Message sent to queue",
  "task_id": "c11c7d73750ff24f249f996bd3978438"
}

Работа с чатами9 методов

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

URL: https://wappi.pro/api/sync/chats/get?profile_id={{profile_id}}&limit=10&show_all=false&offset=0&order=asc

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

Метод получает список чатов подключённого аккаунта WhatsApp. В теле запроса можно передать параметры фильтрации; значения фильтров могут содержать регулярные выражения. Если фильтрация не требуется, body можно оставить пустым.

Request Body

Параметр	Тип	Обязательный	Описание
`filter`	object	Нет	Объект с параметрами фильтрации чатов. Если фильтрация не требуется, тело запроса можно оставить пустым.
`filter.ids`	array of strings	Нет	Массив идентификаторов номеров телефонов для фильтрации. В значениях можно использовать регулярные выражения. Например: `["79110000000", "79210000000"]`.

Query Params

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

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

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

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

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

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

Headers

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

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

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

{
  "filter": {
    "ids": [
      "79110000000",
      "79210000000"
    ]
  }
}

Responses

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

{
  "status": "done",
  "timestamp": 1786435386,
  "time": "2026-08-11T11:03:06+03:00",
  "detail": "Chats fetched",
  "dialogs": [
    {
      "id": "79990000001@c.us",
      "contact": {
        "Found": true,
        "FirstName": "Имя контакта 1",
        "FullName": "Имя контакта 1",
        "PushName": "Contact1",
        "BusinessName": "",
        "RedactedPhone": ""
      },
      "chat": {
        "VerifiedName": null,
        "Status": "",
        "PictureID": "",
        "Devices": null,
        "LID": ""
      },
      "group": null,
      "isGroup": false,
      "image": "",
      "thumbnail": "https://fs.wappi.pro/fs/downloadFile/a1b2c3d4-e5f6/avatars/tumb_79990000001.jpg",
      "avatar_updated_at": 1785839510,
      "last_message_delivery_status": "read",
      "last_message_id": "3EB0000000000000000001",
      "last_timestamp": "2026-08-10T10:58:14Z",
      "last_time": 1786359494,
      "last_message_type": "pool",
      "last_message_sender": {
        "id": "79990000003@c.us",
        "number": "79990000003",
        "pushname": "Имя отправителя",
        "isMe": true
      },
      "last_message_data": "pool",
      "name": "Имя контакта 1",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "is_wappi_pinned": false,
      "is_wappi_archived": false,
      "wappi_tags": []
    },
    {
      "id": "79990000002@c.us",
      "contact": {
        "Found": true,
        "FirstName": "Имя контакта 2",
        "FullName": "Имя контакта 2",
        "PushName": "Contact2",
        "BusinessName": "",
        "RedactedPhone": ""
      },
      "chat": {
        "VerifiedName": null,
        "Status": "",
        "PictureID": "",
        "Devices": null,
        "LID": ""
      },
      "group": null,
      "isGroup": false,
      "image": "",
      "thumbnail": "https://fs.wappi.pro/fs/downloadFile/a1b2c3d4-e5f6/avatars/tumb_79990000002.jpg",
      "avatar_updated_at": 1785839504,
      "last_message_delivery_status": "delivered",
      "last_message_id": "3EB0000000000000000002",
      "last_timestamp": "2026-08-10T10:57:52Z",
      "last_time": 1786359472,
      "last_message_type": "image",
      "last_message_sender": {
        "id": "79990000003@c.us",
        "number": "79990000003",
        "pushname": "Имя отправителя",
        "isMe": true
      },
      "last_message_data": "image",
      "name": "Имя контакта 2",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "is_wappi_pinned": false,
      "is_wappi_archived": false,
      "wappi_tags": []
    }
  ],
  "total_count": 2
}

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

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

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

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

Query Params

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

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

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

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786439327,
  "time": "2026-08-11T12:08:47+03:00",
  "detail": "Chats fetched",
  "dialogs": [
    {
      "id": "79990000001@c.us",
      "contact": {
        "Found": true,
        "FirstName": "Имя контакта",
        "FullName": "Имя контакта",
        "PushName": "Contact",
        "BusinessName": "",
        "RedactedPhone": ""
      },
      "chat": {
        "VerifiedName": null,
        "Status": "",
        "PictureID": "",
        "Devices": null,
        "LID": ""
      },
      "group": null,
      "isGroup": false,
      "image": "",
      "thumbnail": "https://fs.wappi.pro/fs/downloadFile/a1b2c3d4-e5f6/avatars/tumb_79990000001.jpg",
      "avatar_updated_at": 1785839510,
      "last_message_delivery_status": "read",
      "last_message_id": "3EB0000000000000000001",
      "last_timestamp": "2026-08-10T10:58:14Z",
      "last_time": 1786359494,
      "last_message_type": "pool",
      "last_message_sender": {
        "id": "79990000002@c.us",
        "number": "79990000002",
        "pushname": "Имя отправителя",
        "isMe": true
      },
      "last_message_data": "pool",
      "name": "Имя контакта",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "is_wappi_pinned": false,
      "is_wappi_archived": false,
      "wappi_tags": []
    }
  ],
  "total_count": 2
}

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

URL: https://wappi.pro/api/sync/chats/days/get?profile_id={{profile_id}}&offset=1&limit=2&order=desc&is_archived=false&is_deleted=false

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

Получение списка всех чатов в подключенном аккаунте Whatsapp по дням, в зависимости от даты последнего сообщения в чате.

Query Params

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

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

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

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

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

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

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

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786439456,
  "time": "2026-08-11T12:10:56+03:00",
  "detail": "Chats fetched",
  "dialogs": [
    {
      "id": "79990000001@c.us",
      "contact": {
        "Found": true,
        "FirstName": "Имя контакта 1",
        "FullName": "Имя контакта 1",
        "PushName": "Contact1",
        "BusinessName": "",
        "RedactedPhone": ""
      },
      "chat": {
        "VerifiedName": null,
        "Status": "",
        "PictureID": "",
        "Devices": null,
        "LID": ""
      },
      "group": null,
      "isGroup": false,
      "image": "",
      "thumbnail": "https://fs.wappi.pro/fs/downloadFile/a1b2c3d4-e5f6/avatars/tumb_79990000001.jpg",
      "avatar_updated_at": 1785839510,
      "last_message_delivery_status": "read",
      "last_message_id": "3EB0000000000000000001",
      "last_timestamp": "2026-08-10T10:58:14Z",
      "last_time": 1786359494,
      "last_message_type": "pool",
      "last_message_sender": {
        "id": "79990000003@c.us",
        "number": "79990000003",
        "pushname": "Имя отправителя",
        "isMe": true
      },
      "last_message_data": "pool",
      "name": "Имя контакта 1",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "is_wappi_pinned": false,
      "is_wappi_archived": false,
      "wappi_tags": []
    },
    {
      "id": "79990000002@c.us",
      "contact": {
        "Found": true,
        "FirstName": "Имя контакта 2",
        "FullName": "Имя контакта 2",
        "PushName": "Contact2",
        "BusinessName": "",
        "RedactedPhone": ""
      },
      "chat": {
        "VerifiedName": null,
        "Status": "",
        "PictureID": "",
        "Devices": null,
        "LID": ""
      },
      "group": null,
      "isGroup": false,
      "image": "",
      "thumbnail": "https://fs.wappi.pro/fs/downloadFile/a1b2c3d4-e5f6/avatars/tumb_79990000002.jpg",
      "avatar_updated_at": 1785839504,
      "last_message_delivery_status": "delivered",
      "last_message_id": "3EB0000000000000000002",
      "last_timestamp": "2026-08-10T10:57:52Z",
      "last_time": 1786359472,
      "last_message_type": "image",
      "last_message_sender": {
        "id": "79990000003@c.us",
        "number": "79990000003",
        "pushname": "Имя отправителя",
        "isMe": true
      },
      "last_message_data": "image",
      "name": "Имя контакта 2",
      "unread_count": 0,
      "wapi_unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "is_wappi_pinned": false,
      "is_wappi_archived": false,
      "wappi_tags": []
    }
  ],
  "total_count": 2
}

POSTАрхивировать чат/api/sync/chat/archive

URL: https://wappi.pro/api/sync/chat/archive?profile_id={{profile_id}}

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

Метод архивирует указанный чат WhatsApp.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Да	Номер телефона участника чата, который необходимо архивировать. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79110000000`.

Query Params

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

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

Headers

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

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

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

{
  "recipient": "79110000000"
}

Responses

Архивировать чат200

{
  "status": "done",
  "timestamp": 1786439805,
  "time": "2026-08-11T12:16:45+03:00",
  "task_id": "3d69cc880f2cf4980181c267b5e46baf",
  "uuid": "5efde003-d699"
}

POSTРазархивировать чат/api/sync/chat/unarchive

URL: https://wappi.pro/api/sync/chat/unarchive?profile_id={{profile_id}}

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

Метод разархивирует указанный чат WhatsApp.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Да	Номер телефона участника чата, который необходимо разархивировать. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79110000000`.

Query Params

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

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

Headers

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

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

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

{
  "recipient": "79110000000"
}

Responses

Разархивировать чат200

{
  "status": "done",
  "timestamp": 1786439919,
  "time": "2026-08-11T12:18:39+03:00",
  "task_id": "c4d09788267d90da1b71568710fe2305",
  "uuid": "5efde003-d699"
}

POSTУдалить чат/api/sync/chat/delete

URL: https://wappi.pro/api/sync/chat/delete?profile_id={{profile_id}}

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Да	Номер телефона участника чата, который необходимо удалить. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79110000000`.

Query Params

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

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

Headers

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

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

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

{
  "recipient": "79110000000"
}

Responses

Удалить чат200

{
  "status": "done",
  "timestamp": 1786440286,
  "time": "2026-08-11T12:24:46+03:00",
  "task_id": "5159fd4f697f8737a8e23bab9e6a48c2",
  "uuid": "5efde003-d699"
}

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

URL: https://wappi.pro/api/sync/chat/typing/start?profile_id={{profile_id}}

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

Метод позволяет установить статус "печатает". Если не останавливать, то длится 20 секунд, затем снимается самим Whatsapp.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Да	Получатель сообщения (кто будет видеть "печатает..." в диалоге). Допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Например: 79110000000.

Query Params

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

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

Headers

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

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

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

{
  "recipient": "79110000000"
}

Responses

Установить статус "печатает"200

{
  "status": "done",
  "timestamp": 1786440560,
  "time": "2026-08-11T12:29:20+03:00",
  "task_id": "b2e9763deca0acd286333862ee0efc66",
  "uuid": "5efde003-d699"
}

POSTСнять статус "печатает"/api/sync/chat/typing/stop

URL: https://wappi.pro/api/sync/chat/typing/stop?profile_id={{profile_id}}

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

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

Request Body

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

Query Params

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

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

Headers

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

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

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

{
  "recipient": "79110000000"
}

Responses

Снять статус "печатает"200

{
  "status": "done",
  "timestamp": 1786440654,
  "time": "2026-08-11T12:30:54+03:00",
  "task_id": "56af9d8a0088a4e849e554aa3bdf5afc",
  "uuid": "5efde003-d699"
}

POSTПереименовать чат/api/sync/chat/rename

URL: https://wappi.pro/api/sync/chat/rename?profile_id={{profile_id}}

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

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

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
chat_id	string	Да	Идентификатор чата, название которого необходимо изменить. Пример: `"123456789"`
name	string	Да	Новое название чата. Пример: `"Новое название"`

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

Query Params

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

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

Headers

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

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

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

{
  "chat_id": "150792141049893@lid",
  "name": "Новое название"
}

Responses

Переименовать чат200

{
  "status": "done"
}

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

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

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

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

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

Query Params

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

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

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786456504,
  "time": "2026-08-11T16:55:04+03:00",
  "contacts": [
    {
      "id": "79990000001@c.us",
      "number": "79990000001",
      "is_business": false,
      "name": "Имя контакта 1",
      "pushname": "Contact1",
      "short_name": "",
      "business_name": ""
    },
    {
      "id": "79990000002@c.us",
      "number": "79990000002",
      "is_business": false,
      "name": "Имя контакта 2",
      "pushname": "Contact2",
      "short_name": "",
      "business_name": ""
    }
  ],
  "task_id": "a1b2c3d4e5f6478890abcdef12345678",
  "uuid": "a1b2c3d4-e5f6"
}

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

URL: https://wappi.pro/api/sync/contact/get?profile_id={{profile_id}}&recipient=79110000000

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

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

Query Params

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

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

recipient79110000000Обязательный параметр. Для ввода доступны форматы: ID контакта. Пример: 13475634251@c.us; Номер телефона. Пример: 79002224477. Номер должен начинаться с кода страны. Для России и Казахстана это всегда 7, затем 10 цифр. Сообщения на номера телефона с 8 не будут доставлены.

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786456650,
  "time": "2026-08-11T16:57:30+03:00",
  "contact": {
    "id": "79990000001@c.us",
    "number": "79990000001",
    "is_business": false,
    "name": "Имя контакта",
    "pushname": "Contact",
    "short_name": "",
    "business_name": ""
  },
  "task_id": "a1b2c3d4e5f6478890abcdef12345678",
  "uuid": "a1b2c3d4-e5f6"
}

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

URL: https://wappi.pro/api/sync/contact/check?profile_id={{profile_id}}&phone=79110000000

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

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

Query Params

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

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

phone79110000000Обязательный параметр. Для ввода доступны форматы: ID контакта. Пример: 13475634251@c.us; Номер телефона. Пример: 79002224477. Номер должен начинаться с кода страны. Для России и Казахстана это всегда 7, затем 10 цифр. Сообщения на номера телефона с 8 не будут доставлены.

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1784210655,
  "time": "2026-07-16T17:04:15+03:00",
  "on_whatsapp": true,
  "phone": "79110000000@c.us",
  "chat_id": "21225800000000@lid",
  "task_id": "44337a88ef13c205b2c45129e29a7ddf",
  "uuid": "5efde003-d699"
}

GETПолучить информацию о номере или группе/api/sync/contact/info

URL: https://wappi.pro/api/sync/contact/info?profile_id={{profile_id}}&user_id=79110000000

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

Получение информации, включая аватар и его превью, о любом номере или группе в Whatsapp (не обязательно из контактов).

Query Params

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

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

user_id79110000000Обязательный параметр. Для ввода доступны форматы: ID контакта. Пример: 13475634251@c.us; Номер телефона. Пример: 79002224477. Номер должен начинаться с кода страны. Для России и Казахстана это всегда 7, затем 10 цифр. Сообщения на номера телефона с 8 не будут доставлены. ID группы. Пример: 120363026575789262@g.us

Headers

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

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

Responses

Получить информацию о номере или группе200

{
  "status": "done",
  "timestamp": 1786457009,
  "time": "2026-08-11T17:03:29+03:00",
  "profile": {
    "is_on_whatsapp": true,
    "id": "79990000001@c.us",
    "user": {
      "79990000001@c.us": {
        "VerifiedName": null,
        "Status": " ",
        "PictureID": "1234567890",
        "Devices": [
          "79990000001@c.us"
        ],
        "LID": "21225800000000@lid"
      }
    },
    "contact": {
      "Found": true,
      "FirstName": "Имя контакта",
      "FullName": "Имя контакта",
      "PushName": "Contact",
      "BusinessName": "",
      "RedactedPhone": ""
    }
  },
  "task_id": "a1b2c3d4e5f6478890abcdef12345678",
  "uuid": "a1b2c3d4-e5f6"
}

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

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

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

Метод добавляет новый контакт в подключённый аккаунт WhatsApp.

Request Body

Параметр	Тип	Обязательный	Описание
`recipient`	string	Да	Номер телефона добавляемого контакта. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками, дефисами). Например: `79110000000`.
`name`	string	Да	Имя добавляемого контакта. Например: `"Света"`.

Query Params

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

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

Headers

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

Authorization{{Token}}—

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

{
  "recipient": "79110000000",
  "name": "Name"
}

Responses

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

{
  "status": "done",
  "timestamp": 1786456348,
  "time": "2026-08-11T16:52:28+03:00",
  "task_id": "b343ba5a66dd6da7b8dfacb43ac8b23d",
  "uuid": "5efde003-d699"
}

POSTПереименовать контакт/api/sync/contact/rename

URL: https://wappi.pro/api/sync/contact/rename?profile_id={{profile_id}}

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

Метод предназначен для изменения имени контакта

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Условно	Контакт. В качестве значения можно указать номер телефона, идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Примеры: `"79115556677"`, `"79110000000@c.us"`
phone	string	Условно	Номер телефона контакта. Допускаются различные форматы записи (со знаком `+`, пробелами, скобками и дефисами). Используется для поиска контакта. Пример: `"79991234567"`
name	string	Да	Новое имя контакта. Пример: `"Иван"`
last_name	string	Нет	Новая фамилия контакта. Пример: `"Иванов"`

Условия обязательности: необходимо передать хотя бы один из параметров: recipient или phone.

Query Params

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

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

Headers

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

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

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

{
    "phone": "79110000000",
    // "recipient": "",
    "name": "Новое имя",
    "last_name": "Новая фамилия"
}

Responses

Переименовать контакт200

{
  "status": "done"
}

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

GETСсылка для приглашения в группу/api/sync/group/invitelink/get

URL: https://wappi.pro/api/sync/group/invitelink/get?profile_id={{profile_id}}&group_id=120363426669543973@g.us

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

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

Query Params

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

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

group_id120363426669543973@g.usОбязательный параметр. ID группы

Headers

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

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

Responses

Ссылка для приглашения в группу200

{
  "status": "done",
  "timestamp": 1786458155,
  "time": "2026-08-11T17:22:35+03:00",
  "detail": "https://chat.whatsapp.com/DlF2MhERkcLJpcniyDoUxZ",
  "task_id": "d7e1cfd5ea81c649f672a986792bb778",
  "uuid": "5efde003-d699"
}

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

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

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

Метод создаёт новую группу WhatsApp с указанным названием и добавляет в неё переданных участников.

Request Body

Параметр	Тип	Обязательный	Описание
`name`	string	Да	Название создаваемой группы. Например: `"Тестовая группа"`.
`participants`	array of strings	Да	Массив номеров телефонов участников, которых необходимо добавить в группу. Например: `["79110000000"]`.

Query Params

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

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

Headers

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

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

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786457964,
  "time": "2026-08-11T17:19:24+03:00",
  "result": {
    "JID": "120363400000000000@g.us",
    "OwnerJID": "21225800000001@lid",
    "OwnerPN": "79990000001@c.us",
    "Name": "Тестовая группа",
    "NameSetAt": "2026-08-11T17:19:23+03:00",
    "NameSetBy": "21225800000001@lid",
    "NameSetByPN": "79990000001@c.us",
    "Topic": "",
    "TopicID": "",
    "TopicSetAt": "0001-01-01T00:00:00Z",
    "TopicSetBy": "",
    "TopicSetByPN": "",
    "TopicDeleted": false,
    "IsLocked": false,
    "IsAnnounce": false,
    "AnnounceVersionID": "",
    "IsEphemeral": false,
    "DisappearingTimer": 0,
    "IsIncognito": false,
    "IsParent": false,
    "DefaultMembershipApprovalMode": "",
    "LinkedParentJID": "",
    "IsDefaultSubGroup": false,
    "IsJoinApprovalRequired": false,
    "AddressingMode": "lid",
    "GroupCreated": "2026-08-11T17:19:23+03:00",
    "CreatorCountryCode": "",
    "ParticipantVersionID": "",
    "Participants": [
      {
        "JID": "21225800000001@lid",
        "PhoneNumber": "79990000001@c.us",
        "LID": "21225800000001@lid",
        "IsAdmin": true,
        "IsSuperAdmin": true,
        "DisplayName": "",
        "Error": 0,
        "AddRequest": null
      },
      {
        "JID": "21225800000002@lid",
        "PhoneNumber": "79990000002@c.us",
        "LID": "21225800000002@lid",
        "IsAdmin": false,
        "IsSuperAdmin": false,
        "DisplayName": "",
        "Error": 0,
        "AddRequest": null
      }
    ],
    "ParticipantCount": 0,
    "MemberAddMode": "admin_add",
    "Suspended": false
  },
  "task_id": "a1b2c3d4e5f6478890abcdef12345678",
  "uuid": "a1b2c3d4-e5f6"
}

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

URL: https://wappi.pro/api/sync/group/leave?profile_id={{profile_id}}&group_id=120363426669543973@g.us

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

Выход из группы.

Query Params

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

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

group_id120363426669543973@g.usОбязательный параметр. Указывается id группы, из которой надо выйти.

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786458992,
  "time": "2026-08-11T17:36:32+03:00",
  "task_id": "8fecd03fa02ce3b1861fdd1079620bf3",
  "uuid": "5efde003-d699"
}

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

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

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`group_id`	string	Да	Уникальный идентификатор группы WhatsApp. Например: `120363426669543973@g.us`.
`participants`	array of strings	Да	Массив номеров телефонов участников, которых необходимо добавить в группу. Например: `["79110000000", "79210000000"]`.

Query Params

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

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

Headers

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

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

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

{
  "group_id": "120363426669543973@g.us",
  "participants": [
    "79110000000",
    "79210000000"
  ]
}

Responses

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

{
  "status": "done",
  "timestamp": 1786458315,
  "time": "2026-08-11T17:25:15+03:00",
  "task_id": "afcf146897af199a9cada61691a8f776",
  "uuid": "5efde003-d699"
}

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

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

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`group_id`	string	Да	Уникальный идентификатор группы WhatsApp. Например: `120363426669543973@g.us`.
`participant`	string	Да	Номер телефона участника, которого необходимо удалить из группы. Например: `79110000000`.

Query Params

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

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

Headers

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

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

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

{
  "group_id": "120363426669543973@g.us",
  "participant": "79110000000"
}

Responses

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

{
  "status": "done",
  "timestamp": 1786458825,
  "time": "2026-08-11T17:33:45+03:00",
  "task_id": "54ddfbd091115e17c0b1374127c83229",
  "uuid": "5efde003-d699"
}

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

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

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

Метод назначает указанного участника администратором группы WhatsApp.

Request Body

Параметр	Тип	Обязательный	Описание
`group_id`	string	Да	Уникальный идентификатор группы WhatsApp. Например: `120363426669543973@g.us`.
`participant`	string	Да	Номер телефона участника, которого необходимо назначить администратором группы. Например: `79110000000`.

Query Params

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

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

Headers

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

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

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

{
  "group_id": "120363426669543973@g.us",
  "participant": "79110000000"
}

Responses

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

{
  "status": "done",
  "timestamp": 1786458458,
  "time": "2026-08-11T17:27:38+03:00",
  "task_id": "5a15c0b26ae5270fd9cc6bcee0b5e446",
  "uuid": "5efde003-d699"
}

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

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

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`group_id`	string	Да	Уникальный идентификатор группы WhatsApp. Например: `120363426669543973@g.us`.
`participant`	string	Да	Номер телефона участника, у которого необходимо снять права администратора группы. Например: `79110000000`.

Query Params

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

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

Headers

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

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

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

{
  "group_id": "120363426669543973@g.us",
  "participant": "79110000000"
}

Responses

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

{
  "status": "done",
  "timestamp": 1786458540,
  "time": "2026-08-11T17:29:00+03:00",
  "task_id": "c79f8ebe2ef412503885604c3517c1a8",
  "uuid": "5efde003-d699"
}

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

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

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`group_id`	string	Да	Уникальный идентификатор группы WhatsApp. Например: `120363426669543973@g.us`.
`description`	string	Да	Новое описание группы. Например: `"Тестовое описание группы"`.

Query Params

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

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

Headers

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

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

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

{
  "group_id": "120363426669543973@g.us",
  "description": "Тестовое описание группы"
}

Responses

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

{
  "status": "done",
  "timestamp": 1786458642,
  "time": "2026-08-11T17:30:42+03:00",
  "task_id": "f8795bf36a70a44b6a99c340a58c2eae",
  "uuid": "5efde003-d699"
}

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

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

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`group_id`	string	Да	Уникальный идентификатор группы WhatsApp. Например: `120363426669543973@g.us`.
`name`	string	Да	Новое имя группы. Например: `"Тестовое имя группы"`.

Query Params

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

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

Headers

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

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

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

{
  "group_id": "120363426669543973@g.us",
  "name": "Тестовое имя группы"
}

Responses

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

{
  "status": "done",
  "timestamp": 1786458733,
  "time": "2026-08-11T17:32:13+03:00",
  "task_id": "d7cb6500c632ab17f58a73d797062780",
  "uuid": "5efde003-d699"
}

Работа с аккаунтом3 метода

POSTУстановить сведения (ранее Статус)/api/sync/status/set

URL: https://wappi.pro/api/sync/status/set?profile_id={{profile_id}}

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

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

Request Body

Параметр	Тип	Обязательный	Описание
`body`	string	Да	Текст сведений, который необходимо установить. Например: `"Статус"`.

Query Params

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

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

Headers

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

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

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

{
  "body": "Статус"
}

Responses

Установить сведения (ранее Статус)200

{
  "status": "done",
  "timestamp": 1786522907,
  "time": "2026-08-12T11:21:47+03:00",
  "task_id": "0825e54f2c1d5c50ca8656336e6e4eb8",
  "uuid": "5efde003-d699"
}

POSTУдалить сведения (ранее Статус)/api/sync/status/delete

URL: https://wappi.pro/api/sync/status/delete?profile_id={{profile_id}}

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

Метод позволяет удалить текст из Сведений, ранее это называлось Статус.

Query Params

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

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

Headers

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

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

Responses

Удалить сведения (ранее Статус)200

{
  "status": "done",
  "timestamp": 1786523698,
  "time": "2026-08-12T11:34:58+03:00",
  "task_id": "26644fca5226b4c82ec57e28146f9589",
  "uuid": "5efde003-d699"
}

POSTДобавить статус (Сторис)/api/async/story/send

URL: https://wappi.pro/api/async/story/send?profile_id={{profile_id}}

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

Метод позволяет добавить статус (сторис). Может состоять из текста, фото, видео, фото с текстом, видео с текстом.

Request Body

Параметр	Тип	Обязательный	Описание
`body`	string	Условно	Текст статуса. Может использоваться как самостоятельный текстовый статус или как подпись к изображению или видео. Например: `"Тестовый статус"`.
`url`	string	Условно	Прямая ссылка на изображение или видео, которое необходимо опубликовать в статусе.

Query Params

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

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

Headers

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

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

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

{
  "body": "justskinproducts",
  "url": "https://www.justskinproducts.co.za/wp-content/uploads/2025/08/Update3.jpeg"
}

Responses

Добавить статус (Сторис)200

{
  "status": "done",
  "timestamp": 1786526356,
  "time": "2026-08-12T12:19:16+03:00",
  "detail": "Story sent to queue",
  "task_id": "ee8620622319aef323ea3cf9a2ba13db"
}

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

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

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

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

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

Query Params

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

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

Headers

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

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

Responses

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

{
  "detail": "WebHook установлен на адрес https://webhook.site/7c7c1601-84ed-40eb-b074-f07ceb4641b3",
  "status": "done",
  "url": "https://webhook.site/7c7c1601-84ed-40eb-b074-f07ceb4641b3",
  "auth": "",
  "installed": true
}

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

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

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

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

Query Params

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

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

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

authStrongPasswordНеобязательный параметр. Можно установить секретную фразу в заголовке Webhook

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786523960,
  "time": "2026-08-12T11:39:20+03:00",
  "task_id": "45a0f17db156b0c2b6e594c0457d8c46",
  "uuid": "5efde003-d699"
}

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

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

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

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

Query Params

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

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

Headers

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

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

Responses

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

{
  "status": "done",
  "timestamp": 1786524017,
  "time": "2026-08-12T11:40:17+03:00",
  "task_id": "4e1ce82d9e414dd3988697855f4f278d",
  "uuid": "5efde003-d699"
}

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

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

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

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

Request Body

Тип данных	Обяз.	Описание
array of 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": 1786524001,
  "time": "2026-08-12T11:40:01+03:00",
  "task_id": "374a04dfe0c69fff02ae69c1b00c0586",
  "uuid": "5efde003-d699"
}

Работа с proxy3 метода

GETПолучить proxy/api/proxy/get

URL: https://wappi.pro/api/proxy/get?profile_id={{profile_id}}

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

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

Query Params

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

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

Headers

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

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

Responses

Получить proxy200

{
  "proxy": null,
  "status": "done"
}

POSTУстановить proxy/api/proxy/set

URL: https://wappi.pro/api/proxy/set?profile_id={{profile_id}}&proxy=azeQTk:cWJfaW@192.109.91.126:8000

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

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

Query Params

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

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

proxyazeQTk:cWJfaW@192.109.91.126:8000Обязательный параметр. Подходят только https/http прокси в формате `login:password@ip:port` или `ip:port`. Установить можно только рабочий прокси

Headers

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

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

POSTУдалить proxy/api/proxy/delete

URL: https://wappi.pro/api/proxy/delete?profile_id={{profile_id}}

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

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

Query Params

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

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

Headers

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

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

Responses

Удалить proxy200

{
  "detail": "Self proxy deleted",
  "status": "done"
}

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

GETПолучить очередь сообщений у профиля/api/profile/queue/get

URL: https://wappi.pro/api/profile/queue/get?profile_id={{profile_id}}

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

Получение очереди сообщений у профиля.

Query Params

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

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

Headers

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

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

Responses

Получить очередь сообщений у профиля200

{
  "status": "done",
  "tasks": [
    {
      "task_id": "e543da5e-6f3f-4e42-b084-852f6410db18",
      "timeout_from": 20,
      "timeout_to": 40,
      "command_start": "2023-03-26T13:05:02.771217149+03:00",
      "command": "sendMessage",
      "recipient": "79115576367@c.us",
      "uuid": "71ad40e9-b023",
      "body": "тестовое сообщение асинхронно",
      "response": null,
      "is_first": true
    }
  ]
}

GETОчистить очередь сообщений у профиля/api/profile/queue/purge

URL: https://wappi.pro/api/profile/queue/purge?profile_id={{profile_id}}

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

Очистка очереди сообщений у профиля.

Query Params

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

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

Headers

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

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

Responses

Очистить очередь сообщений у профиля200

{
  "status": "done"
}

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

URL: https://wappi.pro/api/task/get?profile_id={{profile_id}}&task_id=ef7076ef3950ee034233124424413a77

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

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

Query Params

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

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

task_idef7076ef3950ee034233124424413a77Обязательный параметр. Task_id можно получить в ответах в методах по отправке сообщений.

Headers

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

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

Responses

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

{
  "status": "done",
  "task": {
    "task_id": "ef7076ef3950ee034233124424413a77",
    "command_start": "2026-08-10T10:55:18.192Z",
    "command": "replyMessage",
    "uuid": "5efde003-d699",
    "body": "тестовый ответ на сообщение",
    "stanza_id": "3EB06267BB02054ABBB757",
    "response": {
      "status": "done",
      "timestamp": 1786359319,
      "time": "2026-08-10T13:55:19+03:00",
      "detail": "",
      "task_id": "ef7076ef3950ee034233124424413a77",
      "command_start": "2026-08-10T10:55:18.192Z",
      "command_end": "2026-08-10T10:55:19.705Z",
      "uuid": "5efde003-d699",
      "message_id": "3EB0975C6B74EB42CF941B",
      "delivery_status": "delivered"
    },
    "url": "https://freetestdata.com/wp-content/uploads/2022/02/Free_Test_Data_117KB_JPG.jpg",
    "filter": {},
    "wappi_bot_id": "test",
    "manager": {
      "id": "38200203",
      "name": "Светлана",
      "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
      "description": "описание пример"
    },
    "timeout_from": 1,
    "timeout_to": 3
  }
}

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

URL: https://wappi.pro/api/tasks/get?profile_id={{profile_id}}

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

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

Query Params

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

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

Headers

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

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

Responses

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

{
  "status": "done",
  "tasks": [
    {
      "task_id": "a0000000000000000000000000000001",
      "command_start": "2026-08-12T08:49:04.608Z",
      "command": "sendVideo",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "video/mp4",
      "caption": "Это видео",
      "response": {
        "status": "done",
        "timestamp": 1786524553,
        "time": "2026-08-12T11:49:13+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000001",
        "command_start": "2026-08-12T08:49:04.608Z",
        "command_end": "2026-08-12T08:49:13.731Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000001",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000002",
      "command_start": "2026-08-12T08:44:56.875Z",
      "command": "sendVideo",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "video/mp4",
      "caption": "Это видео",
      "response": {
        "status": "done",
        "timestamp": 1786524297,
        "time": "2026-08-12T11:44:57+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000002",
        "command_start": "2026-08-12T08:44:56.875Z",
        "command_end": "2026-08-12T08:44:57.392Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000002",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000003",
      "command_start": "2026-08-12T08:43:29.451Z",
      "command": "sendVideo",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "video/mp4",
      "caption": "Это видео",
      "response": {
        "status": "done",
        "timestamp": 1786524212,
        "time": "2026-08-12T11:43:32+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000003",
        "command_start": "2026-08-12T08:43:29.451Z",
        "command_end": "2026-08-12T08:43:32.241Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000003",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000004",
      "command_start": "2026-08-12T08:43:28.673Z",
      "command": "sendVideo",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "video/mp4",
      "caption": "Это видео",
      "response": {
        "status": "done",
        "timestamp": 1786524210,
        "time": "2026-08-12T11:43:30+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000004",
        "command_start": "2026-08-12T08:43:28.673Z",
        "command_end": "2026-08-12T08:43:30.276Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000004",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000005",
      "command_start": "2026-08-12T08:43:27.786Z",
      "command": "sendVideo",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "video/mp4",
      "caption": "Это видео",
      "response": {
        "status": "done",
        "timestamp": 1786524208,
        "time": "2026-08-12T11:43:28+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000005",
        "command_start": "2026-08-12T08:43:27.786Z",
        "command_end": "2026-08-12T08:43:28.356Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000005",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000006",
      "command_start": "2026-08-12T08:43:12.828Z",
      "command": "sendVideo",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "video/mp4",
      "caption": "Это видео",
      "response": {
        "status": "done",
        "timestamp": 1786524193,
        "time": "2026-08-12T11:43:13+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000006",
        "command_start": "2026-08-12T08:43:12.828Z",
        "command_end": "2026-08-12T08:43:13.511Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000006",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000007",
      "command_start": "2026-08-12T08:42:42.031Z",
      "command": "sendMessage",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "body": "тестовое сообщение асинхронно",
      "response": {
        "status": "done",
        "timestamp": 1786524162,
        "time": "2026-08-12T11:42:42+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000007",
        "command_start": "2026-08-12T08:42:42.031Z",
        "command_end": "2026-08-12T08:42:42.52Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000007",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "manager": {
        "id": "10000001",
        "name": "Имя менеджера",
        "ava_link": "https://example.com/avatar.jpg",
        "description": "Тестовое описание"
      },
      "with_preview": true,
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000008",
      "command_start": "2026-08-10T10:58:14.837Z",
      "command": "createPoll",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "body": "Тестовый опрос",
      "response": null,
      "poll_options": [
        "да",
        "нет",
        "не знаю",
        "где я?"
      ],
      "poll_select_count": 1,
      "filter": {},
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000009",
      "command_start": "2026-08-10T10:57:43.136Z",
      "command": "replyMessage",
      "uuid": "a1b2c3d4-e5f6",
      "body": "тестовый ответ на сообщение",
      "stanza_id": "3EB0000000000000000000",
      "response": {
        "status": "done",
        "timestamp": 1786359472,
        "time": "2026-08-10T13:57:52+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000009",
        "command_start": "2026-08-10T10:57:43.136Z",
        "command_end": "2026-08-10T10:57:52.496Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000008",
        "delivery_status": "delivered"
      },
      "url": "https://example.com/test.jpg",
      "filter": {},
      "wappi_bot_id": "test",
      "manager": {
        "id": "10000001",
        "name": "Имя менеджера",
        "ava_link": "https://example.com/avatar.jpg",
        "description": "Тестовое описание"
      },
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000010",
      "command_start": "2026-08-10T10:57:20.732Z",
      "command": "forwardMessage",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "stanza_id": "3EB0000000000000000000",
      "response": {
        "status": "done",
        "timestamp": 1786359440,
        "time": "2026-08-10T13:57:20+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000010",
        "command_start": "2026-08-10T10:57:20.732Z",
        "command_end": "2026-08-10T10:57:21.003Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000009",
        "delivery_status": "delivered"
      },
      "filter": {},
      "manager": {
        "id": "10000001",
        "name": "Имя менеджера",
        "ava_link": "https://example.com/avatar.jpg",
        "description": "Тестовое описание"
      },
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000011",
      "command_start": "2026-08-10T10:55:18.192Z",
      "command": "replyMessage",
      "uuid": "a1b2c3d4-e5f6",
      "body": "тестовый ответ на сообщение",
      "stanza_id": "3EB0000000000000000000",
      "response": {
        "status": "done",
        "timestamp": 1786359319,
        "time": "2026-08-10T13:55:19+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000011",
        "command_start": "2026-08-10T10:55:18.192Z",
        "command_end": "2026-08-10T10:55:19.705Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000010",
        "delivery_status": "delivered"
      },
      "url": "https://example.com/test.jpg",
      "filter": {},
      "wappi_bot_id": "test",
      "manager": {
        "id": "10000001",
        "name": "Имя менеджера",
        "ava_link": "https://example.com/avatar.jpg",
        "description": "Тестовое описание"
      },
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000012",
      "command_start": "2026-08-10T10:52:10.752Z",
      "command": "forwardMessage",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "stanza_id": "3EB0000000000000000000",
      "response": {
        "status": "done",
        "timestamp": 1786359130,
        "time": "2026-08-10T13:52:10+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000012",
        "command_start": "2026-08-10T10:52:10.752Z",
        "command_end": "2026-08-10T10:52:11.006Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000011",
        "delivery_status": "delivered"
      },
      "filter": {},
      "manager": {
        "id": "10000001",
        "name": "Имя менеджера",
        "ava_link": "https://example.com/avatar.jpg",
        "description": "Тестовое описание"
      },
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000013",
      "command_start": "2026-08-10T10:49:54.438Z",
      "command": "sendContact",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "body": "Имя контакта",
      "phone": "79990000002",
      "response": {
        "status": "done",
        "timestamp": 1786358994,
        "time": "2026-08-10T13:49:54+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000013",
        "command_start": "2026-08-10T10:49:54.438Z",
        "command_end": "2026-08-10T10:49:54.677Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000012",
        "delivery_status": "delivered"
      },
      "filter": {},
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000014",
      "command_start": "2026-08-10T10:45:52.434Z",
      "command": "sendLocation",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "latitude": 55.7558,
      "longitude": 37.6173,
      "address": "Тестовый адрес",
      "response": {
        "status": "done",
        "timestamp": 1786358752,
        "time": "2026-08-10T13:45:52+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000014",
        "command_start": "2026-08-10T10:45:52.434Z",
        "command_end": "2026-08-10T10:45:52.648Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000013",
        "delivery_status": "delivered"
      },
      "filter": {},
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000015",
      "command_start": "2026-08-10T10:41:35.978Z",
      "command": "sendDocument",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "application/pdf",
      "response": {
        "status": "done",
        "timestamp": 1786358496,
        "time": "2026-08-10T13:41:36+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000015",
        "command_start": "2026-08-10T10:41:35.978Z",
        "command_end": "2026-08-10T10:41:36.436Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000014",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000016",
      "command_start": "2026-08-10T10:41:17.287Z",
      "command": "sendDocument",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "application/pdf",
      "response": {
        "status": "done",
        "timestamp": 1786358477,
        "time": "2026-08-10T13:41:17+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000016",
        "command_start": "2026-08-10T10:41:17.287Z",
        "command_end": "2026-08-10T10:41:17.922Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000015",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000017",
      "command_start": "2026-08-10T10:38:59.221Z",
      "command": "sendAudio",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "audio/mpeg",
      "response": {
        "status": "done",
        "timestamp": 1786358339,
        "time": "2026-08-10T13:38:59+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000017",
        "command_start": "2026-08-10T10:38:59.221Z",
        "command_end": "2026-08-10T10:38:59.992Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000016",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000018",
      "command_start": "2026-08-10T10:36:27.343Z",
      "command": "sendVideo",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "video/mp4",
      "caption": "Это видео",
      "response": {
        "status": "done",
        "timestamp": 1786358187,
        "time": "2026-08-10T13:36:27+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000018",
        "command_start": "2026-08-10T10:36:27.343Z",
        "command_end": "2026-08-10T10:36:27.888Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000017",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000019",
      "command_start": "2026-08-10T10:33:19.762Z",
      "command": "sendDocument",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "application/pdf",
      "caption": "Это документ",
      "file_name": "name.pdf",
      "response": {
        "status": "done",
        "timestamp": 1786358000,
        "time": "2026-08-10T13:33:20+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000019",
        "command_start": "2026-08-10T10:33:19.762Z",
        "command_end": "2026-08-10T10:33:20.437Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000018",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    },
    {
      "task_id": "a0000000000000000000000000000020",
      "command_start": "2026-08-10T10:27:08.453Z",
      "command": "sendImg",
      "recipient": "79990000001@c.us",
      "uuid": "a1b2c3d4-e5f6",
      "mime": "image/png",
      "caption": "Это картинка",
      "response": {
        "status": "done",
        "timestamp": 1786357629,
        "time": "2026-08-10T13:27:09+03:00",
        "detail": "",
        "task_id": "a0000000000000000000000000000020",
        "command_start": "2026-08-10T10:27:08.453Z",
        "command_end": "2026-08-10T10:27:09.254Z",
        "uuid": "a1b2c3d4-e5f6",
        "message_id": "3EB0000000000000000019",
        "delivery_status": "delivered"
      },
      "filter": {},
      "wappi_bot_id": "test",
      "timeout_from": 1,
      "timeout_to": 3
    }
  ]
}

Массовая рассылка6 методов

POSTЗапустить рассылку Start/broadcast/init

URL: https://wappi.pro/broadcast/init?profile_id={{profile_id}}

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

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

В рамках одной рассылки можно отправить текстовое сообщение, изображение или файл сразу нескольким получателям. В качестве получателей могут использоваться номера телефонов, имена пользователей (username), идентификаторы пользователей или идентификаторы чатов, если это поддерживается используемой платформой.

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

После успешного запуска создаётся задача рассылки и возвращается информация о созданной кампании, включая её идентификатор, количество получателей и текущий статус.

Query Params

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

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

Headers

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

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

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

mass_text: Текст сообщения - отложен
mass_phones: 79000000000
79000000000
79000000000
mass_image: file
mass_timeout_from: 5
mass_timeout_to: 8
base64: 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
file_name: картинка
send_after: 2025-05-28T15:17+03:00
schedule: {
  "isActive": true,
  "week": [
    {
      "title": "Понедельник",
      "enable": true,
      "daynumber": 0,
      "worktime": [
        {
          "start": "20:00",
          "end": "21:00"
        }
      ]
    },
    {
      "title": "Вторник",
      "enable": true,
      "daynumber": 1,
      "worktime": [
        {
          "start": "20:00",
          "end": "21:00"
        }
      ]
    },
    {
      "title": "Среда",
      "enable": true,
      "daynumber": 2,
      "worktime": [
        {
          "start": "20:00",
          "end": "21:00"
        }
      ]
    },
    {
      "title": "Четверг",
      "enable": true,
      "daynumber": 3,
      "worktime": [
        {
          "start": "20:00",
          "end": "21:00"
        }
      ]
    },
    {
      "title": "Пятница",
      "enable": true,
      "daynumber": 4,
      "worktime": [
        {
          "start": "20:00",
          "end": "21:00"
        }
      ]
    },
    {
      "title": "Суббота",
      "enable": true,
      "daynumber": 5,
      "worktime": [
        {
          "start": "20:00",
          "end": "23:00"
        }
      ]
    },
    {
      "title": "Воскресенье",
      "enable": true,
      "daynumber": 6,
      "worktime": [
        {
          "start": "20:00",
          "end": "23:00"
        }
      ]
    }
  ]
}

current_time: 2025-05-28T15:17+03:00

Responses

Запустить рассылку Start200

{
  "status": "done",
  "timestamp": 1781187491,
  "time": "2026-06-11T17:18:11+03:00",
  "detail": "Рассылка запущена",
  "posting": {
    "active": 3,
    "messages_count": 3,
    "profile_id": 10000000,
    "profile_uuid": "",
    "platform": "",
    "user_id": 100000,
    "mass_posting_id": "b51cc198-a0db-4c",
    "profile_name": "test",
    "created_at": "11.06.2026 17:18:10",
    "have_consumer": true,
    "send_time": "2026-06-11T17:18:10.894572499+03:00",
    "is_delayedStart": false,
    "is_onDiary": false,
    "is_paused": false
  }
}

GETПриостановить рассылку Pause/broadcast/pause

URL: https://wappi.pro/broadcast/pause?profile_id={{profile_id}}&mass_posting_id=e1b35b69-b35e-4d

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

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

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

Query Params

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

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

mass_posting_ide1b35b69-b35e-4dОбязательный параметр. ID рассылки, которую необходимо приостановить. Значение возвращается при создании рассылки или доступно в адресной строке в UI (значение ?id=)

Headers

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

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

Responses

Приостановить рассылку Pause200

{
  "detail": "Mass posting paused",
  "status": "done"
}

GETВозобновить рассылку Resume/broadcast/start

URL: https://wappi.pro/broadcast/start?profile_id={{profile_id}}&mass_posting_id=e1b35b69-b35e-4d

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

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

После выполнения запроса рассылка продолжит отправку сообщений с того места, на котором была остановлена. Уже отправленные сообщения повторно не отправляются.

Query Params

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

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

mass_posting_ide1b35b69-b35e-4dОбязательный параметр. ID рассылки, которую необходимо возобновить. Значение возвращается при создании рассылки или доступно в адресной строке в UI (значение ?id=)

Headers

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

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

Responses

Возобновить рассылку Resume200

{
  "detail": "Mass posting started",
  "status": "done"
}

GETЗакрыть рассылку Cancel/broadcast/cancel

URL: https://wappi.pro/broadcast/cancel?profile_id={{profile_id}}&mass_posting_id=e1b35b69-b35e-4d

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

Закрыть рассылку.

Query Params

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

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

mass_posting_ide1b35b69-b35e-4dОбязательный параметр. ID рассылки, которую необходимо отменить. Значение возвращается при создании рассылки или доступно в адресной строке в UI (значение ?id=)

Headers

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

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

Responses

Закрыть рассылку Cancel200

{
  "detail": "Mass posting canceled",
  "status": "done"
}

GETСписок всех рассылок/broadcast/history

URL: https://wappi.pro/broadcast/history?profile_id={{profile_id}}&offset=0&limit=3

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

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

Query Params

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

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

Headers

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

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

Responses

Список всех рассылок200

{
  "all_history_count": 10,
  "all_started_count": 0,
  "consumers": null,
  "mass_posting_history": [
    {
      "profile_uuid": "48affe30-713e",
      "profile_name": "testovi4ok",
      "platform": "",
      "mass_posting_id": "e1b35b69-b35e-4d",
      "done": 0,
      "all": 1,
      "date": "2026-06-11T17:32:47.300736+03:00"
    },
    {
      "profile_uuid": "48affe30-713e",
      "profile_name": "testovi4ok",
      "platform": "",
      "mass_posting_id": "30007edb-4000-4a",
      "done": 0,
      "all": 3,
      "date": "2026-06-11T17:31:38.395868+03:00"
    },
    {
      "profile_uuid": "48affe30-713e",
      "profile_name": "testovi4ok",
      "platform": "",
      "mass_posting_id": "198fad6f-a064-4f",
      "done": 3,
      "all": 3,
      "date": "2026-06-11T17:31:29.7157+03:00"
    }
  ],
  "mass_posting_started": [],
  "status": "done"
}

GETРезультат рассылки/broadcast/messages

URL: https://wappi.pro/broadcast/messages?profile_id={{profile_id}}&mass_posting_id=bf0718c6-2610-44&offset=0&limit=100

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

Метод предназначен для получения подробной информации о конкретной массовой рассылке.

Query Params

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

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

mass_posting_idbf0718c6-2610-44Обязательный параметр. ID рассылки, результаты которой необходимо получить. Значение возвращается при создании рассылки или доступно в адресной строке в UI (значение ?id=)

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

Headers

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

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

Responses

Результат рассылки200

{
  "status": "done",
  "detail": [
    {
      "delivered": "delivered",
      "recipient": "79000000000",
      "message": "Текст сообщения",
      "caption": "",
      "created_at": "2026-06-11T14:31:47.056Z",
      "task_name": "sendMessage",
      "profile": {
        "name": "testTG",
        "uuid": "48affe30-713e",
        "platform": "tg"
      },
      "task_id": "c84541c8-681e-43ae-848f-39b4b6ad07d5"
    },
    {
      "delivered": "delivered",
      "recipient": "79000000000",
      "message": "Текст сообщения",
      "caption": "",
      "created_at": "2026-06-11T14:31:38.02Z",
      "task_name": "sendMessage",
      "profile": {
        "name": "testTG",
        "uuid": "48affe30-713e",
        "platform": "tg"
      },
      "task_id": "ba82af8c-51d0-41e0-9d58-90037ed3a8c0"
    },
    {
      "delivered": "delivered",
      "recipient": "79000000000",
      "message": "Текст сообщения",
      "caption": "",
      "created_at": "2026-06-11T14:31:29.02Z",
      "task_name": "sendMessage",
      "profile": {
        "name": "testTG",
        "uuid": "48affe30-713e",
        "platform": "tg"
      },
      "task_id": "62eae084-d9d0-44a3-9c00-c5ca0b076fcf"
    }
  ],
  "all_messages_count": 3
}

Каскады6 методов

POSTОтправить сообщение каскадом/csender/cascade/send

URL: https://wappi.pro/csender/cascade/send

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

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

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

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
recipient	string	Да	Номер телефона получателя, на который будет выполнена отправка через каскад. Допускаются различные форматы записи номера телефона (со знаком `+`, пробелами, скобками и дефисами). Примеры: `"79115556677"`, `"+7 (911) 555-66-77"`
body	string	Да*	Текст сообщения. Поддерживаются переносы строк и emoji. Пример: `"Тестовое сообщение"`
caption	string	Нет	Подпись к вложению. Используется при отправке медиафайла. Пример: `"Описание файла"`
cascade_id	string	Да	Идентификатор каскада, через который необходимо выполнить отправку сообщения. Пример: `"94b1f524059b29e514ef"`
file_name	string	Нет	Имя файла, которое будет отображаться получателю. Используется при отправке вложения по ссылке. Примеры: `"image.jpg"`, `"document.pdf"`
url	string	Да*	Прямая ссылка на файл, который необходимо отправить получателю. Пример: `"https://example.com/file.jpg"`

Обязателен как минимум один из атрибутов

Headers

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

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

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

{
  "recipient": "79000000000",
  "body": "Test",
  "caption": "Подпись",
  "cascade_id": "f65e1ad54ea8a97c3271",
  "file_name": "",
  "url": "https://i.pinimg.com/originals/00/cc/0f/00cc0f951851943cef0df2ab42776cee.jpg?nii=t"
}

Responses

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

{
  "response": {
    "status": "done",
    "timestamp": 1781255242,
    "time": "2026-06-12T12:07:22+03:00",
    "detail": "Message sent to queue",
    "task_id": "6c8f2f47a4630bb18b4aeab2c1b4f125",
    "command_start": "0001-01-01T00:00:00Z",
    "command_end": "0001-01-01T00:00:00Z",
    "uuid": ""
  },
  "status": "ok"
}

POSTСоздать каскад/csender/cascade/create

URL: https://wappi.pro/csender/cascade/create

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

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

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
name	string	Да	Название каскада. Пример: `"Cascade Test"`
description	string	Нет	Описание каскада. Пример: `"Тестовое описание каскада"`
order	array	Да	Массив этапов каскада в порядке выполнения.
order.id	integer	Да	Порядковый номер этапа каскада. Пример: `1`
order.profile_uuid	string	Да	Идентификатор профиля, через который будет выполняться отправка на данном этапе.
order.platform	string	Да	Платформа профиля. Возможные значения зависят от используемых каналов. Примеры: `"tg"`, `"wz"`, `"max"`

Headers

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

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

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

{
  "name": "CascadeTestNew",
  "description": "тестовое описание каскада",
  "order": [
    {
      "id": 1,
      "profile_uuid": "15396b7f-4263",
      "platform": "max"
    },
    {
      "id": 2,
      "profile_uuid": "48affe30-713e",
      "platform": "tg"
    },
    {
      "id": 3,
      "profile_uuid": "d64e106a-65d6",
      "platform": "wz"
    }
  ]
}

Responses

Создать каскад200

{
  "cascade": {
    "cascade_id": "aea42c1f8c4632b8b097",
    "name": "CascadeTestNew",
    "description": "тестовое описание каскада",
    "order": [
      {
        "id": 0,
        "profile_uuid": "15396b7f-4263",
        "platform": "max"
      },
      {
        "id": 1,
        "profile_uuid": "48affe30-713e",
        "platform": "tg"
      }
    ],
    "crm_id": "",
    "crm_type": ""
  },
  "status": "created"
}

POSTРедактировать каскад/csender/cascade/update

URL: https://wappi.pro/csender/cascade/update

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

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

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

Важно. При редактировании каскада параметр order полностью заменяет текущий список этапов. Необходимо передавать полный актуальный список каналов в требуемом порядке. Этапы, отсутствующие в новом массиве order, будут удалены из каскада.

Request Body

Параметр	Тип данных	Обяз.	Описание и пример
cascade_id	string	Да	Идентификатор каскада. Пример: `"6736ebe208b0fd04c84f"`
name	string	Нет	Название каскада. Пример: `"NewCascade"`
description	string	Нет	Описание каскада.
order	array	Нет	Список этапов каскада в порядке выполнения.
order.id	integer	Нет	Порядковый номер этапа каскада. Пример: `1`
order.profile_uuid	string	Нет	Идентификатор профиля, через который будет выполняться отправка на данном этапе.
order.platform	string	Да	Платформа профиля. Примеры: `"tg"`, `"wz"`, `"max"`

Headers

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

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

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

{
  "cascade_id": "d6228696b6c2f36bfd30",
  "name": "NewCascade",
  "description": "",
  "order": [
    {
      "id": 1,
      "profile_uuid": "87529b21-2ace",
      "platform": "tg"
    },
    {
      "id": 2,
      "profile_uuid": "d64e106a-65d6",
      "platform": "wz"
    },
    {
      "id": 3,
      "profile_uuid": "d64e106a-65d6",
      "platform": "max"
    }
  ]
}

Responses

Редактировать каскад200

{
  "cascade": {
    "cascade_id": "d6228696b6c2f36bfd30",
    "name": "NewCascade",
    "description": "",
    "order": [
      {
        "id": 1,
        "profile_uuid": "87529b21-2ace",
        "platform": "tg"
      },
      {
        "id": 2,
        "profile_uuid": "d64e106a-65d6",
        "platform": "wz"
      },
      {
        "id": 3,
        "profile_uuid": "d64e106a-65d6",
        "platform": "max"
      }
    ],
    "crm_id": "",
    "crm_type": ""
  },
  "status": "updated"
}

POSTУдалить каскад/csender/cascade/delete

URL: https://wappi.pro/csender/cascade/delete?cascade_id=aea42c1f8c4632b8b097

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

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

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

Query Params

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

cascade_idaea42c1f8c4632b8b097Обязательный параметр. Идентификатор каскада, который необходимо удалить. Пример: "6736ebe208b0fd04c84f"

Headers

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

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

Responses

Удалить каскад200

{
  "status": "deleted"
}

GETПолучить данные каскада/csender/cascade/get

URL: https://wappi.pro/csender/cascade/get?cascade_id=f65e1ad54ea8a97c3271

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

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

Query Params

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

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

Headers

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

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

Responses

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

{
  "cascade": {
    "cascade_id": "f65e1ad54ea8a97c3271",
    "name": "Название каскада тестовый",
    "description": "",
    "order": [
      {
        "id": 0,
        "profile_uuid": "48affe30-713e",
        "platform": "tg"
      },
      {
        "id": 1,
        "profile_uuid": "15396b7f-4263",
        "platform": "max"
      }
    ],
    "crm_id": "",
    "crm_type": ""
  },
  "status": "ok"
}

GETПолучить данные всех каскадов/csender/cascades/get

URL: https://wappi.pro/csender/cascades/get

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

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

Headers

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

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

Responses

Получить данные всех каскадов200

{
  "cascades": [
    {
      "cascade_id": "f65e1ad54ea8a97c3271",
      "name": "Название каскада тестовый",
      "description": "",
      "order": [
        {
          "id": 0,
          "profile_uuid": "48affe30-713e",
          "platform": "tg"
        },
        {
          "id": 1,
          "profile_uuid": "15396b7f-4263",
          "platform": "max"
        }
      ],
      "crm_id": "",
      "crm_type": ""
    },
    {
      "cascade_id": "d6228696b6c2f36bfd30",
      "name": "NewCascade",
      "description": "",
      "order": [
        {
          "id": 1,
          "profile_uuid": "48affe30-713e",
          "platform": "tg"
        },
        {
          "id": 2,
          "profile_uuid": "df810086-b6f5",
          "platform": "max"
        },
        {
          "id": 3,
          "profile_uuid": "d64e106a-65d6",
          "platform": "max"
        }
      ],
      "crm_id": "",
      "crm_type": ""
    },
    {
      "cascade_id": "6736ebe208b0fd04c84f",
      "name": "NewCascade",
      "description": "",
      "order": [
        {
          "id": 1,
          "profile_uuid": "",
          "platform": "tg"
        },
        {
          "id": 2,
          "profile_uuid": "d64e106a-65d6",
          "platform": "wz"
        },
        {
          "id": 3,
          "profile_uuid": "d64e106a-65d6",
          "platform": "max"
        }
      ],
      "crm_id": "",
      "crm_type": ""
    },
    {
      "cascade_id": "77520bc34d98aca07920",
      "name": "Cascade Test1",
      "description": "тестовое описание каскада",
      "order": [
        {
          "id": 0,
          "profile_uuid": "15396b7f-4263",
          "platform": "max"
        }
      ],
      "crm_id": "",
      "crm_type": ""
    },
    {
      "cascade_id": "2449646d6568e27c4378",
      "name": "Cascade Test1",
      "description": "тестовое описание каскада",
      "order": [
        {
          "id": 0,
          "profile_uuid": "15396b7f-4263",
          "platform": "max"
        }
      ],
      "crm_id": "",
      "crm_type": ""
    },
    {
      "cascade_id": "436efeed775b21ed15d4",
      "name": "Cascade Test1",
      "description": "тестовое описание каскада",
      "order": [
        {
          "id": 0,
          "profile_uuid": "",
          "platform": "max"
        }
      ],
      "crm_id": "",
      "crm_type": ""
    },
    {
      "cascade_id": "aea42c1f8c4632b8b097",
      "name": "NewCascade",
      "description": "",
      "order": [
        {
          "id": 2,
          "profile_uuid": "15396b7f-4263",
          "platform": "max"
        }
      ],
      "crm_id": "",
      "crm_type": ""
    }
  ],
  "status": "ok"
}

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

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

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

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

02Передайте profile_id

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

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

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

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

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

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

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

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

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

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

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

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

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

Работа с аккаунтом3

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

Работа с proxy3

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

Массовая рассылка6

Каскады6

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

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

POST

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

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

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

Query Params

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

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

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

Headers

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

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

Responses

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

{
  "profile_id": "91d1a9f5-1eae",
  "status": "done",
  "time": "2026-08-04T13:19:57+03:00",
  "timestamp": 1785838797
}

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

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

Тест запроса

API token

POSThttps://wappi.pro/api/profile/add?name=%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9&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": "3EB0B9085608CCF26A7607",
    "profile_id": "1955e928-b7b6",
    "wh_type": "delivery_status",
    "timestamp": "2025-10-23T15:45:14+03:00",
    "time": 1761223514,
    "from": "79959640099@c.us",
    "to": "79602041988@c.us",
    "chat_id": "79602041988@c.us",
    "status": "pending",
    "task_id": "47208660-3c55-4ad7-bb1d-ff4427f7a262"
  }
}

Свернуть

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

Есть несколько статусов профиля - online, offline


{
  "messages": [
    {
      "wh_type": "authorization_status",
      "profile_id": "71ad40e9-b023",
      "status": "offline",
      "reason": "logout from api",
      "phone": "79502041990",
      "timestamp": "2023-11-13T17:00:02.57417156+03:00",
      "time": 1699884002
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "application_status",
      "profile_id": "fae370e3-0a1a",
      "status": "online",
      "phone": "966507585521",
      "timestamp": "2024-03-02T15:52:27.996591556+03:00",
      "time": 1709383947
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "6qw54f68-71eq",
      "id": "3A945DD9CDD3016BE11B",
      "body": "Ответ на сообщение",
      "type": "chat",
      "from": "79115576366@c.us",
      "to": "79602041988@c.us",
      "senderName": "Flood",
      "chatId": "79115576366@c.us",
      "timestamp": "2024-10-21T11:27:57+03:00",
      "time": 1729499277,
      "caption": null,
      "from_where": "phone",
      "contact_name": "Максим",
      "is_forwarded": false,
      "isReply": true,
      "is_edited": false,
      "stanza_id": "3A9DA038CF9A2CD87E66",
      "is_me": false,
      "chat_type": "dialog",
      "thumbnail": "https://s3.wappi.pro/wapi-uploads30/6d154f68-71ec/tumb_79115576367.jpg?X-Amz-",
      "picture": "https://s3.wappi.pro/wapi-uploads30/6d154f68-71ec/pic_79115576367.jpg?X-Amz",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false,
      "reply_message": {
        "id": "3A9DA038CF9A2CD87E66",
        "body": "https://wapi-uploads24.storage.yandexcloud.net/bitrix24/6d154f68-71ec/79bf",
        "type": "image",
        "chatId": "",
        "timestamp": "2024-10-21T11:21:33+03:00",
        "time": 0,
        "caption": "Картинка",
        "file_name": "79bf5bb7-ab23-455c-bf5e-42daca555529.jpg",
        "contact_name": ""
      }
    }
  ]
}

Свернуть

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

Обратите внимание, все изображения отдаются в формате base64.


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3EB0CC6709A45F7311FD",
      "body": "/9j/4AAQSkZNQ5JDP/9k=",
      "type": "image",
      "from": "79991940200@c.us",
      "to": "79662041999@c.us",
      "senderName": "Александр Жукин",
      "chatId": "79991940200@c.us",
      "timestamp": "2023-12-05T12:56:45+03:00",
      "time": 1701770205,
      "caption": "Это картинка",
      "from_where": "phone",
      "mimetype": "image/jpeg",
      "contact_name": "Саня Жукин",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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

Обратите внимание, что все видео отдаются в формате base64.


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3EB09F87B9CE13FA0667",
      "body": "AAAAIGZ0eXBtcDQyAAS0vA==",
      "type": "video",
      "from": "79991940200@c.us",
      "to": "79662041999@c.us",
      "senderName": "Александр Жукин",
      "chatId": "79991940200@c.us",
      "timestamp": "2023-12-05T13:01:31+03:00",
      "time": 1701770491,
      "caption": "Это видео",
      "from_where": "phone",
      "mimetype": "video/mp4",
      "contact_name": "Саня Жукин",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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

Обратите внимание, что все файлы и документы отдаются в формате base64.


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3EB08F8DF5768B401716",
      "body": "JVBERi0xLjMJUVPRgo=",
      "type": "document",
      "from": "79991940200@c.us",
      "to": "79662041999@c.us",
      "senderName": "Александр Жукин",
      "chatId": "79991940200@c.us",
      "timestamp": "2023-12-05T13:02:19+03:00",
      "time": 1701770539,
      "caption": "Это документ",
      "title": "Это документ",
      "from_where": "phone",
      "file_name": "1.pdf",
      "mimetype": "application/pdf",
      "contact_name": "Саня Жукин",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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

Обратите внимание, что все файлы аудио отдаются в формате base64.


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3EB0C341916D5111CC9A",
      "body": "SUQzAwAAAAAHdAgDA==",
      "type": "ptt",
      "from": "79991940200@c.us",
      "to": "79662041999@c.us",
      "senderName": "Александр Жукин",
      "chatId": "79991940200@c.us",
      "timestamp": "2023-12-05T13:03:11+03:00",
      "time": 1701770591,
      "from_where": "phone",
      "mimetype": "audio/mpeg",
      "contact_name": "Саня Жукин",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3EB0A6A4730776B10FA3",
      "type": "location",
      "from": "79991940200@c.us",
      "to": "79662041999@c.us",
      "senderName": "Александр Жукин",
      "chatId": "79991940200@c.us",
      "timestamp": "2023-12-05T13:04:03+03:00",
      "time": 1701770643,
      "from_where": "phone",
      "location": {
        "latitude": 55.750446,
        "longitude": 37.617494,
        "description": "улица Торцева, 23А, Северодвинск, Архангельская область, 164520"
      },
      "contact_name": "Саня Жукин",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3EB0FB7CD60F1986B594",
      "body": "BEGIN:VCARD\nVERSION:3.0\nN:;Имя контакта;;;\nFN:Имя
      контакта\nTEL;type=CELL;type=VOICE;waid=79662041999:+79662041999\nEND:VCARD",
      "type": "vcard",
      "from": "79991940200@c.us",
      "to": "79662041999@c.us",
      "senderName": "Александр Жукин",
      "chatId": "79991940200@c.us",
      "timestamp": "2023-12-05T13:04:34+03:00",
      "time": 1701770674,
      "from_where": "phone",
      "contact": {
        "display_name": "Имя контакта",
        "phone": "+79662041999"
      },
      "contact_name": "Саня Жукин",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3AD57A50F73CFC3B6DED",
      "body": "T2dnUwACAAAAAAAJvNyUA=",
      "type": "ptt",
      "from": "79005576333@c.us",
      "to": "79662041999@c.us",
      "senderName": "Flood",
      "chatId": "79005576333@c.us",
      "timestamp": "2023-12-05T13:07:01+03:00",
      "time": 1701770821,
      "from_where": "phone",
      "mimetype": "audio/ogg; codecs=opus",
      "contact_name": "Максим",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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

Поле "type": "incoming_call" - входящий звонок; "missed_call" - пропущенный звонок; "call_terminate" - завершение звонка; "call_accept" - звонок принят.


{
  "messages": {
      "wh_type": "incoming_call",
      "type": "incoming_call",
      "contact": {
        "Found": true,
        "FirstName": "Саня Жукин",
        "FullName": "Саня Жукин",
        "PushName": "Александр Жукин",
        "BusinessName": ""
      },
      "profile_id": "81ad40e9-b023",
      "number": "71008888888",
      "timestamp": "2023-07-17T17:40:34+03:00",
      "time": 1689604834,
  }
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3A786E94948BFBED8A27",
      "body": "👍",
      "type": "reaction",
      "from": "79005576333@c.us",
      "to": "79662041999@c.us",
      "senderName": "Flood",
      "chatId": "79005576333@c.us",
      "timestamp": "2023-12-05T13:08:08+03:00",
      "time": 1701770888,
      "from_where": "phone",
      "contact_name": "Максим",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "3EB053D6EAE268F0FB4D42",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "11a3e331-c546",
      "id": "3EB0402A83A59D74852E",
      "body": "contentText:\"Текст сообщения 1\" footerText:\"\" buttons:{buttonId:\"1\" buttonText:{displayText:\"button text 1\"} type:RESPONSE} buttons:{buttonId:\"2\" buttonText:{displayText:\"button text 2\"} type:RESPONSE} buttons:{buttonId:\"3\" buttonText:{displayText:\"button text 3\"} type:RESPONSE} headerType:TEXT text:\"Сообщение с кнопками\"",
      "type": "buttons",
      "from": "79995551122@c.us",
      "to": "79224448855@c.us",
      "senderName": "Дмитрий",
      "chatId": "79995551122@c.us",
      "timestamp": "2022-12-09T16:30:44+03:00",
      "time": 1670592644,
      "from_where": "api"
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "11a3e331-c546",
      "id": "3EB002BA170199D9F8B2",
      "body": "title:\"Заголовок сообщения со списком\" description:\"Это сообщение со списком\" buttonText:\"НАЖМИ на меня\" listType:SINGLE_SELECT sections:{title:\"Заголовок меню\" rows:{title:\"Выбор 1\" description:\"\" rowId:\"id1\"} rows:{title:\"Выбор 2\" description:\"\" rowId:\"id2\"} rows:{title:\"Выбор 3\" description:\"Можно добавлять описание для секции\" rowId:\"id3\"} rows:{title:\"Выбор 4\" description:\"Можно добавлять эмоджики\" rowId:\"aIfkv6\"} rows:{title:\"Выбор 5\" description:\"Текст\" rowId:\"test-4\"} rows:{title:\"Выбор 6\" description:\"Еще текст\" rowId:\"test-6\"} rows:{title:\"Выбор 7\" description:\"Больше текста\" rowId:\"test-7\"} rows:{title:\"Выбор 8\" description:\"Еще больше текста\" rowId:\"test-8\"}} contextInfo:{disappearingMode:{initiator:CHANGED_IN_CHAT}}",
      "type": "list",
      "from": "79995551122@c.us",
      "to": "79224448855@c.us",
      "senderName": "Дмитрий",
      "chatId": "79995551122@c.us",
      "timestamp": "2022-12-09T17:00:05+03:00",
      "time": 1670594405,
      "from_where": "api"
    }
  ]
}

Свернуть

Webhook на входящий опрос


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "71ad40e9-b023",
      "id": "3AD7644514D8B64B5E4F",
      "body": "Вопрос",
      "type": "poll",
      "from": "79005576333@c.us",
      "to": "79662041999@c.us",
      "senderName": "Flood",
      "chatId": "79005576333@c.us",
      "timestamp": "2023-12-05T13:09:34+03:00",
      "time": 1701770974,
      "from_where": "phone",
      "contact_name": "Максим",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog",
      "poll_options": [
        "Ответ 1",
        "Ответ 2"
      ]
    }
  ]
}

Свернуть

Webhook на нажатие кнопки


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "11a3e331-c546",
      "id": "3A3CB510072A59DB53D2",
      "body": "button text 1",
      "type": "buttons_response",
      "from": "79995551122@c.us",
      "to": "79224448855@c.us",
      "senderName": "Дмитрий",
      "chatId": "79995551122@c.us",
      "timestamp": "2022-12-09T16:43:22+03:00",
      "time": 1670593402,
      "from_where": "phone",
      "button_response": true,
      "selectedButtonId": "1"
    }
  ]
}

Свернуть

Webhook на нажатие списка


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "11a3e331-c546",
      "id": "3ADC84A9812D3B3E35F3",
      "body": "id2",
      "type": "list_response",
      "from": "79995551122@c.us",
      "to": "79224448855@c.us",
      "senderName": "Ми",
      "chatId": "79224448855@c.us",
      "timestamp": "2022-12-09T17:04:20+03:00",
      "time": 1670594660,
      "from_where": "phone",
      "list_response": true,
      "selected_list_id": "id2"
    }
  ]
}

Свернуть

Webhook на голосование в опросе


{
  "messages": [
    {
      "wh_type": "incoming_message",
      "profile_id": "501d59e1-0b06",
      "id": "3A8B4D1C2EF20C6F895C",
      "type": "poll_vote",
      "from": "79602041920@c.us",
      "to": "79217304433@c.us",
      "senderName": "Ми",
      "chatId": "79602041920@c.us",
      "timestamp": "2023-05-22T12:53:34+03:00",
      "time": 1684749214,
      "from_where": "phone",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "3EB0F7485D1C02A618F3",
      "poll_options": [
        "да",
        "нет",
        "не знаю",
        "где я?"
      ],
      "selected_poll_variant": [
        "да"
      ]
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "outgoing_message_api",
      "profile_id": "71ad40e9-b023",
      "id": "3EB0220348D7366EE7067B",
      "body": "тест",
      "type": "chat",
      "from": "79662041999@c.us",
      "to": "79005576333@c.us",
      "senderName": "Сергей",
      "chatId": "79005576333@c.us",
      "timestamp": "2023-12-05T13:10:21+03:00",
      "time": 1701771021,
      "from_where": "api",
      "contact_name": "Максим",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "task_id": "faede625-0f03-46e9-8f56-dae5a89887df",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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


{
  "messages": [
    {
      "wh_type": "outgoing_message_phone",
      "profile_id": "71ad40e9-b023",
      "id": "3ABB9BBF9ACB92858E87",
      "body": "Тест",
      "type": "chat",
      "from": "79662041999@c.us",
      "to": "79005576333@c.us",
      "senderName": "Сергей",
      "chatId": "79005576333@c.us",
      "timestamp": "2023-12-05T13:11:24+03:00",
      "time": 1701771084,
      "from_where": "phone",
      "contact_name": "Максим",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "chat_type": "dialog"
    }
  ]
}

Свернуть

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

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

Получить бан за использование нашего сервиса нельзя, это абсолютно безопасно - все выглядит как Whatsapp Web. Но мы не несем ответственности за неправомерное использование WhatsApp или нарушение его правил. Согласно политике WhatsApp, можно получить бан за подозрительную автоматизацию работы с мессенджером, а также за использование массовой рассылки и рассылку спама.

Можно ли производить массовые рассылки?

Технически вы можете использовать Wappi для массовой рассылки, у нас нет ограничений на количество отправленных сообщений. Но мы не рекомендуем делать рассылку нежелательных сообщений или спама, иначе есть риск быть заблокированным алгоритмами антиспам системы WhatsApp

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

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

Тарифы Whatsapp API

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

1 месяц
3 месяца-5%
6 месяцев-10%
12 месяцев-20%

WhatsappБазовый

700 ₽

650 ₽~~700 ₽~~

630 ₽~~700 ₽~~

550 ₽~~700 ₽~~

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

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

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

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

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

WhatsappПолный

1690 ₽

1600 ₽~~1690 ₽~~

1500 ₽~~1690 ₽~~

1350 ₽~~1690 ₽~~

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

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

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

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

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

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

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

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

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

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