Merge branch '5.2' into 5.x

* 5.2:
  [Notifier] Add documentation for telegram options

Author: OskarStark

notifier/chatters.rst

@@ -98,8 +98,6 @@ to add some interactive options called `Block elements`_::
 
     $chatter->send($chatMessage);
 
-.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
-
 Adding Interactions to a Discord Message
 ----------------------------------------
 
@@ -151,4 +149,38 @@ to add some interactive options called `Embed elements`_::
 
     $chatter->send($chatMessage);
 
+Adding Interactions to a Telegram Message
+-----------------------------------------
+
+With a Telegram message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` class
+to add `message options`_::
+
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
+    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Create Telegram options
+    $telegramOptions = (new TelegramOptions())
+        ->chatId('@symfonynotifierdev')
+        ->parseMode('MarkdownV2')
+        ->disableWebPagePreview(true)
+        ->disableNotification(true)
+        ->replyMarkup((new InlineKeyboardMarkup())
+            ->inlineKeyboard([
+                (new InlineKeyboardButton('Visit symfony.com'))
+                    ->url('https://symfony.com/'),
+            ])
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($telegramOptions);
+
+    $chatter->send($chatMessage);
+
+.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
 .. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
+.. _`message options`: https://core.telegram.org/bots/api