From 6d02a1c6ffc77641e05dcb5ba64175aee2af76d9 Mon Sep 17 00:00:00 2001
From: Lonami Exo <totufals@hotmail.com>
Date: Wed, 21 Sep 2022 10:50:07 +0200
Subject: [PATCH] Update some raw API examples

---
 readthedocs/examples/users.rst                |  2 +-
 .../examples/working-with-messages.rst        | 47 ++++++++++++++++++-
 2 files changed, 47 insertions(+), 2 deletions(-)

diff --git a/readthedocs/examples/users.rst b/readthedocs/examples/users.rst
index d9c648ae..ea83871d 100644
--- a/readthedocs/examples/users.rst
+++ b/readthedocs/examples/users.rst
@@ -25,7 +25,7 @@ you should use :tl:`GetFullUser`:
     # or even
     full = await client(GetFullUserRequest('username'))
 
-    bio = full.about
+    bio = full.full_user.about
 
 
 See :tl:`UserFull` to know what other fields you can access.
diff --git a/readthedocs/examples/working-with-messages.rst b/readthedocs/examples/working-with-messages.rst
index bf51f260..180b2625 100644
--- a/readthedocs/examples/working-with-messages.rst
+++ b/readthedocs/examples/working-with-messages.rst
@@ -42,4 +42,49 @@ send yourself the very first sticker you have:
     await client.send_file('me', stickers.documents[0])
 
 
-.. _issues: https://github.com/LonamiWebs/Telethon/issues/215
+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.
+
+.. _unicode-table.com: https://unicode-table.com/en/emoji/
+.. _emoji: https://pypi.org/project/emoji/