Messenger API

Everything the panel can do with a connected Telegram, WhatsApp or Instagram account, over REST — one key, one response shape, chapter by chapter.

Telegram: stickers, folders, Business, raw

Sticker sets, saved GIFs, chat folders, Telegram Business and the passthrough to every connector endpoint.

The tg/{path} passthrough exposes every connector endpoint (Stars, gifts, calls, mini apps, bots, secret chats, raw TL methods): GET needs channels:read, writes need channels:write. POST tg/raw {method, params} calls any TL method by name.

Base URL: https://chatvendor.net/api/v1 · every response is {"success": true, "data": …}

GET /channels/{id}/stickers/sets Installed sticker sets channels:read

Scope: channels:read

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Response 200 · StickerSet[]

id stringtitle stringshort_name stringcount integerofficial booleananimated booleanemojis boolean

curl https://chatvendor.net/api/v1/channels/1/stickers/sets \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

GET /channels/{id}/stickers/sets/{name} Stickers of a set (each with a ref to send) channels:read

Scope: channels:read

Parameters

idpath · integerrequired

Channel id (from GET /channels)

namepath · stringrequired

Set short name

Response 200 · StickerSetContents

set StickerSetstickers Media[]

curl https://chatvendor.net/api/v1/channels/1/stickers/sets/{name} \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

GET /channels/{id}/stickers/gifs Saved GIFs (each with a ref to send) channels:read

Scope: channels:read

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Response 200 · Media[]

curl https://chatvendor.net/api/v1/channels/1/stickers/gifs \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

GET /channels/{id}/folders Chat folders channels:read

Scope: channels:read

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Response 200 · Folder[]

id integertitle stringemoticon stringinclude_peers integer[]exclude_peers integer[]

curl https://chatvendor.net/api/v1/channels/1/folders \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

POST /channels/{id}/folders Create a chat folder channels:write

Scope: channels:write

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Body (application/json)

titlestringrequired

emoticonstring

includestring[]

excludestring[]

contactsboolean

non_contactsboolean

groupsboolean

broadcastsboolean

botsboolean

exclude_mutedboolean

exclude_readboolean

exclude_archivedboolean

Response 200 · Folder

id integertitle stringemoticon stringinclude_peers integer[]exclude_peers integer[]

curl -X POST https://chatvendor.net/api/v1/channels/1/folders \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -H "Content-Type: application/json" \
  -d '{"title":"…"}'

PATCH /channels/{id}/folders/{folder} Edit a chat folder channels:write

Scope: channels:write

Parameters

idpath · integerrequired

Channel id (from GET /channels)

folderpath · integerrequired

Folder id

Response 200 · Folder

id integertitle stringemoticon stringinclude_peers integer[]exclude_peers integer[]

curl -X PATCH https://chatvendor.net/api/v1/channels/1/folders/42 \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

DELETE /channels/{id}/folders/{folder} Delete a chat folder channels:write

Scope: channels:write

Parameters

idpath · integerrequired

Channel id (from GET /channels)

folderpath · integerrequired

Folder id

Response 200

curl -X DELETE https://chatvendor.net/api/v1/channels/1/folders/42 \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

GET /channels/{id}/business Telegram Business settings (hours, location, greeting/away, intro, quick replies) channels:read

Scope: channels:read

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Response 200 · Business

curl https://chatvendor.net/api/v1/channels/1/business \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

GET /channels/{id}/business/quick-replies Quick-reply shortcuts channels:read

Scope: channels:read

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Response 200 · QuickReply[]

id integershortcut stringcount integer

curl https://chatvendor.net/api/v1/channels/1/business/quick-replies \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

POST /channels/{id}/business/quick-replies Add a message to a quick-reply shortcut (Premium) channels:write

Scope: channels:write

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Body (application/json)

shortcutstringrequired

textstringrequired

Response 200

curl -X POST https://chatvendor.net/api/v1/channels/1/business/quick-replies \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -H "Content-Type: application/json" \
  -d '{"shortcut":"…","text":"…"}'

POST /channels/{id}/business/quick-replies/{shortcut}/send Send a quick reply to a chat channels:write

Scope: channels:write

Parameters

idpath · integerrequired

Channel id (from GET /channels)

shortcutpath · integerrequired

Shortcut id

Body (application/json)

peerstringrequired

Response 200 · ChatMessage[]

id integerchat_id integersender_id integersender_name stringout booleandate string (date-time)text stringmedia objectreply_to integertopic_id integerbuttons object[][]

curl -X POST https://chatvendor.net/api/v1/channels/1/business/quick-replies/42/send \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -H "Content-Type: application/json" \
  -d '{"peer":"…"}'

GET /channels/{id}/business/links Business chat links (t.me/m/…) channels:read

Scope: channels:read

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Response 200 · BusinessLink[]

link stringslug stringtitle stringtext stringviews integer

curl https://chatvendor.net/api/v1/channels/1/business/links \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

POST /channels/{id}/business/links Create a business chat link (Premium) channels:write

Scope: channels:write

Parameters

idpath · integerrequired

Channel id (from GET /channels)

Body (application/json)

textstringrequired

titlestring

Response 200 · BusinessLink

link stringslug stringtitle stringtext stringviews integer

curl -X POST https://chatvendor.net/api/v1/channels/1/business/links \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -H "Content-Type: application/json" \
  -d '{"text":"…","title":"…"}'

GET /channels/{id}/tg/{path} Passthrough to every connector endpoint (read): stars, gifts, calls, mini apps, secret chats, folders, stats… — see the connector catalogue in the docs channels:read

Scope: channels:read

Parameters

idpath · integerrequired

Channel id (from GET /channels)

pathpath · stringrequired

Connector path, e.g. stars, gifts/catalog, calls, chats/{peer}/call, secret, raw/methods

Response 200

The connector response under data

curl https://chatvendor.net/api/v1/channels/1/tg/{path} \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

POST /channels/{id}/tg/{path} Passthrough to every connector endpoint (write): JSON body or multipart; POST tg/raw {method, params} calls any TL method channels:write

Scope: channels:write

Parameters

idpath · integerrequired

Channel id (from GET /channels)

pathpath · stringrequired

Connector path, e.g. gifts/send, dialogs/{peer}/todo, bot/send/{peer}, secret/{chat_id}/messages, raw

multipart/form-data — fields are listed in the summary above.

Response 200

The connector response under data

curl -X POST https://chatvendor.net/api/v1/channels/1/tg/{path} \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -F "file=@photo.jpg" -F "caption=…"