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

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

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

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

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

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

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

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

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

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

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

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

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

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

Коллекция Postman

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

В коллекцию >

Методы API

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

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 API

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

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

700 ₽

600 ₽~~700 ₽~~

550 ₽~~700 ₽~~

500 ₽~~700 ₽~~

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

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

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

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

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

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

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

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

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