Документация Telegram API
Описание Telegram API для сервиса Wappi
С помощью этого API можно осуществлять прием и отправку сообщений через HTTP-запросы, а также работать с чатами, контактами, группами и каналами. Это так называемый Telegram User API, который подойдет, если вы хотите использовать личный телеграм аккаунт в качестве userbot или для иных действий.
МЕТОДЫ ОТПРАВКИ СООБЩЕНИЯ
Вы можете отправить сообщение в Telegram синхронной или асинхронной командой. Асинхронные методы выполняют запросы с постановкой в очередь, в ответе придет сообщение о постановке в очередь и id задачи. Синхронные методы отправления сообщений выполняются сразу и позволяют получить в ответе результат запроса
БЕЗОПАСНОСТЬ
Мы используем API Telegram, который является частью экосистемы Telegram. Если вы используете наш API для флуда, спама, фейковых подписчиков, счетчиков просмотров каналов, Telegram может вас забанить. Рекомендуем использовать свои собственные socks5 прокси для подключения.
ОСОБЕННОСТИ API
Токен авторизации передается в заголовке Authorization HTTP запроса. Profile_id передается query параметром в каждом запросе.
ТЕСТИРОВАНИЕ API
Чтобы протестировать API необходимо авторизоваться. Для этого на данной странице нажмите Authorize, в появившемся окне в поле Value вставьте ваш токен api. Токен можно найти в дашборде на странице вашего профиля - Вход в личный кабинет.
КОЛЛЕКЦИЯ POSTMAN
Для удобства тестирования нашего API можете воспользоваться коллекцией Postman. Там же можно найти примеры реализованных методов на разных языках программирования.
Типы уведомлений Webhook
Есть несколько статусов отправленных сообщений - pending, delivered, read.
{
"messages": {
"wh_type": "delivery_status",
"profile_id": "fae370e3-0a1a",
"id": "2871",
"from": "966507585521",
"to": "WL00D",
"chat_id": "89323786",
"status": "delivered",
"timestamp": "2024-03-02T15:56:47.426093988+03:00",
"time": 1709384207,
"task_id": "999fff95-d48f-47e8-a64e-2936cbf89c8e"
}
}
Есть несколько статусов профиля - 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
}
]
}
{
"messages": [
{
"wh_type": "application_status",
"profile_id": "fae370e3-0a1a",
"status": "online",
"phone": "966507585521",
"timestamp": "2024-03-02T15:52:27.996591556+03:00",
"time": 1709383947
}
]
}
{
"messages": [
{
"wh_type": "incoming_message",
"profile_id": "fae370e3-0a1a",
"id": "2872",
"body": "Текстовое сообщение",
"type": "text",
"from": "qinaq123",
"to": "966507585521",
"senderName": "Alex",
"chatId": "60227586",
"timestamp": "2024-03-02T16:04:26+03:00",
"time": 1709384666,
"from_where": "phone",
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
Обратите внимание, все изображения отдаются в формате base64.
{
"messages": [
{
"wh_type": "incoming_message",
"profile_id": "fae370e3-0a1a",
"id": "2873",
"body": "/9j/4AAQSkZJRgABA",
"type": "image",
"from": "qinaq123",
"to": "966507585521",
"senderName": "Alex",
"chatId": "60227586",
"timestamp": "2024-03-02T16:06:03+03:00",
"time": 1709384763,
"caption": "",
"from_where": "phone",
"mimetype": "image/jpeg",
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
Обратите внимание, что все видео отдаются в формате base64.
{
"messages": [
{
"wh_type": "incoming_message",
"profile_id": "fae370e3-0a1a",
"id": "2874",
"body": "AAAAHGZ0eXBpc2
"type": "video",
"from": "qinaq123",
"to": "966507585521",
"senderName": "Alex",
"chatId": "60227586",
"timestamp": "2024-03-02T16:07:24+03:00",
"time": 1709384844,
"caption": "Подпись к видео",
"from_where": "phone",
"file_name": "IMG_2509.MOV",
"mimetype": "video/quicktime",
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
Обратите внимание, что все файлы и документы отдаются в формате base64.
{
"messages": [
{
"wh_type": "incoming_message",
"profile_id": "fae370e3-0a1a",
"id": "2875",
"body": "VVFzeXRhOkhOdVc0UUAx0K",
"type": "document",
"from": "qinaq123",
"to": "966507585521",
"senderName": "Alex",
"chatId": "60227586",
"timestamp": "2024-03-02T16:12:30+03:00",
"time": 1709385150,
"caption": "Подпись к файлу",
"from_where": "phone",
"file_name": "Proxy-03-12-2023.txt",
"mimetype": "text/plain",
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
Обратите внимание, что все файлы аудио отдаются в формате base64.
{
"messages": [
{
"wh_type": "incoming_message",
"profile_id": "fae370e3-0a1a",
"id": "2876",
"body": "SUQzAwAAAAAH",
"type": "audio",
"from": "qinaq123",
"to": "966507585521",
"senderName": "Alex",
"chatId": "60227586",
"timestamp": "2024-03-02T16:16:52+03:00",
"time": 1709385412,
"caption": "Подпись к аудио",
"from_where": "phone",
"file_name": "doc_2023-11-08_11-58-00.mp3",
"mimetype": "audio/mpeg",
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
{
"messages": [
{
"wh_type": "incoming_message",
"profile_id": "fae370e3-0a1a",
"id": "2877",
"type": "location",
"from": "qinaq123",
"to": "966507585521",
"senderName": "Alex",
"chatId": "60227586",
"timestamp": "2024-03-02T16:18:39+03:00",
"time": 1709385519,
"from_where": "phone",
"location": {
"latitude": 58.49166463372388,
"longitude": 31.27102501110625,
"description": "Великий Новгород"
},
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
{
"messages": [
{
"wh_type": "incoming_message",
"profile_id": "fae370e3-0a1a",
"id": "2878",
"body": "BEGIN:VCARD \nVERSION:3.0 \nN:Илья Б;;; \nFN: \nTEL;type=CELL;type=VOICE;type=pref:79116062888 \nEND:VCARD \n",
"type": "vcard",
"from": "qinaq123",
"to": "966507585521",
"senderName": "Alex",
"chatId": "60227586",
"timestamp": "2024-03-02T16:19:55+03:00",
"time": 1709385595,
"from_where": "phone",
"contact": {
"display_name": "Илья Б",
"phone": "79116062888"
},
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
{
"messages": [
{
"wh_type": "incoming_message",
"profile_id": "fae370e3-0a1a",
"id": "2879",
"body": "T2dnUwACAAAAAAAAAA",
"type": "ptt",
"from": "qinaq123",
"to": "966507585521",
"senderName": "Alex",
"chatId": "60227586",
"timestamp": "2024-03-02T16:20:51+03:00",
"time": 1709385651,
"caption": "",
"from_where": "phone",
"mimetype": "audio/ogg",
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
{
"messages": [
{
"wh_type": "outgoing_message_api",
"profile_id": "fae370e3-0a1a",
"id": "2883",
"body": "Тестовое сообщение по API",
"type": "text",
"from": "966507585521",
"to": "qinaq123",
"senderName": "Varis",
"chatId": "60227586",
"timestamp": "2024-03-02T16:29:35+03:00",
"time": 1709386175,
"from_where": "api",
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}
{
"messages": [
{
"wh_type": "outgoing_message_phone",
"profile_id": "fae370e3-0a1a",
"id": "2882",
"body": "Исходящее с телефона",
"type": "text",
"from": "966507585521",
"to": "qinaq123",
"senderName": "Varis",
"chatId": "60227586",
"timestamp": "2024-03-02T16:27:17+03:00",
"time": 1709386037,
"from_where": "phone",
"contact_name": "Alex",
"is_forwarded": false,
"isReply": false,
"is_edited": false,
"stanza_id": "",
"chat_type": "user"
}
]
}