Action: Send Poll

Telegram Operation

The Send Poll action in Telegram transmits a poll to a specified chat or channel.

Example User Story

I want to quickly gather opinions from my team, so I use the Send Poll action to create and send a poll in our group chat.

Fields

Field Name	Field Type	Required
chatId	String	Yes
question	String	Yes
options	String	Yes
isAnonymous	Boolean	No
allowsMultipleAnswers	Boolean	No

Related Connections

Telegram

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "send-poll",
  "state": "inDev",
  "meta": {
    "short": "Send Poll",
    "description": "Sends a poll to a specified Telegram chat."
  },
  "input": [
    {
      "name": "chatId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the chat where the poll will be sent."
      }
    },
    {
      "name": "question",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The question of the poll."
      }
    },
    {
      "name": "options",
      "type": "String",
      "required": true,
      "meta": {
        "description": "A JSON array of poll options, e.g., ['Option 1', 'Option 2']."
      }
    },
    {
      "name": "isAnonymous",
      "type": "Boolean",
      "required": false,
      "meta": {
        "description": "Whether the poll is anonymous. Defaults to true."
      }
    },
    {
      "name": "allowsMultipleAnswers",
      "type": "Boolean",
      "required": false,
      "meta": {
        "description": "Whether the poll allows multiple answers. Defaults to false."
      }
    }
  ],
  "output": [
    {
      "name": "pollId",
      "type": "String",
      "selector": ["result", "poll", "id"],
      "meta": {
        "description": "The ID of the sent poll."
      }
    },
    {
      "name": "success",
      "type": "Boolean",
      "selector": ["ok"],
      "meta": {
        "description": "Whether the poll was successfully sent."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/bot{{.botToken}}/sendPoll",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"chat_id\": {{.chatId}}, \"question\": \"{{.question}}\", \"options\": {{.options}}, \"is_anonymous\": {{.isAnonymous}}, \"allows_multiple_answers\": {{.allowsMultipleAnswers}}}",
          "placeholders": [
            {
              "name": "botToken",
              "type": "String",
              "description": "The Telegram bot token.",
              "required": true
            },
            {
              "name": "chatId",
              "type": "String",
              "description": "The ID of the chat where the poll will be sent.",
              "required": true
            },
            {
              "name": "question",
              "type": "String",
              "description": "The question of the poll.",
              "required": true
            },
            {
              "name": "options",
              "type": "String",
              "description": "A JSON array of poll options.",
              "required": true
            },
            {
              "name": "isAnonymous",
              "type": "Boolean",
              "description": "Whether the poll is anonymous.",
              "required": false,
              "default": "true"
            },
            {
              "name": "allowsMultipleAnswers",
              "type": "Boolean",
              "description": "Whether the poll allows multiple answers.",
              "required": false,
              "default": "false"
            }
          ]
        }
      }
    }
  ]
}