mirror of
https://github.com/LonamiWebs/Telethon.git
synced 2024-11-10 19:46:36 +03:00
Move working with messages to the wiki
This commit is contained in:
parent
4de1609d4e
commit
f334d5b8fe
|
@ -2,125 +2,12 @@
|
||||||
Working with messages
|
Working with messages
|
||||||
=====================
|
=====================
|
||||||
|
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
These examples assume you have read :ref:`full-api`.
|
These examples assume you have read :ref:`full-api`.
|
||||||
|
|
||||||
.. contents::
|
This section has been `moved to the wiki`_, where it can be easily edited as new
|
||||||
|
features arrive and the API changes. Please refer to the linked page to learn how
|
||||||
|
to send spoilers, custom emoji, stickers, react to messages, and more things.
|
||||||
|
|
||||||
|
.. _moved to the wiki: https://github.com/LonamiWebs/Telethon/wiki/Sending-more-than-just-messages
|
||||||
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
|
|
||||||
|
|
Loading…
Reference in New Issue
Block a user