mirror of
https://github.com/LonamiWebs/Telethon.git
synced 2024-12-01 05:43:45 +03:00
127 lines
4.2 KiB
ReStructuredText
127 lines
4.2 KiB
ReStructuredText
=====================
|
|
Working with messages
|
|
=====================
|
|
|
|
|
|
.. note::
|
|
|
|
These examples assume you have read :ref:`full-api`.
|
|
|
|
.. contents::
|
|
|
|
|
|
Sending stickers
|
|
================
|
|
|
|
Stickers are nothing else than ``files``, and when you successfully retrieve
|
|
the stickers for a certain sticker set, all you will have are ``handles`` to
|
|
these files. Remember, the files Telegram holds on their servers can be
|
|
referenced through this pair of ID/hash (unique per user), and you need to
|
|
use this handle when sending a "document" message. This working example will
|
|
send yourself the very first sticker you have:
|
|
|
|
.. code-block:: python
|
|
|
|
# Get all the sticker sets this user has
|
|
from telethon.tl.functions.messages import GetAllStickersRequest
|
|
sticker_sets = await client(GetAllStickersRequest(0))
|
|
|
|
# Choose a sticker set
|
|
from telethon.tl.functions.messages import GetStickerSetRequest
|
|
from telethon.tl.types import InputStickerSetID
|
|
sticker_set = sticker_sets.sets[0]
|
|
|
|
# Get the stickers for this sticker set
|
|
stickers = await client(GetStickerSetRequest(
|
|
stickerset=InputStickerSetID(
|
|
id=sticker_set.id, access_hash=sticker_set.access_hash
|
|
),
|
|
hash=0
|
|
))
|
|
|
|
# Stickers are nothing more than files, so send that
|
|
await client.send_file('me', stickers.documents[0])
|
|
|
|
|
|
Sending reactions
|
|
=================
|
|
|
|
It works very similar to replying to a message. You need to specify the chat,
|
|
message ID you wish to react to, and reaction, using :tl:`SendReaction`:
|
|
|
|
.. code-block:: python
|
|
|
|
from telethon.tl.functions.messages import SendReactionRequest
|
|
|
|
await client(SendReactionRequest(
|
|
peer=chat,
|
|
msg_id=42,
|
|
reaction='❤️'
|
|
))
|
|
|
|
Note that you cannot use strings like ``:heart:`` for the reaction. You must
|
|
use the desired emoji directly. You can most easily achieve this by
|
|
copy-pasting the emoji from an official application such as Telegram Desktop.
|
|
|
|
If for some reason you cannot embed emoji directly into the code, you can also
|
|
use its unicode escape (which you can find using websites like
|
|
`unicode-table.com`_), or install a different package, like `emoji`_:
|
|
|
|
.. code-block:: python
|
|
|
|
# All of these work exactly the same (you only need one):
|
|
import emoji
|
|
reaction = emoji.emojize(':red_heart:')
|
|
reaction = '❤️'
|
|
reaction = '\u2764'
|
|
|
|
from telethon.tl.functions.messages import SendReactionRequest
|
|
await client(SendReactionRequest(
|
|
peer=chat,
|
|
msg_id=42,
|
|
reaction=reaction
|
|
))
|
|
|
|
Please make sure to check the help pages of the respective websites you use
|
|
if you need a more in-depth explanation on how they work. Telethon only needs
|
|
you to provide the emoji in some form. Some packages or websites can make this
|
|
easier.
|
|
|
|
|
|
Sending spoilers (hidden text)
|
|
==============================
|
|
|
|
The current markdown and HTML parsers do not offer a way to send spoilers yet.
|
|
You need to use :tl:`MessageEntitySpoiler` so that parts of the message text
|
|
are shown under a spoiler.
|
|
|
|
The simplest way to do this is to `modify the builtin parsers`_ to support
|
|
sending these new message entities with the features they already provide.
|
|
|
|
|
|
Sending custom emoji
|
|
====================
|
|
|
|
The current markdown and HTML parsers do not offer a way to send custom emoji
|
|
yet. You need to use :tl:`MessageEntityCustomEmoji` so that parts of the
|
|
message text with emoji are replaced with a custom one instead.
|
|
|
|
The simplest way to do this is to `modify the builtin parsers`_ to support
|
|
sending these new message entities with the features they already provide.
|
|
|
|
:tl:`MessageEntityCustomEmoji` must wrap an emoji in order to work (you can't
|
|
put it around arbitrary ``"text"``, it won't work), so be sure to keep this in
|
|
mind when using it.
|
|
|
|
To find the ``document_id`` for the custom emoji, the simplest way is to send
|
|
a message with an official client containing the custom emoji you want, and
|
|
then print the ``message.entities`` to find the ``document_id``.
|
|
|
|
If you prefer, you can also use :tl:`GetFeaturedEmojiStickers` to find about
|
|
the ``document_id`` of featured custom emoji.
|
|
|
|
|
|
.. _unicode-table.com: https://unicode-table.com/en/emoji/
|
|
.. _emoji: https://pypi.org/project/emoji/
|
|
.. _modify the builtin parsers: https://github.com/LonamiWebs/Telethon/wiki/Sending-spoilers-and-custom-emoji
|