letter

from telegram import MessageEntity
from telegram.constants import MessageEntityType

# python-telegram-bot v20 or newer. Leave parse_mode unset.
text = "Hi ✉️"
await bot.send_message(
    chat_id=CHAT_ID,
    text=text,
    entities=[
        MessageEntity(
            type=MessageEntityType.CUSTOM_EMOJI,
            offset=3,
            length=2,
            custom_emoji_id="5253742260054409879",
        )
    ],
)

Paste this into a Python bot.

from aiogram.enums import MessageEntityType
from aiogram.types import MessageEntity

# aiogram 3. Do not also set parse_mode.
text = "Hi ✉️"
await bot.send_message(
    chat_id=CHAT_ID,
    text=text,
    entities=[
        MessageEntity(
            type=MessageEntityType.CUSTOM_EMOJI,
            offset=3,
            length=2,
            custom_emoji_id="5253742260054409879",
        )
    ],
)

Paste this into an aiogram bot.

// Telegraf 4. Keep the ID in quotes.
const text = "Hi ✉️";
await ctx.reply(text, {
  entities: [
    {
      type: "custom_emoji",
      offset: 3,
      length: 2,
      custom_emoji_id: "5253742260054409879",
    },
  ],
});

Paste this into a Telegraf bot.

{
  "chat_id": "CHAT_ID",
  "text": "Hi ✉️",
  "entities": [
    {
      "type": "custom_emoji",
      "offset": 3,
      "length": 2,
      "custom_emoji_id": "5253742260054409879"
    }
  ]
}

The body of a sendMessage call.

Hi <tg-emoji emoji-id="5253742260054409879">✉️</tg-emoji>

Send this text with parse_mode set to HTML. Do not pass entities as well.

Hi ![✉️](tg://emoji?id=5253742260054409879)

Send this text with parse_mode set to MarkdownV2. The docs ask for a real emoji as the alternative text.