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

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

Попробовать бесплатно

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

Telegram API

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

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

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

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

Это так называемый Telegram User API, который подойдет, если вы хотите использовать личный телеграм аккаунт в качестве userbot или для иных действий.

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

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

Мы используем API Telegram, который является частью экосистемы Telegram. Если вы используете наш API для флуда, спама, фейковых подписчиков, счетчиков просмотров каналов, Telegram может вас забанить. Рекомендуем использовать свои собственные socks5 прокси для подключения.

Telegram MCP сервер

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

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

Коллекция Postman

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

В коллекцию >

Методы API

Все методы Telegram APIПолный справочник - 84 методаСвернутьРазвернуть
Работа с профилем12 методов
POSTСоздать профиль/tapi/profile/add

URL: https://wappi.pro/tapi/profile/add?name=Новый профиль&webhook_url=https://wappi.pro

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

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

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

Query Params
ПараметрЗначениеОписание
nameНовый профильОбязательный параметр. Имя нового профиля.
webhook_urlhttps://wappi.proНеобязательный параметр. Установка URL ссылки на вебхук.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Создать профиль200
{
  "profile_id": "934c69b7-b896",
  "status": "done",
  "time": "2026-06-01T12:42:14+03:00",
  "timestamp": 1780306934
}
POSTУдалить профиль/tapi/profile/delete

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

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

Метод предназначен для удаления существующего профиля. Авторизация при этом тоже удаляется.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Удалить профиль200
{
  "detail": "Profile 934c69b7-b896 deleted",
  "status": "done",
  "time": "2026-06-01T12:45:15+03:00",
  "timestamp": 1780307115
}
GETПолучить статус и настройки профиля/tapi/sync/get/status

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить статус и настройки профиля200
{
  "app_status": "open",
  "authorized": true,
  "authorized_at": "2026-06-01T14:41:32.495491+03:00",
  "checked_at": "2026-01-12T12:14:39.294498+03:00",
  "last_activity": 0,
  "logouted_at": "2026-06-01T14:40:14.683409+03:00",
  "message_count": 3,
  "name": "testovi4okTG",
  "payment_expired_at": "2026-07-06T00:00:00Z",
  "payment_notification": true,
  "phone": "799900000000",
  "platform": "tg",
  "profile_id": "48affe30-713e",
  "proxy": "",
  "uuid": "48affe30-713e",
  "webhook_types": [
    "incoming_message",
    "delivery_status",
    "authorization_status"
  ],
  "webhook_url": "",
  "worked_days": 0
}
GETПолучить все профили/tapi/profile/all/get

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

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

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

Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить все профили200
{
  "profiles": [
    {
      "app_status": "open",
      "proxy": "",
      "profile_id": "48affe30-713e",
      "name": "testovi4okTG",
      "webhook_url": "",
      "authorized": true,
      "uuid": "48affe30-713e",
      "is_subscribe": false,
      "checked_at": "2026-01-12T12:14:39.294498+03:00",
      "authorized_at": "2026-06-01T14:41:32.495491+03:00",
      "logouted_at": "2026-06-01T14:40:14.683409+03:00",
      "phone": "79116462222",
      "worked_days": 0,
      "webhook_types": [
        "incoming_message",
        "delivery_status",
        "authorization_status"
      ],
      "last_activity": 0,
      "message_count": 3,
      "payment_notification": true,
      "deleted_at": null,
      "platform": "tg"
    }
  ],
  "status": "done"
}
GETПерезагрузить профиль/tapi/profile/restart

URL: https://wappi.pro/tapi/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"
}
POSTПередать телефон для авторизации/tapi/sync/auth/phone

URL: https://wappi.pro/tapi/sync/auth/phone?profile_id={{profile_id}}

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

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

Request Body

ПараметрТип данныхОбяз.Описание
phonestringДаНомер телефона для авторизации
Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами).
Пример: "79990000000"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "phone": "79990000000"
}
Responses
Передать телефон для авторизации200
{
  "status": "done",
  "time": "2026-06-01T13:02:24+03:00",
  "detail": "waiting for code",
  "uuid": "48affe30-713e"
}
POSTВвести код авторизации/tapi/sync/auth/code

URL: https://wappi.pro/tapi/sync/auth/code?profile_id={{profile_id}}

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

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

Request Body

ПараметрТип данныхОбяз.Описание
auth_codestringДаКод авторизации
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "auth_code": "38405"
}
Responses
Ввести код авторизации200
{
  "status": "done",
  "time": "2026-06-01T13:24:38+03:00",
  "detail": "2fa",
  "uuid": "48affe30-713e"
}
POSTВвести облачный пароль 2fa/tapi/sync/auth/2fa

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание
pwd_codestringДаПароль двухфакторной авторизации (2FA), установленный в аккаунте Telegram.
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "pwd_code": "password"
}
Responses
Ввести облачный пароль 2fa200
{
  "status": "done",
  "detail": "auth_success",
  "uuid": "fae370e3-0a1a"
}
GETАвторизовать по QR/tapi/sync/auth/qr

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

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

Метод предназначен для авторизации в Telegram по QR коду.

QR-код возвращается в поле detail в виде строки Base64, содержащей PNG-изображение. Если установлена 2fa информация об этом вернется в этом же поле.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw

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

Responses
Авторизовать по QR200
{
  "status": "done",
  "time": "2026-06-01T15:54:32+03:00",
  "detail": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDolAAAABlBMVEX",
  "uuid": "48affe30-713e"
}
Если есть 2fa200
{
  "status": "done",
  "time": "2026-06-06T12:16:48+03:00",
  "detail": "2fa",
  "uuid": "b46b904e-e07c"
}
GETВыйти из Telegram/tapi/profile/logout

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

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

Метод предназначен для разавторизации в Telegram.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса urlencoded

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

Responses
Выйти из telegram200
{
  "status": "done",
  "timestamp": 1780314196,
  "time": "2026-06-01T14:43:16+03:00",
  "detail": "logout success",
  "task_id": "e12de786e8ebb2981583a44c5c8d0101",
  "uuid": "48affe30-713e"
}
POSTОплатить профиль с баланса/payments/balance/add_days

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание
profile_uuidstringДаID профиля, для которого выполняется оплата Можно получить в личном кабинете на странице конкретного профиля.
tariff_idintegerДаID выбранного тарифа
Доступные тарифы:
1 - Базовый 1 месяц;
2 - Базовый 3 месяца;
3 - Базовый 6 месяцев;
4 - Базовый 12 месяцев;
5001 - Полный 1 месяц;
5002 - Полный 3 месяца;
5003 - Полный 6 месяцев;
5004 - Полный 12 месяцев.
profile_idsarray\[string\]НетМассив ID дополнительных профилей для оплаты
Если указаны, оплата применяется ко всем профилям из profile_uuid и profile_ids.
codestringНетПромо-код на скидку
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "profile_uuid": "uuid",
  "tariff_id": 1,
  "profile_ids": [
    "uuid",
    "uuid2"
  ],
  "code": "promo_code"
}
Responses
Оплатить профиль с баланса200
/dashboard/48affe30-713e
GETПолучить историю авторизаций профиля/panel/profile/auth/history

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

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

Метод позволяет получить историю авторизаций в профиле.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить историю авторизаций профиля200
{
  "auth_history": [
    {
      "type": "logout",
      "phone": "",
      "created_at": "2026-06-01T15:51:52.584118+03:00",
      "reason": ""
    },
    {
      "type": "login",
      "phone": "",
      "created_at": "2026-06-01T14:44:50.404175+03:00",
      "reason": ""
    },
    {
      "type": "logout",
      "phone": "",
      "created_at": "2026-06-01T14:43:18.919649+03:00",
      "reason": ""
    },
    {
      "type": "login",
      "phone": "",
      "created_at": "2026-06-01T14:41:29.00465+03:00",
      "reason": ""
    },
    {
      "type": "logout",
      "phone": "",
      "created_at": "2026-06-01T12:54:22.321223+03:00",
      "reason": ""
    },
    {
      "type": "login",
      "phone": "",
      "created_at": "2026-06-01T12:40:34.46265+03:00",
      "reason": ""
    },
    {
      "type": "logout",
      "phone": "",
      "created_at": "2026-01-12T18:18:47.909476+03:00",
      "reason": "Logout from device"
    },
    {
      "type": "login",
      "phone": "",
      "created_at": "2026-01-12T12:50:41.7159+03:00",
      "reason": ""
    },
    {
      "type": "logout",
      "phone": "",
      "created_at": "2026-01-12T12:28:51.493128+03:00",
      "reason": ""
    },
    {
      "type": "login",
      "phone": "",
      "created_at": "2026-01-12T12:18:59.439315+03:00",
      "reason": ""
    }
  ],
  "status": "done"
}
Работа с сообщениями / Синхронные методы18 методов
POSTОтправить текстовое сообщение/tapi/sync/message/send

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
bodystringДаТекст сообщения Пример: "Привет! Как ты?"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетОписание. Любая необходимая дополнительная информация

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id1111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
   "recipient":"4414924740",
   //"topic_id": 2,
   "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": 1780390873,
  "time": "2026-06-02T12:01:13+03:00",
  "message_id": "1059833",
  "task_id": "4cf92db7ede74786b11e8a16d1a1254a",
  "uuid": "48affe30-713e",
  "pts": 2292027,
  "pts_count": 1
}
POSTОтправить медиа по ссылке/tapi/sync/message/file/url/send

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

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

Метод предназначен для отправки изображения, видео или документа пользователю Telegram.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
urlstringДаПрямая ссылка на файл, доступная для скачивания сервером. Пример: "https://example.com/file.pdf"
file_namestringНетИмя файла. Используется для документов. Пример: "Имя файла.jpg"
captionstringНетПодпись к медиафайлу. Используется для изображений и видео, документов. Пример: "Медиа по ссылке"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетДополнительная информация о менеджере. Пример: "описание пример"

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id1111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient": "4414924740",
    //"topic_id": 2,
    "url":"https://img.magnific.com/free-photo/cute-kitten-sitting-staring-playful-fluffy-looking-camera-generated-by-artificial-intelligence_188544-113029.jpg",
    "caption": "Это подпись",
    "file_name": "Название файла.jpg",
    "as_file": true,
    "manager": {
        "name": "Светлана",
        "id": "38200203",
        "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
        "description": "описание пример"    
   }
}
Responses
Отправить медиа по ссылке200
{
  "status": "done",
  "timestamp": 1780408578,
  "time": "2026-06-02T16:56:19+03:00",
  "message_id": "1059874",
  "task_id": "1b4b05f457f8daf20562fb7022900789",
  "uuid": "48affe30-713e",
  "pts": 2292075,
  "pts_count": 1
}
POSTОтправить локацию/tapi/sync/message/location/send

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

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

Метод предназначен для отправки геолокации пользователю Telegram.

Для отправки необходимо указать координаты точки через параметры latitude и longitude. Дополнительно можно передать адрес или описание местоположения через параметр address.

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
latitudenumberДаШирота местоположения. Пример: 55.750446
longitudenumberДаДолгота местоположения. Пример: 37.617494
addressstringНетАдрес или описание местоположения. Пример: "улица Торцева, 23А, Северодвинск, Архангельская область, 164520"
bodystringНетСопроводительное сообщение. Любой необходимый текст. Пример: "SUPER PLACE"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетОписание. Любая необходимая дополнительная информация

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id1111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "@testname",
    //"topic_id": 2,
    "latitude" : 55.750446,
    "longitude": 37.617494,
    "address": "улица Торцева, 23А, Северодвинск, Архангельская область, 164520",
    "body": "SUPER PLACE",
    "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": 1780409938,
  "time": "2026-06-02T17:18:59+03:00",
  "message_id": "1059889",
  "task_id": "fb42cb47e2ec14e5a47febd49ce574f6",
  "uuid": "48affe30-713e",
  "pts": 2292091,
  "pts_count": 1
}
POSTОтправить контакт/tapi/sync/contact/send

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

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

Метод предназначен для отправки контакта пользователю Telegram.

В сообщении передаётся номер телефона контакта и его отображаемое имя.

Request Body

ПараметрТип данныхОбяз.Описание и пример
phonestringДаНомер телефона передаваемого контакта. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: "79996665544"
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
namestringНетИмя контакта, которое будет отображаться получателю. Пример: "Имя контакта"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетОписание. Любая необходимая дополнительная информация

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id11111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "phone": "79996665544",
    "recipient": "4414924740",
    //"topic_id": 2,
    "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": 1780411057,
  "time": "2026-06-02T17:37:38+03:00",
  "message_id": "1059894",
  "task_id": "eab3f205ad6209932ed4105fa186ae7c",
  "uuid": "48affe30-713e",
  "pts": 2292096,
  "pts_count": 1
}
POSTОтправить реакцию на сообщение/tapi/sync/message/reaction

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

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

Метод предназначен для отправки реакции на сообщение в Telegram.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
bodystringНетЭмодзи реакции, которая будет установлена на сообщение. Для того чтобы убрать реакцию с сообщения, не передавайте параметр или укажите в качестве значения пустоту. Примеры: "👍",""
recipientstringДаПолучатель сообщения_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
message_idstringДаИдентификатор сообщения, на которое необходимо установить реакцию. Пример: "1059915"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетОписание. Любая необходимая дополнительная информация

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id1111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "body": "👍",
  "recipient": "60227586",
  "message_id": "9659",
  "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": 1780496008,
  "time": "2026-06-03T17:13:29+03:00",
  "message_id": "1059929",
  "task_id": "2692a9e0336be46e95af70ae220db11d",
  "uuid": "48affe30-713e",
  "pts": 2292178,
  "pts_count": 1
}
POSTОтметить сообщение прочитанным/tapi/sync/message/mark/read

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

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

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

Для выполнения операции необходимо передать идентификатор сообщения в параметре message_id.

Request Body

ПараметрТип данныхОбяз.Описание и пример
message_idstringДаИдентификатор сообщения, которое необходимо отметить как прочитанное. Пример: "1059931"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "message_id": "1059931"
}
Responses
Отметить сообщение прочитанным200
{
  "status": "done",
  "timestamp": 1780496252,
  "time": "2026-06-03T17:17:32+03:00",
  "detail": "markRead success for chatID=98727543",
  "task_id": "d0fb667722dbed723822f040b34b2950",
  "uuid": "48affe30-713e"
}
POSTПереслать сообщение/tapi/sync/message/forward

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

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

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

Для пересылки необходимо указать идентификатор сообщения в параметре message_id и получателя в параметре recipient. При необходимости можно скрыть информацию об авторе исходного сообщения с помощью параметра drop_author.

Request Body

ПараметрТип данныхОбяз.Описание и пример
message_idstringДаИдентификатор сообщения, которое необходимо переслать. Пример: "1059948"
recipientstringДаПолучатель сообщения_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
drop_authorbooleanНетОпределяет, будет ли скрыта информация об авторе пересылаемого сообщения. true — сообщение будет отправлено без указания автора и будет выглядеть как обычное сообщение, а не как пересланное., false — сохранить информацию об авторе. Пример: false
managerobjectНетОбъект с информацией о менеджере, от имени которого выполняется пересылка сообщения.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетДополнительная информация о менеджере. Пример: "описание пример"

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id11111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "message_id":"1059948",
    "recipient": "60225463",
    //"topic_id": 2,
    "drop_author": false,
       "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": 1780509309,
  "time": "2026-06-03T20:55:10+03:00",
  "message_id": "1059972",
  "task_id": "0d1b8e63239c7f7d28be813c967a162d",
  "uuid": "48affe30-713e",
  "pts": 2292230,
  "pts_count": 1
}
POSTОтветить на сообщение/tapi/sync/message/reply

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

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

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

Для отправки ответа необходимо указать идентификатор сообщения в параметре message_id и текст ответа в параметре body. Сообщение будет отправлено как ответ на указанное сообщение.

Дополнительно можно передать ссылку на файл в параметре url. В этом случае в ответ на сообщение будет отправлен медиафайл с подписью из параметра body.

Request Body

ПараметрТип данныхОбяз.Описание и пример
bodystringДаТекст ответа. Пример: "тестовый ответ на сообщение"
message_idstringДаИдентификатор сообщения, на которое необходимо ответить. Пример: "9618"
urlstringНетПрямая ссылка на файл. Если параметр указан, в ответ на сообщение будет отправлен файл. Пример: "https://example.com/image.jpg"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетДополнительная информация о менеджере. Пример: "описание пример"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id11111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "body": "тестовый ответ на сообщение",
  "message_id": "9618",
  "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": 1780562392,
  "time": "2026-06-04T11:39:52+03:00",
  "message_id": "9643",
  "task_id": "4ea3cbb017d8449459d5d6f2cd25c636",
  "uuid": "48affe30-713e",
  "pts": 19067,
  "pts_count": 1
}
POSTУдалить сообщение/tapi/sync/message/delete

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

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

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

Для удаления сообщения необходимо указать его идентификатор в параметре message_id.

Request Body

ПараметрТип данныхОбяз.Описание и пример
message_idstringДаИдентификатор сообщения, которое необходимо удалить. Пример: "9643"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "message_id": "9643"
}
Responses
Удалить сообщение200
{
  "status": "done",
  "timestamp": 1780562756,
  "time": "2026-06-04T11:45:56+03:00",
  "detail": "message was deleted",
  "task_id": "173f5462939ebab53787ff77b458c5aa",
  "uuid": "48affe30-713e",
  "pts": 19068,
  "pts_count": 1
}
POSTИзменить сообщение/tapi/sync/message/edit

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

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

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

Для изменения сообщения необходимо указать его идентификатор в параметре message_id и новый текст сообщения в параметре body.

Request Body

ПараметрТип данныхОбяз.Описание и пример
bodystringДаНовый текст сообщения, который заменит текущее содержимое сообщения. Пример: "Измененное сообщение"
urlstringНетСсылка на новый файл, если требуется заменить вложение. Пример: "https://example.com/file.jpg"
message_idstringДаИдентификатор сообщения, которое необходимо отредактировать. Пример: "9644"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетОписание. Любая необходимая дополнительная информация
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id11111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "body": "Измененное сообщение",
  "message_id": "9644",
  "url": "https://img.magnific.com/free-photo/cute-kitten-sitting-table-looking-pink-flower-generated-by-artificial-intelligence_188544-126175.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": 1780575991,
  "time": "2026-06-04T15:26:32+03:00",
  "message_id": "9644",
  "task_id": "04876da0582cbe5a3f1fe6b91a549101",
  "uuid": "48affe30-713e",
  "pts": 19075,
  "pts_count": 1
}
GETПолучить сообщения из чата/tapi/sync/messages/get

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
chat_id79115556677Обязательный параметр. ID чата из списка сообщений. Примеры: 1347563 - id чата 79115556677 - номер телефона контакта чата username - юзернейм контакта чата
limit20Необязательный параметр. Количество сообщений для получения. Если не указывать, то по умолчанию установлено значение 100. Максимальное значение 100.
date2024-02-22T15:50:51Необязательный параметр. Дата, с которой вывести список сообщений. Формат YYYY-mm-ddTHH:MM:ss (например 2023-12-31T12:00:00).
offset0Необязательный параметр. От какого по счету элемента вывести список сообщений, где 0 это самое новое сообщение. Если не указывать, то по умолчанию установлено значение 0.
mark_alltrueНеобязательный параметр. Значения true или false. Если true, то помечает все непрочитанные сообщения в чате прочитанными. Если не указывать, то по умолчанию стоит значение false. Работает только для личных чатов, для групп не работает.
orderdescНеобязательный параметр. Значения desc или asc. Если desc - сортирует от нового к старым, если asc - от старого к новым. Если не указывать, то по умолчанию стоит desc
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить сообщения из чата200
{
  "status": "done",
  "timestamp": 1709459890,
  "time": "2024-03-03T12:58:10+03:00",
  "messages": [
    {
      "id": "2910",
      "type": "text",
      "from": "996507585526",
      "to": "FL00D",
      "fromMe": true,
      "senderName": "Varis",
      "time": 1709456814,
      "body": "Нрн",
      "stanzaId": "",
      "chatId": "89323786",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "delivery_status": "delivered",
      "s3Info": {},
      "poll_votes": null,
      "poll_options": null,
      "poll_select_count": 0
    },
    {
      "id": "2909",
      "type": "text",
      "from": "FL00D",
      "to": "996507585526",
      "fromMe": false,
      "senderName": "Max Flood",
      "time": 1709456774,
      "body": "Ldlld",
      "stanzaId": "",
      "chatId": "89323786",
      "isForwarded": false,
      "isReply": false,
      "caption": "",
      "delivery_status": "delivered",
      "s3Info": {},
      "poll_votes": null,
      "poll_options": null,
      "poll_select_count": 0
    }
  ],
  "total_count": 2,
  "uuid": "fae370e3-0a1a"
}
GETПолучить сообщение по ID/tapi/sync/messages/id/get

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
message_id0000Обязательный параметр. ID сообщения
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить сообщение по ID200
{
    "status": "done",
    "timestamp": 1780577723,
    "time": "2026-06-04T15:55:23+03:00",
    "message": {
        "id": "",
        "type": "text",
        "from": "",
        "to": "",
        "fromMe": true,
        "senderName": "",
        "contact_name": "",
        "username": "",
        "phone": "",
        "time": ,
        "body": "тестовый ответ на сообщение",
        "stanzaId": "",
        "chatId": "",
        "isForwarded": false,
        "isReply": true,
        "caption": "",
        "file_name": "",
        "isRead": true,
        "delivery_status": "read",
        "s3Info": {},
        "poll_votes": null,
        "mimetype": "",
        "from_where": "api",
        "reply_message": {
            "id": "",
            "body": "1",
            "type": "text",
            "chatId": "",
            "timestamp": ,
            "caption": "",
            "contact_name": "",
            "username": "",
            "phone": "",
            "attaches": null
        },
        "isEdited": false,
        "isGif": false,
        "isFromAPI": false,
        "isDeleted": true,
        "location": null,
        "isPinned": false,
        "reactions": null,
        "wappi_bot_id": "11111111",
        "task_id": "4ea3cbb017d8449459d5d6f2cd25c636",
        "template_id": "",
        "manager": {
            "id": "38200203",
            "name": "Светлана",
            "ava_link": "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg",
            "description": "описание пример"
        },
        "crm_entities": {
            "crm_type": "",
            "crm_id": "",
            "message_id": "",
            "chat_id": "",
            "manager_id": ""
        },
        "is_blacklist": false,
        "billable": false,
        "attaches": null
    },
    "task_id": "8ac487b40062a510e2c4d967e67d691c",
    "uuid": "48affe30-713e"
}
GETПолучить список отправленных сообщений (API)/tapi/sync/messages/history

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
limit3Необязательный параметр. Количество сообщений для получения. Если не указывать, то по умолчанию установлено значение 200.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить список отправленных сообщений (API)200
{
  "status": "done",
  "detail": [
    {
      "delivered": "success",
      "recipient": "FL00D",
      "message": "Тестовое сообщение по API",
      "caption": "",
      "created_at": "2024-03-03T09:59:24.934Z",
      "task_name": "sendMessage",
      "id": "2912",
      "task_id": "8b537cad-58b2-428f-996b-82b86e4efd9e"
    }
  ],
  "all_messages_count": 56
}
GETСкачать медиа из сообщения/tapi/sync/message/media/download

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
message_id5880Обязательный параметр. ID сообщения, из которого необзодимо скачать файл
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Скачать медиа из сообщения200
{
  "status": "done",
  "timestamp": 1742114725,
  "time": "2025-03-16T11:45:25+03:00",
  "task_id": "53e59c7e-d808-4031-8335-332cf6a6e811",
  "uuid": "51a8107a-5442",
  "file_name": "e7d57669-3550-43f3-b6c4-1a5f422c1372.jpg",
  "media_type": "image",
  "mime_type": "image/jpeg",
  "file_link": "https://wapi-uploads7d.storage.yandexcloud.net/51a8107a-5442/e7d57669-3550-43f3-b6c4-1a5f422c1372.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YCAJEx61R4C7kz0v5oC6y60Gx%2F20250316%2Fru-central1%2Fs3%2Faws4_request&X-Amz-Date=20250316T084525Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&x-id=GetObject&X-Amz-Signature=4f1ca9b98ebaf35057ef4ecc7e549e6e21fba6d9032ab07a22a0a7cf2affff1f",
  "file_link_expire": 1742373925
}
POSTУстаревший - Отправить картинку (base64)/tapi/sync/message/img/send

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

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

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

Дополнительно можно указать подпись через параметр caption.

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
captionstringНетПодпись к изображению. Пример: "Это картинка тестовая"
b64_filestringДаИзображение, закодированное в формате Base64.

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id1111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "4414924740",
    //"topic_id": 2,
    "caption": "Это картинка тестовая",
    "b64_file" : "/9j/4AAQSkZJRgABAQAAAQABAAD/4QRERXhpZgAATU0AKgAAAAgABAEaAAUAAAABAAAAP845/z+NQ5JDP/9k="
}
Responses
Отправить картинку (base64)200
{
  "status": "done",
  "timestamp": 1780391556,
  "time": "2026-06-02T12:12:37+03:00",
  "message_id": "1059841",
  "task_id": "f117abcf575462f4d76c810a3fb166b2",
  "uuid": "48affe30-713e",
  "pts": 2292035,
  "pts_count": 1
}
POSTУстаревший - Отправить документ (base64)/tapi/sync/message/document/send

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

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

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

Дополнительно можно указать имя файла через параметр file_name и подпись через параметр caption.

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
captionstringНетПодпись к документу. Пример: "Это документ"
file_namestringНетИмя файла. Допустимо указывать вместе с расширением файла. Пример: "1.pdf"
b64_filestringДаДокумент в формате Base64. Пример: "JVBERi0xLjMKJcTl8uXrp/Og0MTGCj..."

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "7911646222",
    //"topic_id": 2,
    "caption": "Это документ",
    "file_name": "1.pdf",
    "b64_file" : "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjMgMCBvYmoKPID4+CnN0YXJ0eHJlZgoxMjc5NAolJUVPRgo="
}
Responses
Отправить документ (base64)200
{
  "status": "done",
  "timestamp": 1780393993,
  "time": "2026-06-02T12:53:14+03:00",
  "message_id": "1059846",
  "task_id": "a5fac99ff2f62128581476a1c6598466",
  "uuid": "48affe30-713e",
  "pts": 2292042,
  "pts_count": 1
}
POSTУстаревший - Отправить аудио (base64)/tapi/sync/message/audio/send

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

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

Метод предназначен для отправки аудиофайла пользователю Telegram. Файл передаётся в параметре b64_file в виде строки, закодированной в формате Base64.

Дополнительно можно указать имя файла через параметр file_name и подпись через параметр caption.

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
file_namestringНетИмя аудиофайла. Допускается указывать вместе с расширением файла. Пример: "sample.mp3"
captionstringНетПодпись к аудиофайлу. Пример: "Это аудио"
b64_filestringДаАудиофайл в формате Base64. Пример: "SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2..."

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id1111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "79115556677",
    //"topic_id": 2,
    "file_name": "sample.mp3",
    "caption": "Это аудио",
    "b64_file" : "SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU3LjgzLjEwMAAAAAAAAAAAAAAA//tQVVVVVVVVVVU="
}
Responses
Отправить аудио (base64)200
{
  "status": "done",
  "timestamp": 1780402815,
  "time": "2026-06-02T15:20:16+03:00",
  "message_id": "1059855",
  "task_id": "5f4dd395f9997e39c9a65870954ab556",
  "uuid": "48affe30-713e",
  "pts": 2292051,
  "pts_count": 1
}
POSTУстаревший - Отправить видео (base64)/tapi/sync/message/video/send

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

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

Метод предназначен для отправки видеофайла пользователю Telegram. Файл передаётся в параметре b64_file в виде строки, закодированной в формате Base64.

Дополнительно можно указать имя файла через параметр file_name и подпись через параметр caption.

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
file_namestringНетИмя видеофайла. Допускается указывать вместе с расширением файла. Пример: "sample.avi"
captionstringНетПодпись к видеофайлу. Пример: "Это видео"
b64_filestringДаВидеофайл в формате Base64. Пример: "AAAAIGZ0eXBtcDQyAAAAAG1wNDJtcDQx..."

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
bot_id111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "79115556677",
    //"topic_id": 2,
    "caption": "Это видео",
    "file_name": "sample.avi",
    "b64_file":"AAAAJGZ0eXBpc29tAAACAGlzb21pc282aXNvMmF2YzFtcDQxAAAAAAAAAAAAAAAAFJQEBAQAAABBtZnJvAAAAAAAAAG4="
}
Responses
Отправить видео (base64)200
{
  "status": "done",
  "timestamp": 1780403791,
  "time": "2026-06-02T15:36:32+03:00",
  "message_id": "1059857",
  "task_id": "de5b924d0cbb46d14fa19cfa5f7b19e5",
  "uuid": "48affe30-713e",
  "pts": 2292053,
  "pts_count": 1
}
Работа с сообщениями / Асинхронные методы10 методов
POSTОтправка текстового сообщения асинхронно/tapi/async/message/send

URL: https://wappi.pro/tapi/async/message/send?profile_id={{profile_id}}&timeout_from=10&timeout_to=20&ttl=600&bot_id=1111111111

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
bodystringДаТекст сообщения. Пример: "тестовое сообщение асинхронно"
recipientstringДаПолучатель сообщения_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками и дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "12345"
manager.namestringНетИмя менеджера. Пример: "Имя менеджера"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://example.com/avatar.jpg"
manager.descriptionstringНетОписание менеджера. Любая дополнительная информация о менеджере.

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени пользователя (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from10Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to20Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
bot_id1111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "body": "тестовое сообщение асинхронно",
    "recipient": "4414924740",
    //"topic_id": 2,
     "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": 1780992019,
  "time": "2026-06-09T11:00:19+03:00",
  "detail": "Message sent to queue",
  "task_id": "e22427cbff1c40653ba7df13a2a4e30f"
}
POSTОтправить медиа по ссылке асинхронно/tapi/async/message/file/url/send

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

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

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель файла_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
urlstringДаПрямая ссылка на файл для отправки. Пример: "https://example.com/file.jpg"
captionstringНетПодпись к файлу. Пример: "Это подпись"
file_namestringНетИмя файла, которое будет отображаться получателю. Допустимо указывать вместе с расширением файла. Примеры: "image.jpg", "document.pdf"
as_filebooleanНетОтправить вложение как файл. Возможные значения: true или false. Пример: true
managerobjectНетИнформация о менеджере, которая будет передана в вебхук исходящего сообщения.
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.idstringНетВнутренний идентификатор менеджера. Пример: "38200203"
manager.ava_linkstringНетСсылка на аватар менеджера.
manager.descriptionstringНетДополнительное описание менеджера.

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени пользователя (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from1Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to3Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
bot_id11111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}—
Тело запроса raw
{
    "recipient": "4414924740",
    //"topic_id": 2,
    "url":"https://img.magnific.com/free-photo/cute-kitten-sitting-staring-playful-fluffy-looking-camera-generated-by-artificial-intelligence_188544-113029.jpg",
    "caption": "Это подпись",
    "file_name": "Название файла.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": 1780996825,
  "time": "2026-06-09T12:20:25+03:00",
  "detail": "Message sent to queue",
  "task_id": "45d4e47dd404165426c619b2c3166fa7"
}
POSTОтправить локацию асинхронно/tapi/async/message/location/send

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

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

Метод предназначен для отправки геолокации пользователю Telegram.

Для отправки необходимо указать координаты точки через параметры latitude и longitude. Дополнительно можно передать адрес или описание местоположения через параметр address.

После получения запроса сообщение помещается в очередь на отправку и обрабатывается системой в фоновом режиме. В ответе возвращается идентификатор задачи (task_id), который можно использовать для отслеживания статуса выполнения. Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
latitudenumberДаШирота местоположения. Пример: 55.750446
longitudenumberДаДолгота местоположения. Пример: 37.617494
addressstringНетАдрес или описание местоположения. Пример: "улица Торцева, 23А, Северодвинск, Архангельская область, 164520"
bodystringНетСопроводительное сообщение. Любой необходимый текст. Пример: "SUPER PLACE"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетОписание. Любая необходимая дополнительная информация

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from1Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to3Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
bot_id11111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "@testname",
    //"topic_id": 2,
    "latitude" : 55.750446,
    "longitude": 37.617494,
    "address": "улица Торцева, 23А, Северодвинск, Архангельская область, 164520",
    "body": "SUPER PLACE",
    "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": 1780997247,
  "time": "2026-06-09T12:27:27+03:00",
  "detail": "Message sent to queue",
  "task_id": "621d8b6224560885d56c193e905868ba"
}
POSTОтправить контакт асинхронно/tapi/async/contact/send

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

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

Метод предназначен для асинхронной отправки контакта пользователю Telegram.

В сообщении передаётся номер телефона контакта и его отображаемое имя.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
phonestringДаНомер телефона передаваемого контакта. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: "79996665544"
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
namestringНетИмя контакта, которое будет отображаться получателю. Пример: "Имя контакта"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетОписание. Любая необходимая дополнительная информация

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from1Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to3Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
bot_id111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "phone": "79998887766",
    "recipient": "testname",
    //"topic_id": 2,
    "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": 1780997644,
  "time": "2026-06-09T12:34:04+03:00",
  "detail": "Message sent to queue",
  "task_id": "8ad26d09c675a21652be09a1a51b1c83"
}
POSTПереслать сообщение асинхронно/tapi/async/message/forward

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

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

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

Для пересылки необходимо указать идентификатор сообщения в параметре message_id и получателя в параметре recipient. При необходимости можно скрыть информацию об авторе исходного сообщения с помощью параметра drop_author.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
message_idstringДаИдентификатор сообщения, которое необходимо переслать. Пример: "1059948"
recipientstringДаПолучатель сообщения_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
drop_authorbooleanНетОпределяет, будет ли скрыта информация об авторе пересылаемого сообщения. true — сообщение будет отправлено без указания автора и будет выглядеть как обычное сообщение, а не как пересланное, false — сохранить информацию об авторе. Пример: false
managerobjectНетОбъект с информацией о менеджере, от имени которого выполняется пересылка сообщения.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетДополнительная информация о менеджере. Пример: "описание пример"

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from1Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to3Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
bot_id1111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "message_id":"9687",
    "recipient": "testname",
    //"topic_id": 2,
    "drop_author": false,
       "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": 1780997872,
  "time": "2026-06-09T12:37:52+03:00",
  "detail": "Message sent to queue",
  "task_id": "e4cf5e0a437a0609948ec0eb6195251f"
}
POSTОтветить на сообщение асинхронно/tapi/async/message/reply

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

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

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

Для отправки ответа необходимо указать идентификатор сообщения в параметре message_id и текст ответа в параметре body. Сообщение будет отправлено как ответ на указанное сообщение.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
bodystringДаТекст ответа. Пример: "тестовый ответ на сообщение"
urlstringДаПрямая ссылка на файл для отправки вместе с ответом. Если поле отсутствует, отправляется только текст. Пример: "https://example.com/file.jpg"
message_idstringДаИдентификатор сообщения, на которое необходимо ответить. Пример: "9618"
managerobjectНетОбъект с информацией о менеджере, от имени которого отправляется сообщение.
manager.idstringНетИдентификатор менеджера. Пример: "38200203"
manager.namestringНетИмя менеджера. Пример: "Светлана"
manager.ava_linkstringНетСсылка на аватар менеджера. Пример: "https://img.freepik.com/free-photo/view-adorable-persian-domestic-cat_23-2151773882.jpg"
manager.descriptionstringНетДополнительная информация о менеджере. Пример: "описание пример"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from1Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to3Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
bot_id1111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "body": "тестовый ответ на сообщение",
  "message_id": "9688",
  "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": 1780998152,
  "time": "2026-06-09T12:42:32+03:00",
  "detail": "Message sent to queue",
  "task_id": "19567f5661c3e2b8f0718401542ac1c7"
}
POSTУстаревший - Отправить картинку (base64) асинхронно/tapi/async/message/img/send

URL: https://wappi.pro/tapi/async/message/img/send?profile_id={{profile_id}}&timeout_from=10&timeout_to=20&bot_id=11111111111&ttl=600

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

Метод предназначен для асинхронной отправки изображения пользователю Telegram.

Изображение передаётся в параметре b64_file в виде строки, закодированной в формате Base64. Дополнительно можно указать подпись к изображению через параметр caption.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками и дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
captionstringНетПодпись к изображению. Пример: "Это картинка"
b64_filestringДаИзображение в формате Base64. Пример: "/9j/4AAQSkZJRgABAQ..."

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени пользователя (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from10Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to20Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
bot_id11111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "testname",
    //"topic_id": 2,
    "caption": "Это картинка",
    "b64_file" : "/9j/4AAQSkZJRgABAQAAAQABAAD/4QRERXhpZgAATU0AKgAAABjBK8cVTn1CVMDqM/eLVmXOqyLwZV69M845/z+NQ5JDP/9k="
}
Responses
Отправить картинку (base64) асинхронно200
{
  "status": "done",
  "timestamp": 1780992066,
  "time": "2026-06-09T11:01:06+03:00",
  "detail": "Message sent to queue",
  "task_id": "22ca12dcecf3e34aecd7d7437b040f0b"
}
POSTУстаревший - Отправить документ (base64) асинхронно/tapi/async/message/document/send

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

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

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

Файл передаётся в виде строки, закодированной в формате Base64.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель документа_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
captionstringНетПодпись к документу. Пример: "Это документ"
file_namestringНетИмя файла. Допустимо указывать вместе с расширением файла. Примеры: "document.pdf", "report.docx", "archive.zip"
b64_filestringДаДокумент в формате Base64. Пример: "JVBERi0xLjMKJcTl8uXrp/Og0MTGCj..."

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени пользователя (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from1Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to3Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
bot_id11111111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "testname",
    //"topic_id": 2,
    "caption": "Это документ",
    "file_name": "1.pdf",
    "b64_file" : "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjMgMCBvYmoeHJlZgoxMjc5NAolJUVPRgo="
}
Responses
Отправить документ (base64) асинхронно200
{
  "status": "done",
  "timestamp": 1780992383,
  "time": "2026-06-09T11:06:23+03:00",
  "detail": "Message sent to queue",
  "task_id": "1deadef0a53c5fac0cb32139d4d22f0f"
}
POSTУстаревший - Отправить видео (base64) асинхронно/tapi/async/message/video/send

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

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

Метод предназначен для асинхронной отправки видеофайла пользователю Telegram.

Видеофайл передаётся в виде строки, закодированной в формате Base64.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель_\*_. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
captionstringНетПодпись к видеофайлу. Пример: "Это видео"
b64_filestringДаВидеофайл в формате Base64. Пример: "JVBERi0xLjMKJcTl8uXrp/Og0MTGCj..."

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени пользователя (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from1Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to3Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
bot_id11111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "79115556677",
    //"topic_id": 2,
    "caption": "Это видео",
    "b64_file":"AAAAIGZ0eXBtcDQyAAAAAG1wNDJtcDQxaXNvbWF2YzEAAC4wbW9vdgAAAGxtdmhkAAAAANHqJx7R6iceAAACWAAAR40tLS0tLS0tLS0vA=="
}
Responses
Отправить видео (base64) асинхронно200
{
  "status": "done",
  "timestamp": 1780995903,
  "time": "2026-06-09T12:05:03+03:00",
  "detail": "Message sent to queue",
  "task_id": "61705c87501ced42a2ea2b172e3d6a60"
}
POSTУстаревший - Отправить аудио (base64) асинхронно/tapi/async/message/audio/send

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

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

Метод предназначен для асинхронной отправки аудиофайла пользователю Telegram. Файл передаётся в параметре b64_file в виде строки, закодированной в формате Base64.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения\*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
topic_idstringНетИдентификатор темы в которую необходимо отправить сообщение. Пример: "2"
file_namestringНетИмя аудиофайла. Допускается указывать вместе с расширением файла. Пример: "sample.mp3"
captionstringНетПодпись к аудиофайлу. Пример: "Это аудио"
b64_filestringДаАудиофайл в формате Base64. Пример: "SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2..."

\* Отправка сообщений по идентификатору пользователя доступна только после того, как пользователь был найден по имени (username) или если с ним уже существует диалог.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
timeout_from1Необязательный параметр. Минимальное время задержки перед началом выполнения команды, указывается в секундах.
timeout_to3Необязательный параметр. Максимальное время задержки перед началом выполнения команды, указывается в секундах
ttl600Необязательный параметр. Задаёт максимальное время жизни команды (в секундах), в течение которого система будет пытаться доставить сообщение. Если за это время сообщение не было отправлено — оно отменяется и не отправляется повторно.
bot_id1111111111Необязательный параметр. Заполняется необходимыми мета-данными, которые будут получены в вебхуке на исходящее/входящее сообщение по API. Например, информация о сервисе-источнике запроса.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "recipient" : "testname",
    //"topic_id": 2,
    "file_name": "sample.mp3",
    "caption": "Это аудио",
    "b64_file" : "SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU3LjgzLjEwVVVVVVVVVVVU="
}
Responses
Отправить аудио (base64) асинхронно200
{
  "status": "done",
  "timestamp": 1780996035,
  "time": "2026-06-09T12:07:15+03:00",
  "detail": "Message sent to queue",
  "task_id": "003f22b59a7c5f9a8ed883ca7cb7aa50"
}
Работа с чатами5 методов
GETПолучить список чатов/tapi/sync/chats/get

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

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

Метод преназначен для получения списка всех чатов в подключенном аккаунте Telegram.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
limit3Необязательный параметр. Количество чатов для получения. Если не указывать, то по умолчанию установлено значение 200.
show_allfalseНеобязательный параметр. Позволяет получить все чаты. Значение может быть true или false. Если не указывать параметр, то по умолчанию false.
offset0Необязательный параметр. Определяет от какого по счету элемента вывести список чатов, где 0 это самый новый чат. Если не указывать, то по умолчанию установлено значение 0.
orderdescНеобязательный параметр. Значения desc или asc. Если desc - сортирует от новых к старым, если asc - от старых к новым. Если не указывать, то по умолчанию стоит desc. Сортировка по ID
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить список чатов200
{
  "status": "done",
  "timestamp": 1784537370,
  "time": "2026-07-20T11:49:30+03:00",
  "detail": "Chats fetched",
  "dialogs": [
    {
      "id": "2000000002",
      "channel": {
        "Creator": true,
        "Left": false,
        "Broadcast": false,
        "Verified": false,
        "Megagroup": true,
        "Restricted": false,
        "Signatures": false,
        "Min": false,
        "Scam": false,
        "HasLink": false,
        "HasGeo": false,
        "SlowmodeEnabled": false,
        "CallActive": false,
        "CallNotEmpty": false,
        "Fake": false,
        "Gigagroup": false,
        "Noforwards": false,
        "JoinToSend": false,
        "JoinRequest": false,
        "Forum": true,
        "StoriesHidden": false,
        "StoriesHiddenMin": false,
        "StoriesUnavailable": true,
        "ID": 2000000002,
        "AccessHash": -7000000000000000000,
        "Title": "Тестовая группа с темами",
        "Username": "",
        "Photo": {
          "HasVideo": false,
          "PhotoID": 0,
          "StrippedThumb": null,
          "DCID": 0
        },
        "Date": 1784467294,
        "RestrictionReason": null,
        "AdminRights": {
          "Flags": 0,
          "ChangeInfo": false,
          "PostMessages": false,
          "EditMessages": false,
          "DeleteMessages": false,
          "BanUsers": false,
          "InviteUsers": false,
          "PinMessages": false,
          "AddAdmins": false,
          "Anonymous": false,
          "ManageCall": false,
          "Other": false,
          "ManageTopics": false,
          "PostStories": false,
          "EditStories": false,
          "DeleteStories": false,
          "ManageDirectMessages": false,
          "ManageRanks": false,
          "ManageLinkedPeers": false
        },
        "BannedRights": {
          "Flags": 0,
          "ViewMessages": false,
          "SendMessages": false,
          "SendMedia": false,
          "SendStickers": false,
          "SendGifs": false,
          "SendGames": false,
          "SendInline": false,
          "EmbedLinks": false,
          "SendPolls": false,
          "ChangeInfo": false,
          "InviteUsers": false,
          "PinMessages": false,
          "ManageTopics": false,
          "SendPhotos": false,
          "SendVideos": false,
          "SendRoundvideos": false,
          "SendAudios": false,
          "SendVoices": false,
          "SendDocs": false,
          "SendPlain": false,
          "EditRank": false,
          "SendReactions": false,
          "ManageLinkedPeers": false,
          "UntilDate": 0
        },
        "DefaultBannedRights": {
          "Flags": 0,
          "ViewMessages": false,
          "SendMessages": false,
          "SendMedia": false,
          "SendStickers": false,
          "SendGifs": false,
          "SendGames": false,
          "SendInline": false,
          "EmbedLinks": false,
          "SendPolls": false,
          "ChangeInfo": false,
          "InviteUsers": false,
          "PinMessages": false,
          "ManageTopics": false,
          "SendPhotos": false,
          "SendVideos": false,
          "SendRoundvideos": false,
          "SendAudios": false,
          "SendVoices": false,
          "SendDocs": false,
          "SendPlain": false,
          "EditRank": false,
          "SendReactions": false,
          "ManageLinkedPeers": false,
          "UntilDate": 0
        },
        "ParticipantsCount": 0,
        "Usernames": null
      },
      "unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "isPinned": false,
      "name": "Тестовая группа с темами",
      "picture": "",
      "thumbnail": "https://fs.wappi.pro/fs/downloadFile/example-profile-id/avatars/tumb_100000016.jpg",
      "last_message_id": "27",
      "last_message_data": "Тестовое сообщение",
      "last_timestamp": 1784537367,
      "last_message_sender": {
        "id": "100000016",
        "type": null,
        "number": "79000000002",
        "pushname": "",
        "firstName": "Пользователь 16",
        "lastName": "",
        "picture": null,
        "thumbnail": null,
        "username": "user_016",
        "isMe": true
      },
      "last_message_type": "text",
      "last_time": "2026-07-20T08:49:27Z",
      "type": "chat",
      "last_message_delivery_status": "read",
      "total_messages": 0,
      "is_wappi_pinned": false,
      "is_wappi_archived": false,
      "wappi_tags": [],
      "wapi_unread_count": 7,
      "has_topics": true,
      "topics": [
        {
          "topic_id": 2,
          "parent_channel_id": 2000000002,
          "title": "Тема 1",
          "icon_color": 16766590,
          "created_at": 1784467393,
          "creator_peer_id": 100000016,
          "my": true,
          "top_message_id": 20,
          "topic_unread_count": 2,
          "topic_read_inbox_max": 4,
          "last_message_id": "20",
          "last_message_data": "Тестовое сообщение в теме",
          "last_message_type": "text",
          "last_message_time_stamp": 1784474318,
          "last_time": "2026-07-19T15:18:38Z",
          "last_message_sender": {
            "id": "100000016",
            "type": null,
            "number": "79000000002",
            "pushname": "",
            "firstName": "Пользователь 16",
            "lastName": "",
            "picture": null,
            "thumbnail": null,
            "username": "user_016",
            "isMe": true
          },
          "last_message_delivery_status": "delivered"
        },
        {
          "topic_id": 3,
          "parent_channel_id": 2000000002,
          "title": "Тема 2",
          "icon_color": 13338331,
          "created_at": 1784467400,
          "creator_peer_id": 100000016,
          "my": true,
          "top_message_id": 24,
          "topic_unread_count": 3,
          "topic_read_inbox_max": 5,
          "last_message_id": "24",
          "last_message_data": "Тестовое сообщение",
          "last_message_type": "text",
          "last_message_time_stamp": 1784481371,
          "last_time": "2026-07-19T17:16:11Z",
          "last_message_sender": {
            "id": "100000016",
            "type": null,
            "number": "79000000002",
            "pushname": "",
            "firstName": "Пользователь 16",
            "lastName": "",
            "picture": null,
            "thumbnail": null,
            "username": "user_016",
            "isMe": true
          },
          "last_message_delivery_status": "delivered"
        },
        {
          "topic_id": 1,
          "parent_channel_id": 2000000002,
          "title": "Общая",
          "icon_color": 7322096,
          "created_at": 1784467294,
          "creator_peer_id": 2000000002,
          "my": true,
          "is_general": true,
          "top_message_id": 27,
          "topic_unread_count": 2,
          "topic_read_inbox_max": 6,
          "last_message_id": "27",
          "last_message_data": "Тестовое сообщение",
          "last_message_type": "text",
          "last_message_time_stamp": 1784537367,
          "last_time": "2026-07-20T08:49:27Z",
          "last_message_sender": {
            "id": "100000016",
            "type": null,
            "number": "79000000002",
            "pushname": "",
            "firstName": "Пользователь 16",
            "lastName": "",
            "picture": null,
            "thumbnail": null,
            "username": "user_016",
            "isMe": true
          },
          "last_message_delivery_status": "delivered"
        }
      ]
    }
  ],
  "total_count": 180
}
GETПолучить список чатов с фильтром/tapi/sync/chats/filter

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
client_name79211Необязательный параметр. Можно указать часть номера или слова для фильтрации по номеру телефона, имени чата и последнему сообщению чата.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw

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

Responses
Получить список чатов с фильтром200
{
    "status": "done",
    "timestamp": 1781008057,
    "time": "2026-06-09T15:27:37+03:00",
    "detail": "Chats fetched",
    "dialogs": [
        {
            "id": "",
            "user": {
                "Self": false,
                "Contact": true,
                "MutualContact": true,
                "Deleted": false,
                "Bot": false,
                "BotChatHistory": false,
                "BotNochats": false,
                "Verified": false,
                "Restricted": false,
                "Min": false,
                "BotInlineGeo": false,
                "Support": false,
                "Scam": false,
                "ApplyMinPhoto": true,
                "Fake": false,
                "BotAttachMenu": false,
                "Premium": true,
                "AttachMenuEnabled": false,
                "BotCanEdit": false,
                "CloseFriend": false,
                "StoriesHidden": false,
                "StoriesUnavailable": true,
                "ID": ,
                "AccessHash": 7622270479485868755,
                "FirstName": "",
                "LastName": "",
                "Username": "",
                "Phone": "79211111111",
                "Photo": {
                    "HasVideo": false,
                    "Personal": false,
                    "PhotoID": 2438582611790112682,
                    "StrippedThumb": "AQgIRog1kF2/MOcZ70UUVRbR",
                    "DCID": 2
                },
                "Status": [
                    {
                        "Key": "wasonline",
                        "Value": 1780509213
                    }
                ],
                "BotInfoVersion": 0,
                "BotInlinePlaceholder": "",
                "LangCode": "",
                "Usernames": null
            },
            "unread_count": 1,
            "isDeleted": false,
            "isArchived": false,
            "isPinned": false,
            "name": "",
            "picture": "",
            "last_message_id": "1189",
            "last_message_data": "на проводе",
            "last_timestamp": 1779095802,
            "last_message_sender": {
                "id": "",
                "type": "user",
                "number": "79211111111",
                "pushname": "",
                "firstName": "",
                "lastName": "",
                "picture": null,
                "thumbnail": null,
                "username": "",
                "isMe": false
            },
            "last_message_type": "text",
            "last_time": "2026-05-18T09:16:42Z",
            "type": "user",
            "last_message_delivery_status": "",
            "total_messages": 1213,
            "is_wappi_pinned": false,
            "wapi_unread_count": 1
        }
    ],
    "total_count": 1
}
GETПолучить список чатов по дням/tapi/sync/chats/days/get

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
offset0Необязательный параметр. Отступ от текущего момента в днях. Если не указывать, то по умолчанию установлено значение 0.
limit7Необязательный параметр. Количество дней в выборке. Если не указывать, то по умолчанию установлено значение 20.
orderdescНеобязательный параметр. Сортировка. Возможные варианты asc и desc. По умолчанию desc
is_archivedtrueНеобязательный параметр. Фильтр по архивным чатам. Возможные значения true и false. По умолчанию false.
is_deletedtrueНеобязательный параметр. Фильтр по удаленным чатам. Возможные значения true и false. По умолчанию false.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw

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

Responses
Получить список чатов по дням200
{
  "status": "done",
  "timestamp": 1742205785,
  "time": "2025-03-17T13:03:05+03:00",
  "detail": "Chats fetched",
  "dialogs": [
    {
      "id": "4127433587",
      "chat": {
        "Creator": false,
        "Left": false,
        "Deactivated": false,
        "CallActive": false,
        "CallNotEmpty": false,
        "Noforwards": false,
        "ID": 4127433587,
        "Title": "тест приват",
        "Photo": {
          "HasVideo": false,
          "PhotoID": 0,
          "StrippedThumb": null,
          "DCID": 0
        },
        "ParticipantsCount": 4,
        "Date": 1705857273,
        "Version": 6
      },
      "participants": [
        {
          "user_id": "5279188641",
          "is_admin": false,
          "is_creator": false,
          "name": "Varis",
          "username": "varisvar",
          "phone": "",
          "is_bot": false,
          "is_me": false,
          "inviter_id": "89323786",
          "invite_timestamp": 1707850171
        },
        {
          "user_id": "89323786",
          "is_admin": false,
          "is_creator": false,
          "name": "Любимый",
          "username": "FL00D",
          "phone": "",
          "is_bot": false,
          "is_me": false,
          "inviter_id": "5272797466",
          "invite_timestamp": 1705857296
        },
        {
          "user_id": "60227586",
          "is_admin": false,
          "is_creator": false,
          "name": "Minay",
          "username": "minayq",
          "phone": "",
          "is_bot": false,
          "is_me": false,
          "inviter_id": "89323786",
          "invite_timestamp": 1705859852
        },
        {
          "user_id": "5272797466",
          "is_admin": false,
          "is_creator": true,
          "name": "Mr. Charrington",
          "username": "Mr_Charrington",
          "phone": "",
          "is_bot": false,
          "is_me": false,
          "inviter_id": "",
          "invite_timestamp": 0
        }
      ],
      "unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "isPinned": false,
      "name": "тест приват",
      "picture": "",
      "last_message_id": "5886",
      "last_message_data": "Спасибо, что обратились в нашу компанию.",
      "last_timestamp": 1742042052,
      "last_message_sender": {
        "id": "5279188641",
        "type": "user",
        "number": "996507585526",
        "pushname": "Varis",
        "firstName": "",
        "lastName": "",
        "picture": null,
        "thumbnail": null,
        "username": "varisvar",
        "isMe": true
      },
      "last_message_type": "text",
      "last_time": "2025-03-15T12:34:12Z",
      "type": "chat",
      "last_message_delivery_status": "",
      "total_messages": 184
    },
    {
      "id": "89323786",
      "user": {
        "Self": false,
        "Contact": true,
        "MutualContact": true,
        "Deleted": false,
        "Bot": false,
        "BotChatHistory": false,
        "BotNochats": false,
        "Verified": false,
        "Restricted": false,
        "Min": false,
        "BotInlineGeo": false,
        "Support": false,
        "Scam": false,
        "ApplyMinPhoto": true,
        "Fake": false,
        "BotAttachMenu": false,
        "Premium": false,
        "AttachMenuEnabled": false,
        "BotCanEdit": false,
        "CloseFriend": false,
        "StoriesHidden": false,
        "StoriesUnavailable": true,
        "ID": 89323786,
        "AccessHash": 8858128198849465000,
        "FirstName": "Любимый",
        "LastName": "",
        "Username": "FL00D",
        "Phone": "79115576367",
        "Photo": {
          "HasVideo": false,
          "Personal": false,
          "PhotoID": 383642740081142000,
          "StrippedThumb": "AQgIry2kMI+9ub0oooqlJk2P",
          "DCID": 2
        },
        "Status": [
          {
            "Key": "flags",
            "Value": 0
          },
          {
            "Key": "byme",
            "Value": false
          }
        ],
        "BotInfoVersion": 0,
        "BotInlinePlaceholder": "",
        "LangCode": "",
        "Usernames": null,
        "StoriesMaxID": 0
      },
      "unread_count": 0,
      "isDeleted": false,
      "isArchived": false,
      "isPinned": false,
      "name": "Любимый",
      "picture": "",
      "thumbnail": "https://fs.wappi.pro/fs/downloadFile/51a8107a-5442/avatars/tumb_89323786.jpg",
      "last_message_id": "5888",
      "last_message_data": "Пожалуйста, оцените качество обслуживания.\n\nОтправьте: 1 - хорошо, 0 - плохо",
      "last_timestamp": 1742042291,
      "last_message_sender": {
        "id": "5279188641",
        "type": "user",
        "number": "996507585526",
        "pushname": "Varis",
        "firstName": "",
        "lastName": "",
        "picture": null,
        "thumbnail": null,
        "username": "varisvar",
        "isMe": true
      },
      "last_message_type": "text",
      "last_time": "2025-03-15T12:38:11Z",
      "type": "user",
      "last_message_delivery_status": "",
      "total_messages": 1270
    }
  ],
  "total_count": 2
}
POSTУстановить статус "печатает"/tapi/sync/chats/typing/start

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель сообщения (кто будет видеть "печатает..." в диалоге). В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "recipient": "testname"
}
Responses
Установить статус "печатает"200
{
  "status": "done",
  "timestamp": 1781081434,
  "time": "2026-06-10T11:50:34+03:00",
  "task_id": "924aaab084b83e6fd7619aebea950b9a",
  "uuid": "48affe30-713e"
}
POSTПереименовать чат/tapi/chat/rename

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
chat_idstringДаИдентификатор чата, название которого необходимо изменить. Пример: "123456789"
namestringДаНовое название чата\*. Пример: "Новый название"

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "chat_id": "5431234384",
  "name": "Новое название"
}
Работа с контактами4 метода
GETПолучить контакты/tapi/sync/contacts/get

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить контакты200
{
  "status": "done",
  "timestamp": 1781081962,
  "time": "2026-06-10T11:59:22+03:00",
  "contacts": [
    {
      "id": "123456789",
      "type": "user",
      "number": "79115556677",
      "pushname": "Иван Иванов",
      "firstName": "Иван",
      "lastName": "Иванов",
      "picture": null,
      "thumbnail": null,
      "username": "ivan_ivanov",
      "isMe": false
    },
    {
      "id": "987654321",
      "type": "user",
      "number": "79216667788",
      "pushname": "Петр Петров",
      "firstName": "Петр",
      "lastName": "Петров",
      "picture": null,
      "thumbnail": null,
      "username": "petr_petrov",
      "isMe": false
    }
  ],
  "task_id": "",
  "uuid": ""
}
GETПолучить контакт/tapi/sync/contact/get

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
recipient60227586Обязательный параметр. Получатель сообщения*. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить контакт200
{
  "status": "done",
  "timestamp": 1781082072,
  "time": "2026-06-10T12:01:12+03:00",
  "contact": {
    "id": "",
    "type": "user",
    "number": "",
    "pushname": " ",
    "firstName": "",
    "lastName": "",
    "picture": null,
    "thumbnail": "",
    "username": "",
    "isMe": false
  },
  "task_id": "",
  "uuid": ""
}
POSTДобавить контакт/tapi/sync/contact/add

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

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

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

После успешного выполнения контакт будет сохранён в адресной книге Telegram аккаунта. Метод также можно использовать для проверки существования номера в Telegram: если указанный номер не зарегистрирован в Telegram, контакт не будет добавлен и API вернёт ошибку.

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаНомер телефона пользователя, которого необходимо добавить в контакты. Допускаются различные форматы записи номера (со знаком +, пробелами, скобками, дефисами). Пример: "79111111111"
namestringДаИмя контакта, которое будет отображаться в адресной книге Telegram. Пример: "Иван Иванов"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "recipient": "79111111111",
  "name": "contactName"
}
Responses
Добавить контакт200
{
  "status": "done",
  "timestamp": 1781083382,
  "time": "2026-06-10T12:23:02+03:00",
  "contact": {
    "id": "123456789",
    "type": "user",
    "number": "79115556677",
    "pushname": "Иван Иванов",
    "firstName": "Иван",
    "lastName": "Иванов",
    "picture": null,
    "thumbnail": "https://example.com/avatar.jpg",
    "username": "ivan_ivanov",
    "isMe": false
  },
  "task_id": "439c1f1fa8addaebd371ccba18f6af26",
  "uuid": "48affe30-713e"
}
POSTПереименовать контакт/tapi/contact/rename

URL: https://wappi,pro/tapi/contact/rename?profile_id={{profile_id}}

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДа\*Контакт. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи (со знаком +, пробелами, скобками, дефисами). Для имени пользователя допускается указание как с символом @, так и без него. Примеры: "79115556677", "@testname", "testname", "123456789"
phonestringДа\*Номер телефона контакта. Допускаются различные форматы записи (со знаком +, пробелами, скобками и дефисами). Используется для поиска контакта. Пример: "79991234567"
namestringДаНовое имя контакта. Пример: "Иван"
last_namestringНетНовая фамилия контакта. Пример: "Иванов"

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    //"phone": "89110000000",
    "recipient": "username",
    "name": "Иван",
    "last_name": "Иванов"
}
Работа с группами8 методов
POSTСоздать группу/tapi/sync/group/create

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

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
namestringДаНазвание создаваемой группы. Пример: "Название группы"
participantsarray\[string\]ДаСписок участников группы. В качестве каждого участника можно указать номер телефона, имя пользователя, ссылку t.me/... или известный peer id. Для номера телефона допускаются различные форматы записи. Для имени пользователя допускается указание как с символом @, так и без него. Примеры: ["79115556677", "@username"]
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "name": "Тестовая группа",
  "participants": [
    "username",
    "79001110000"
  ]
}
Responses
Создать группу200
{
  "status": "done",
  "timestamp": 1783431326,
  "time": "2026-07-07T16:35:26+03:00",
  "detail": "5490007394",
  "contact": {
    "id": "5490007394",
    "type": null,
    "number": "",
    "pushname": "Тестовая группа",
    "firstName": "",
    "lastName": "",
    "picture": null,
    "thumbnail": null,
    "username": "",
    "isMe": false
  },
  "task_id": "428ca9c58bc9bb4a09094c396993928b",
  "uuid": "1e10b84c-25b8"
}
POSTПокинуть группу/tapi/sync/group/leave

URL: https://wappi.pro/tapi/sync/group/leave?profile_id={{profile_id}}&group_id=5583947306

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

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

После успешного выполнения метода подключённый аккаунт покидает указанный чат. Метод можно использовать для групп, супергрупп и каналов.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
group_id5583947306Обязательный параметр. Группа (в т.ч. супергруппа, канал), которую необходимо покинуть. Можно передать как ID, ссылку или @groupname. Примеры: "1001234567890", "t.me/..."
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Покинуть группу200
{
  "status": "done",
  "timestamp": 1783431408,
  "time": "2026-07-07T16:36:48+03:00",
  "task_id": "68c969f34140370cdf6ff76768b28079",
  "uuid": "1e10b84c-25b8"
}
POSTДобавить участников в группу/tapi/sync/group/participant/add

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

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

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

Если у пользователя в настройках Telegram запрещено добавление в группы, он не будет добавлен.

Request Body

ПараметрТип данныхОбяз.Описание и пример
group_idstringДаГруппа (в т.ч. супергруппа, канал), в которую необходимо добавить участников. Можно передать как ID, ссылку или @groupname.
Примеры: "1001234567890",
t.me/....
participantsarray\[string\]Да\*Список участников для добавления. В качестве каждого участника можно указать номер телефона, имя пользователя, ссылку t.me/... или известный peer id. Пример: ["79115556677", "@username"]
participantstringДа\*Один участник для добавления. Используется для совместимости вместо массива participants. Пример: "79115556677"

\*Необходимо передать participants или participant.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "group_id": "5490007394",
    "participants": ["username", "79110000000"]
//  "participant": "username"
}
Responses
Добавить участника в группу200
{
  "status": "done",
  "timestamp": 1783432228,
  "time": "2026-07-07T16:50:28+03:00",
  "task_id": "b01d08817a668082f7cb7c18138c49cc",
  "uuid": "1e10b84c-25b8"
}
POSTУдалить участников из группы/tapi/sync/group/participant/remove

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
group_idstringДаГруппа (в т.ч. супергруппа, канал), из которой необходимо удалить участников. Можно передать как ID, ссылку или @groupname.
Примеры: "1001234567890",
t.me/....
participantsarray\[string\]ДаСписок участников для удаления. В качестве каждого участника можно указать номер телефона, имя пользователя, ссылку t.me/... или известный peer id. Пример: ["79115556677", "@username"]
participantstringДа\*Один участник для удаления. Используется для совместимости вместо массива participants. Пример: "79115556677"

\*Необходимо передать participants или participant.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "group_id": "5490007394",
    "participants": ["79110000000", "username"]
//  "participant": "username"
}
Responses
Удалить участников из группы200
{
  "status": "done",
  "timestamp": 1783432896,
  "time": "2026-07-07T17:01:36+03:00",
  "task_id": "f66f1024c7bb31e33aa7eefd85165c98",
  "uuid": "1e10b84c-25b8"
}
POSTНазначить администратора/tapi/sync/group/admin/promote

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
group_idstringДаГруппа (в т.ч. супергруппа, канал), в которой необходимо назначить администратора. Можно передать как ID, ссылку или @groupname.
Примеры: "1001234567890",
t.me/....
participantsarray\[string\]ДаСписок участников, которым необходимо выдать права администратора. В качестве каждого участника можно указать номер телефона, имя пользователя, ссылку t.me/... или известный peer id. Пример: ["79115556677", "@username"]
participantstringДа\*Один участник. Используется для совместимости вместо массива participants. Пример: "79115556677"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "group_id": "5490007394",
    "participants": ["79110000000", "username"]
//  "participant": "username"
}
Responses
Назначить администратора200
{
  "status": "done",
  "timestamp": 1783434804,
  "time": "2026-07-07T17:33:24+03:00",
  "task_id": "64f2eabd4e691e42e703494b9d38db38",
  "uuid": "1e10b84c-25b8"
}
POSTСнять права администратора/tapi/sync/group/admin/demote

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

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

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

ПараметрТип данныхОбяз.Описание и пример
group_idstringДаГруппа (в т.ч. супергруппа, канал), в которой необходимо убрать администратора. Можно передать как ID, ссылку или @groupname.
Примеры: "1001234567890",
t.me/....
participantsarray\[string\]ДаСписок участников, у которых необходимо снять права администратора. В качестве каждого участника можно указать номер телефона, имя пользователя, ссылку t.me/... или известный peer id. Пример: ["79115556677", "@username"]
participantstringДа\*Один участник. Используется для совместимости вместо массива participants. Пример: "79115556677"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
    "group_id": "5490007394",
    "participants": ["79110000000", "username"]
//  "participant": "username"
}
Responses
Снять права администратора200
{
  "status": "done",
  "timestamp": 1783437168,
  "time": "2026-07-07T18:12:48+03:00",
  "task_id": "19a50478fdf98f886c6ca7533110060e",
  "uuid": "1e10b84c-25b8"
}
POSTУстановить описание группы/tapi/sync/group/description/set

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
group_idstringДаГруппа (в т.ч. супергруппа, канал), для которой необходимо изменить описание. Можно передать как ID, ссылку или @groupname.
Примеры: "1001234567890",
t.me/....
descriptionstringДаНовое описание группы, супергруппы или канала. Пример: "Новое описание группы"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "group_id": "5490007394",
  "description": "Тестовое описание группы"
}
Responses
Установить описание группы200
{
  "status": "done",
  "timestamp": 1783437939,
  "time": "2026-07-07T18:25:39+03:00",
  "task_id": "daa703dc428d41429ae8e0683e499b94",
  "uuid": "1e10b84c-25b8"
}
POSTУстановить имя группы/tapi/sync/group/name/set

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

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
group_idstringДаГруппа (в т.ч. супергруппа, канал), для которой необходимо изменить название. Можно передать как ID, ссылку или @groupname.
Примеры: "1001234567890",
t.me/....
namestringДаНовое название группы, супергруппы или канала. Пример: "Новое название"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "group_id": "5490007394",
  "name": "Новое тестовое имя группы"
}
Responses
Установить имя группы200
{
  "status": "done",
  "timestamp": 1783438016,
  "time": "2026-07-07T18:26:56+03:00",
  "task_id": "20c3007485419e9e7a2a8b9b990cc854",
  "uuid": "1e10b84c-25b8"
}
Работа со сторис2 метода
POSTОпубликовать сторис/tapi/sync/stories/send

URL: https://wappi.pro/tapi/sync/stories/send?profile_id={{profile_id}}

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

Метод предназначен для публикации сторис от имени подключённого Telegram-аккаунта.

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
urlstringДаПрямая ссылка на изображение или видео, которое необходимо опубликовать в сторис. Пример: "https://example.com/image.jpg"
captionstringНетТекст сторис. Пример: "Это подпись"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "url": "https://www.rdm-kirov.ru/images/test.jpg",
  "caption": "Это подпись"
}
Responses
Опубликовать сторис200
{
  "status": "done",
  "timestamp": 1738176791,
  "time": "2025-01-29T21:53:11+03:00",
  "task_id": "d88fa080-cfb6-45bd-9bdd-9601d8f52004",
  "uuid": "c30db3c8-2aec",
  "story_id": "11"
}
GETПолучить информацию о просмотрах/tapi/sync/stories/getViews

URL: https://wappi.pro/tapi/sync/stories/getViews?profile_id={{profile_id}}&id=11&limit=10&offset=0

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

Получение информации о пользователях, которые просмотрели сторис.

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
id11Обязательный параметр. Получить story_id можно при публикации сторис.
limit10Необязательный параметр. Количество чатов для получения. Если не указывать, то по умолчанию установлено значение 100.
offset0Необязательный параметр. Определяет от какого по счету элемента вывести список сообщений, где 0 это самое новое сообщение. Если не указывать, то по умолчанию установлено значение 0.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить информацию о просмотрах200
{
  "status": "done",
  "timestamp": 1738176849,
  "time": "2025-01-29T21:54:09+03:00",
  "task_id": "89936624-5f7b-4ab6-9fff-992d45db14c7",
  "uuid": "c30db3c8-2aec",
  "views": 1,
  "offset": "",
  "users": [
    {
      "id": "60227586",
      "type": "user",
      "number": "",
      "pushname": "",
      "firstName": "Minay",
      "lastName": "",
      "picture": null,
      "thumbnail": null,
      "username": "minayq"
    }
  ]
}
Работа с подарками2 метода
POSTОтправить подарок/tapi/gifts/send

URL: https://wappi.pro/tapi/gifts/send?profile_id={{profile_id}}

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

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

Request Body

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаПолучатель подарка. В качестве значения можно указать номер телефона, имя пользователя, идентификатор пользователя или идентификатор чата. Для номера телефона допускаются различные форматы записи. Для username допускается указание как с символом @, так и без него. Примеры: "79115556677", "@username", "username", "123456789"
gift_idintegerДаИдентификатор подарка, который необходимо отправить. Пример: 5170233102089322716
captionstringНетТекст сообщения, который будет отправлен вместе с подарком. Пример: "Поздравляю"
Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
{
  "recipient": "username",
  "caption": "Поздравляю",
  "gift_id": 5170233102089322000
}
GETПолучить список подарков/tapi/gifts/get

URL: https://wappi.pro/tapi/gifts/get?profile_id={{profile_id}}

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Работа с webhook (уведомлениями)4 метода
GETПолучить ссылку на webhook/tapi/webhook/url/get

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить ссылку на webhook200
{
  "detail": "WebHook установлен на адрес https://webhook.site/83297f77-bd21-4846-8b20-92d92fe74a7b",
  "status": "done",
  "url": "https://webhook.site/83297f77-bd21-4846-8b20-92d92fe74a7b",
  "auth": "",
  "installed": true
}
POSTУстановить ссылку на webhook/tapi/webhook/url/set

URL: https://wappi.pro/tapi/webhook/url/set?profile_id={{profile_id}}&url=https://webhook.site/xxxxxx&auth=34hlaksduoiyurtxm

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
urlhttps://webhook.site/xxxxxxОбязательный параметр. URL ссылки на вебхук.
auth34hlaksduoiyurtxmНеобязательный параметр. Авторизация в вебхуке
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Установить ссылку на webhook200
{
  "status": "done",
  "timestamp": 1781095787,
  "time": "2026-06-10T15:49:47+03:00",
  "detail": "webhook url: https://webhook.site/xxxxxxx",
  "task_id": "199d13503900e26b31ba679148c3a3db",
  "uuid": ""
}
POSTУдалить ссылку на webhook/tapi/webhook/url/delete

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Удалить ссылку на webhook200
{
  "status": "done",
  "timestamp": 1782897399,
  "time": "2026-07-01T12:16:39+03:00",
  "detail": "webhook was deleted",
  "task_id": "c53be3315a49ee15205bfcb5e2fe012b",
  "uuid": "48affe30-713e"
}
POSTНастройка типов webhook уведомлений/tapi/webhook/types/set

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

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

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

Request Body

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

Типы webhook-уведомлений**:

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw
[
  "authorization_status",
  "incoming_message",
  "delivery_status",
  "outgoing_message_phone",
  "outgoing_message_api",
  "application_status"
]
Responses
Настройка типов webhook уведомлений200
{
  "status": "done",
  "timestamp": 1782897289,
  "time": "2026-07-01T12:14:49+03:00",
  "detail": "webhook types: [authorization_status incoming_message delivery_status outgoing_message_phone outgoing_message_api application_status]",
  "task_id": "fe5242634b173bf60011c009475953cb",
  "uuid": "48affe30-713e"
}
Работа с proxy3 метода
GETПолучить proxy/tapi/proxy/get

URL: https://wappi.pro/tapi/proxy/get?profile_id={{profile_id}}

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить proxy200
{
  "proxy": null,
  "status": "done"
}
POSTУстановить proxy/tapi/proxy/set

URL: https://wappi.pro/tapi/proxy/set?profile_id={{profile_id}}&proxy=username:password@127.0.0.1:1080

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

Метод предназначен для установки своего proxy. Подходят только socks5 прокси в формате "login:password@ip:port" или "ip:port"

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
proxyusername:password@127.0.0.1:1080Обязательный параметр. Подходят только socks5 прокси в формате `login:password@ip:port` или `ip:port`. Установить можно только рабочий прокси
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
POSTУдалить proxy/tapi/proxy/delete

URL: https://wappi.pro/tapi/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Получить очередь сообщений у профиля/tapi/profile/queue/get

URL: https://wappi.pro/tapi/profile/queue/get?profile_id={{profile_id}}

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить очередь сообщений у профиля200
{
  "status": "done",
  "tasks": null
}
GETОчистить очередь сообщений у профиля/tapi/profile/queue/purge

URL: https://wappi.pro/tapi/profile/queue/purge?profile_id={{profile_id}}

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Очистить очередь сообщений у профиля200
{
  "detail": "Successfully cleared the queue",
  "status": "done"
}
GETПолучить данные по задаче/tapi/task/get

URL: https://wappi.pro/tapi/task/get?profile_id={{profile_id}}&task_id=003f22b59a7c5f9a8ed883ca7cb7aa50

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
task_id003f22b59a7c5f9a8ed883ca7cb7aa50Обязательный параметр. Task_id можно получить в ответах в методах по отправке сообщений.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить данные по задаче200
{
  "status": "done",
  "task": {
    "task_id": "003f22b59a7c5f9a8ed883ca7cb7aa50",
    "command_start": "2026-06-09T09:07:14.975Z",
    "command": "sendAudio",
    "recipient": "",
    "uuid": "48affe30-713e",
    "mime": "audio/mpeg",
    "caption": "Это аудио",
    "file_name": "sample.mp3",
    "response": {
      "status": "done",
      "timestamp": 1780996034,
      "time": "2026-06-09T12:07:15+03:00",
      "detail": "",
      "task_id": "003f22b59a7c5f9a8ed883ca7cb7aa50",
      "command_start": "2026-06-09T09:07:14.975Z",
      "command_end": "2026-06-09T09:07:15.293Z",
      "uuid": "48affe30-713e",
      "message_id": "9678",
      "pts": 19142,
      "pts_count": 1,
      "delivery_status": "delivered"
    },
    "filter": {},
    "timeout_from": 1,
    "timeout_to": 3
  }
}
GETПолучить данные по всем задачам/tapi/tasks/get

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

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

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

Query Params
ПараметрЗначениеОписание
profile_id{{profile_id}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
limit2Необязательный параметр. Количество чатов для получения. Если не указывать, то по умолчанию установлено значение 200.
offset0Необязательный параметр. Определяет от какого по счету элемента вывести список сообщений, где 0 это самое новое сообщение. Если не указывать, то по умолчанию установлено значение 0.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Получить данные по всем задачам200
{
  "status": "done",
  "tasks": [
    {
      "task_id": "76db1be692414a9b2c74493bf9339fa3",
      "command_start": "2026-06-10T10:09:20.712Z",
      "command": "sendStory",
      "uuid": "48affe30-713e",
      "caption": "Это подпись",
      "response": null,
      "url": "https://img.magnific.com/free-photo/cute-kitten-sitting-staring-playful-fluffy-looking-camera-generated-by-artificial-intelligence_188544-113029.jpg",
      "filter": {}
    },
    {
      "task_id": "82e65df410ea32f34ad67f67f14eaeae",
      "command_start": "2026-06-10T09:29:13.489Z",
      "command": "sendStory",
      "uuid": "48affe30-713e",
      "caption": "Это подпись",
      "response": null,
      "url": "https://img.magnific.com/free-photo/cute-kitten-sitting-staring-playful-fluffy-looking-camera-generated-by-artificial-intelligence_188544-113029.jpg",
      "filter": {}
    }
  ]
}
Массовая рассылка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
Responses
Запустить рассылку Start200
{
    "status": "done",
    "timestamp": 1781187491,
    "time": "2026-06-11T17:18:11+03:00",
    "detail": "Рассылка запущена",
    "posting": {
        "active": 3,
        "messages_count": 3,
        "profile_id": 0000000,
        "profile_uuid": "",
        "platform": "tg",
        "user_id": 00000,
        "mass_posting_id": "b51cc198-a0db-4c",
        "profile_name": "testTG",
        "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}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
offset0Необязательный параметр. От какого по счету элемента вывести список сообщений, где 0 это самое новое сообщение. Если не указывать, то по умолчанию установлено значение 0.
limit3Необязательный параметр. Количество сообщений для получения. Если не указывать, то по умолчанию установлено значение 200.
Headers
КлючЗначениеОписание
Authorization{{Token}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Responses
Список всех рассылок200
{
  "all_history_count": 37,
  "consumers": null,
  "mass_posting_history": [
    {
      "profile_uuid": "71ad40e9-b023",
      "profile_name": "Профиль 1",
      "mass_posting_id": "68c2ddf4-d78c-46",
      "done": 2,
      "all": 3,
      "date": "2023-05-27T10:46:15.677Z"
    },
    {
      "profile_uuid": "71ad40e9-b023",
      "profile_name": "Профиль 1",
      "mass_posting_id": "397f4261-483e-43",
      "done": 3,
      "all": 3,
      "date": "2023-05-27T10:44:08.243Z"
    },
    {
      "profile_uuid": "71ad40e9-b023",
      "profile_name": "Профиль 1",
      "mass_posting_id": "a5c1b3dc-47c1-40",
      "done": 1,
      "all": 1,
      "date": "2023-05-26T12:02:36.735Z"
    }
  ],
  "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=)
offset0Необязательный параметр. От какого по счету элемента вывести список сообщений, где 0 это самое новое сообщение. Если не указывать, то по умолчанию установлено значение 0.
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

ПараметрТип данныхОбяз.Описание и пример
recipientstringДаНомер телефона получателя, на который будет выполнена отправка через каскад. Допускаются различные форматы записи номера телефона (со знаком +, пробелами, скобками и дефисами). Примеры: "79115556677", "+7 (911) 555-66-77"
bodystringДа\*Текст сообщения. Поддерживаются переносы строк и emoji. Пример: "Тестовое сообщение"
captionstringНетПодпись к вложению. Используется при отправке медиафайла. Пример: "Описание файла"
cascade_idstringДаИдентификатор каскада, через который необходимо выполнить отправку сообщения. Пример: "94b1f524059b29e514ef"
file_namestringНетИмя файла, которое будет отображаться получателю. Используется при отправке вложения по ссылке. Примеры: "image.jpg", "document.pdf"
urlstringДа\*Прямая ссылка на файл, который необходимо отправить получателю. Пример: "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

ПараметрТип данныхОбяз.Описание и пример
namestringДаНазвание каскада. Пример: "Cascade Test"
descriptionstringНетОписание каскада. Пример: "Тестовое описание каскада"
order\[\]arrayДаМассив этапов каскада в порядке выполнения.
order\[\].idintegerДаПорядковый номер этапа каскада. Пример: 1
order\[\].profile_uuidstringДаИдентификатор профиля, через который будет выполняться отправка на данном этапе.
order\[\].platformstringДаПлатформа профиля. Возможные значения зависят от используемых каналов. Примеры: "tg", "wa", "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_idstringДаИдентификатор каскада. Пример: "6736ebe208b0fd04c84f"
namestringНетНазвание каскада. Пример: "NewCascade"
descriptionstringНетОписание каскада.
order\[\]arrayНетСписок этапов каскада в порядке выполнения.
order\[\].idintegerНетПорядковый номер этапа каскада. Пример: 1
order\[\].profile_uuidstringНетИдентификатор профиля, через который будет выполняться отправка на данном этапе.
order\[\].platformstringДаПлатформа профиля. Примеры: "tg", "wa", "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}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw

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

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}}Обязательный параметр. Можно получить в личном кабинете на странице конкретного профиля.
Тело запроса raw

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

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

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

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

01Возьмите токен

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

02Укажите profile_id

Вставьте токен в блоке тестового запроса, а profile_id укажите ниже в Query Params выбранного метода.

03Заполните параметры

Выберите метод слева, добавьте query-параметры и тело запроса, если они нужны.

04Отправьте запрос

Нажмите «Отправить запрос» и проверьте ответ тестового контура.

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

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

POST
Подробная информацияURL, описание, параметры, headers, тело запроса, responses и CURLСвернутьРазвернуть
POSThttps://wappi.pro/tapi/profile/add?name=Новый профиль&webhook_url=https://wappi.pro

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

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

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

Query Params

ПараметрЗначениеОписание
nameНовый профильОбязательный параметр. Имя нового профиля.
webhook_urlhttps://wappi.proНеобязательный параметр. Установка URL ссылки на вебхук.

Headers

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

Responses

Создать профиль200
{
  "profile_id": "934c69b7-b896",
  "status": "done",
  "time": "2026-06-01T12:42:14+03:00",
  "timestamp": 1780306934
}

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

curl --request POST 'https://wappi.pro/tapi/profile/add?name=Новый профиль&webhook_url=https://wappi.pro' \
    --header 'Authorization: {{Token}}'

Тест запроса

POSThttps://wappi.pro/tapi/profile/add?name=%D0%9D%D0%BE%D0%B2%D1%8B%D0%B9+%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8C&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": "5889",
    "profile_id": "51a8107a-5442",
    "wh_type": "delivery_status",
    "timestamp": "2025-03-17T14:57:59.611515092+03:00",
    "time": 1742212679,
    "from": "5279188641",
    "to": "60227586",
    "chat_id": "60227586",
    "status": "delivered",
    "task_id": "f7ff034a-0455-4c96-bf5a-ed5915ee300f"
  }
}
Свернуть

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

Есть несколько статусов профиля - online, offline


{
  "messages": [
    {
      "wh_type": "authorization_status",
      "profile_id": "fae370e3-0a1a",
      "status": "online",
      "phone": "966507585521",
      "timestamp": "2024-03-02T15:52:38.75126472+03:00",
      "time": 1709383958
    }
  ]
}
Свернуть

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": [
    {
      "id": "5902",
      "profile_id": "51a8107a-5442",
      "wh_type": "incoming_message",
      "timestamp": "2025-03-17T15:14:37+03:00",
      "time": 1742213677,
      "body": "Текстовое сообщение",
      "type": "text",
      "from": "60227586",
      "to": "5279188641",
      "senderName": "Sinn",
      "chatId": "60227586",
      "caption": null,
      "from_where": "phone",
      "contact_name": "Sinn",
      "contact_phone": "",
      "contact_username": "sinay",
      "username": "sinay",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "is_me": false,
      "chat_type": "user",
      "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
      "picture": "",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false
    }
  ]
}
Свернуть

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

Обратите внимание, все изображения отдаются в формате base64. 


{
  "messages": [
    {
      "id": "5903",
      "profile_id": "51a8107a-5442",
      "wh_type": "incoming_message",
      "timestamp": "2025-03-17T15:16:03+03:00",
      "time": 1742213763,
      "body": "JVBERi0xLjcNCiXi48/TDQo1IDAgb2JqD",
      "type": "image",
      "from": "60227586",
      "to": "5279188641",
      "senderName": "Sinn",
      "chatId": "60227586",
      "caption": "Подпись",
      "from_where": "phone",
      "mimetype": "image/jpeg",
      "contact_name": "Sinn",
      "contact_phone": "",
      "contact_username": "sinay",
      "username": "sinay",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "is_me": false,
      "chat_type": "user",
      "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
      "picture": "",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false,
      "file_link": "https://wapi-u.storage.yandexcloud.net/51a",
      "file_link_expire": 1742472963
    }
  ]
}
Свернуть

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

Обратите внимание, что все видео отдаются в формате base64. 


{
  "messages": [
    {
      "id": "5904",
      "profile_id": "51a8107a-5442",
      "wh_type": "incoming_message",
      "timestamp": "2025-03-17T15:18:38+03:00",
      "time": 1742213918,
      "body": "JVBERi0xLjcNCiXi48/TDQo1IDAgb2JqD",
      "type": "video",
      "from": "60227586",
      "to": "5279188641",
      "senderName": "Sinn",
      "chatId": "60227586",
      "caption": "Подпись",
      "from_where": "phone",
      "file_name": "video.mp4",
      "mimetype": "video/mp4",
      "contact_name": "Sinn",
      "contact_phone": "",
      "contact_username": "sinay",
      "username": "sinay",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "is_me": false,
      "chat_type": "user",
      "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
      "picture": "",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false,
      "file_link": "https://wapi-u.storage.yandexcloud.net/51a",
      "file_link_expire": 1742473119
    }
  ]
}
Свернуть

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

Обратите внимание, что все файлы и документы отдаются в формате base64.


{
  "messages": [
    {
      "id": "5916",
      "profile_id": "51a8107a-5442",
      "wh_type": "incoming_message",
      "timestamp": "2025-03-17T15:38:57+03:00",
      "time": 1742215137,
      "body": "JVBERi0xLjcNCiXi48/TDQo1IDAgb2JqD",
      "type": "document",
      "from": "60227586",
      "to": "5279188641",
      "senderName": "Minay",
      "chatId": "60227586",
      "caption": "",
      "from_where": "phone",
      "file_name": "Счет на оплату № 24 от 17 марта 2025 г.pdf",
      "mimetype": "application/pdf",
      "contact_name": "Minay",
      "contact_phone": "",
      "contact_username": "minayq",
      "username": "minayq",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "is_me": false,
      "chat_type": "user",
      "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
      "picture": "",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false,
      "file_link": "https://wapi-u.storage.yandexcloud.net/51a",
      "file_link_expire": 1742474338
    }
  ]
}
Свернуть

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


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

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

Обратите внимание, что все файлы аудио отдаются в формате base64.


{
  "messages": [
    {
      "id": "5909",
      "profile_id": "51a8107a-5442",
      "wh_type": "incoming_message",
      "timestamp": "2025-03-17T15:23:27+03:00",
      "time": 1742214207,
      "body": "JVBERi0xLjcNCiXi48/TDQo1IDAgb2JqD",
      "type": "audio",
      "from": "60227586",
      "to": "5279188641",
      "senderName": "Sinn",
      "chatId": "60227586",
      "caption": "",
      "from_where": "phone",
      "file_name": "CyberMafia_-_Hard_Code_(musmore.org).mp3",
      "mimetype": "audio/mpeg",
      "contact_name": "Sinn",
      "contact_phone": "",
      "contact_username": "sinay",
      "username": "sinay",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "is_me": false,
      "chat_type": "user",
      "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
      "picture": "",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false,
      "file_link": "https://wapi-u.storage.yandexcloud.net/51a",
      "file_link_expire": 1742473424
    }
  ]
}
Свернуть

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


 {
    "messages": [
      {
        "id": "5910",
        "profile_id": "51a8107a-5442",
        "wh_type": "incoming_message",
        "timestamp": "2025-03-17T15:24:34+03:00",
        "time": 1742214274,
        "body": "Location { Name: , Latitude: 58.520963, Longitude: 31.275557, DegreesLatitude: 58.520963, DegreesLongitude:
        31.275557, Description: , JPEGThumbnail: }",
        "type": "location",
        "from": "60227586",
        "to": "5279188641",
        "senderName": "Sinn",
        "chatId": "60227586",
        "caption": null,
        "from_where": "phone",
        "location": {
        "latitude": 58.52096286259456,
        "longitude": 31.275557069637358,
        "description": "",
        "degreesLatitude": 58.52096286259456,
        "degreesLongitude": 31.275557069637358,
        "name": ""
        },
        "contact_name": "Sinn",
        "contact_phone": "",
        "contact_username": "sinay",
        "username": "sinay",
        "is_forwarded": false,
        "isReply": false,
        "is_edited": false,
        "stanza_id": "",
        "is_me": false,
        "chat_type": "user",
        "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
        "picture": "",
        "wappi_bot_id": "",
        "is_deleted": false,
        "is_bot": false,
        "file_link_expire": 1742473474
      }
    ]
  }
Свернуть

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


{
  "messages": [
    {
      "id": "5911",
      "profile_id": "51a8107a-5442",
      "wh_type": "incoming_message",
      "timestamp": "2025-03-17T15:25:26+03:00",
      "time": 1742214326,
      "body": "BEGIN:VCARD \nVERSION:3.0 \nN:Антон Кондиционер;;; \nFN: \nTEL;type=CELL;type=VOICE;type=pref:79116321673
      \nEND:VCARD \n",
      "type": "vcard",
      "from": "",
      "to": "5279188641",
      "senderName": "",
      "chatId": "60227586",
      "caption": null,
      "from_where": "phone",
      "contact": {
      "display_name": "Антон Конжиционер",
      "phone": "79116321672"
      },
      "contact_name": "Sinn",
      "contact_phone": "",
      "contact_username": "sinay",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "is_me": false,
      "chat_type": "user",
      "thumbnail": "",
      "picture": "",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false,
      "file_link_expire": 1742473526
    }
  ]
}
Свернуть

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


{
  "messages": [
    {
      "id": "5889",
      "profile_id": "51a8107a-5442",
      "wh_type": "outgoing_message_api",
      "timestamp": "2025-03-17T14:57:57+03:00",
      "time": 1742212677,
      "body": "Тест",
      "type": "text",
      "from": "5279188641",
      "to": "60227586",
      "senderName": "Varis",
      "chatId": "60227586",
      "caption": null,
      "from_where": "api",
      "contact_name": "Sinn",
      "contact_phone": "",
      "contact_username": "sinay",
      "username": "varisss",
      "phone": "996507585526",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "is_me": true,
      "chat_type": "user",
      "task_id": "f7ff034a-0455-4c96-bf5a-ed5915ee300f",
      "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
      "picture": "",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false
    }
  ]
}
Свернуть

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


{
  "messages": [
    {
      "id": "5890",
      "profile_id": "51a8107a-5442",
      "wh_type": "outgoing_message_phone",
      "timestamp": "2025-03-17T15:04:13+03:00",
      "time": 1742213053,
      "body": "Исходящее сообщение с телефона",
      "type": "text",
      "from": "5279188641",
      "to": "60227586",
      "senderName": "Varis",
      "chatId": "60227586",
      "caption": null,
      "from_where": "phone",
      "contact_name": "Sinn",
      "contact_phone": "",
      "contact_username": "sinay",
      "username": "varisss",
      "phone": "996507585526",
      "is_forwarded": false,
      "isReply": false,
      "is_edited": false,
      "stanza_id": "",
      "is_me": true,
      "chat_type": "user",
      "thumbnail": "https://fs.wappi.pro/t_6056.jpg",
      "picture": "",
      "wappi_bot_id": "",
      "is_deleted": false,
      "is_bot": false
    }
  ]
}
Свернуть

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

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

Мы используем API Telegram, который является частью экосистемы Telegram, и бана за использование этого API получить нельзя. Но мы не несем ответственности за неправомерное использование - если вы используете его для флуда, спама, фейковых подписчиков, счетчиков просмотров каналов, то Telegram может вас забанить.

Можно ли производить массовые рассылки?

Технически вы можете использовать Wappi для массовой рассылки, у нас нет ограничений на количество отправленных сообщений. Но мы не рекомендуем делать рассылку нежелательных сообщений или спама, иначе есть риск быть заблокированным алгоритмами антиспам системы Telegram.

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

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

Telegram

Тарифы Telegram API

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

  • 1 месяц
  • 3 месяца-5%
  • 6 месяцев-10%
  • 12 месяцев-20%

TelegramБазовый

700 ₽
650 ₽700 ₽
630 ₽700 ₽
550 ₽700 ₽

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

Профиль это один подключенный аккаунт мессенджера. В рамках одного профиля можно менять номера.
  • Безлимит на сообщения
  • API:
    • Telegram API
  • Сервисы:
    • Агрегатор мессенджеров
    • Чат-боты
    • Рассылка сообщений
    • ИИ-ассистент
    • Виджет на сайт
  • Без готовых интеграций

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

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

TelegramПолный

1690 ₽
1600 ₽1690 ₽
1500 ₽1690 ₽
1350 ₽1690 ₽

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

Профиль это один подключенный аккаунт мессенджера. В рамках одного профиля можно менять номера.
  • Безлимит на сообщения
  • API:
    • Telegram API
  • Сервисы:
    • Агрегатор мессенджеров
    • Чат-боты
    • Рассылка сообщений
    • ИИ-ассистент
    • Виджет на сайт
  • Готовые интеграции:
    • Битрикс24
    • amoCRM
    • МойСклад
    • RetailCRM

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

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

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

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

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

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

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