Lodol Docs

Telegram

API actions for the Telegram integration.

Telegram

Send Telegram messages, manage chat pins, and generate invite links.


Generate a new join link for a chat.

Parameters

ParameterTypeRequiredDescription
chat_idstringYesChat ID.
namestringNoInvite link label.
expire_datenumberNoExpiration Unix timestamp.
member_limitnumberNoMaximum users.

Response

{
  "expire_date": 1706745600,
  "invite_link": "https://t.me/+abcdef123456",
  "member_limit": 100,
  "status": "success"
}

Forward a message

Forward a message from one chat to another.

Parameters

ParameterTypeRequiredDescription
chat_idstringYesDestination chat ID.
from_chat_idstringYesSource chat ID.
message_idnumberYesMessage ID to forward.

Response

{
  "chat_id": 123456789,
  "message_id": 12347,
  "status": "success"
}

Get chat member count

Retrieve the number of members in a chat.

Parameters

ParameterTypeRequiredDescription
chat_idstringYesChat ID.

Response

{
  "count": 147,
  "status": "success"
}

Pin a chat message

Pin a message in a chat with optional silent notification.

Parameters

ParameterTypeRequiredDescription
chat_idstringYesChat ID.
message_idnumberYesMessage ID to pin.
disable_notificationbooleanNoDisable notification.

Response

{
  "status": "success"
}

Send a message

Send a text message to a chat using a bot token.

Parameters

ParameterTypeRequiredDescription
chat_idstringYesTarget chat ID or username.
textstringYesMessage text.
parse_modestringNoParse mode.

Response

{
  "chat_id": 987654321,
  "message_id": 12345,
  "status": "success"
}

Send a photo

Send a photo to a chat with an optional caption.

Parameters

ParameterTypeRequiredDescription
chat_idstringYesTarget chat ID or username.
photo_urlstringYesPhoto URL.
captionstringNoPhoto caption.

Response

{
  "chat_id": 987654321,
  "message_id": 12346,
  "status": "success"
}

On this page