Messaging

Send plain text or a link with preview. Use type text (default) or type link when you want URL preview.

Single endpoint for all media: image, video, PTV, GIF, audio, voice note, document, and sticker. Prefer type media — the server auto-detects the kind from the file URL extension (or from filename for documents).

Send a poll message. Supported for contacts and groups (not channels). Requires the Message templates plan feature.

Send a static location pin or a live location. Use type location for a pin, or type live_location. Requires the Message templates plan feature.

List messages from session cache and outbound history.

List messages for a specific chat.

Fetch a single message by chat_id and message_id.

Forward a message to another chat.

Mark one or more messages as read (blue ticks).

Delete a message for everyone in the chat.

Add an emoji reaction on a message.

Remove your reaction from a message.

Star or unstar a message.

Pin a message in a chat.

Unpin a message from a chat.