From 3d486cd6720551a6c9225fc5a6beeee075663a84 Mon Sep 17 00:00:00 2001
From: Anders Liljekvist <thrawn@jungfrubo.se>
Date: Wed, 29 Jun 2022 16:26:33 +0200
Subject: [PATCH] Documentation:  telegram_bot.send_poll (#22148)

---
 source/_integrations/telegram_bot.markdown | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/_integrations/telegram_bot.markdown b/source/_integrations/telegram_bot.markdown
index 7c0898fd9fb..ad467c0dfe7 100644
--- a/source/_integrations/telegram_bot.markdown
+++ b/source/_integrations/telegram_bot.markdown
@@ -172,6 +172,21 @@ Send a location.
 | `inline_keyboard`         |      yes | List of rows of commands, comma-separated, to make a custom inline keyboard with buttons with associated callback data. Example: `["/button1, /button2", "/button3"]` or `[[["Text btn1", "/button1"], ["Text btn2", "/button2"]], [["Text btn3", "/button3"]]]` |
 | `message_tag`             |      yes | Tag for sent message. In `telegram_sent` event data: `{{trigger.event.data.message_tag}}` |
 
+### Service `telegram_bot.send_poll`
+
+Send a poll.
+
+| Service data attribute    | Optional | Description                                      |
+|---------------------------|----------|--------------------------------------------------|
+| `question`                |       no | Poll question, 1-300 characters. |
+| `options`                 |       no | List of answer options, 2-10 strings 1-100 characters each.  |
+| `target`                  |      yes | An array of pre-authorized chat_ids or user_ids to send the notification to. Defaults to the first allowed `chat_id`. |
+| `is_anonymous`            |      yes | True/false for if the poll needs to be anonymous, defaults to True. |
+| `allows_multiple_answers` |      yes | True/false for if the poll allows multiple answers, defaults to False. |
+| `open_period`             |      yes | Amount of time in seconds the poll will be active after creation, 5-600. |
+| `disable_notification`    |      yes | True/false for send the message silently. iOS users and web users will not receive a notification, Android users will receive a notification with no sound. Defaults to False. |
+| `timeout`                 |      yes | Timeout for sending voice in seconds. Will help with timeout errors (poor internet connection, etc) |
+
 ### Service `telegram_bot.edit_message`
 
 Edit a previously sent message in a conversation.