Action: Send Photo

Telegram Operation

The Send Photo action in Telegram transmits an image file to a specified chat or channel.

Example User Story

I want to share a quick snapshot with my friends, so I use the Send Photo action to upload and send the image to our group chat.

Fields

Field Name	Field Type	Required
chatId	String	Yes
photo	String	Yes
caption	String	No
parseMode	String	No

Related Connections

Telegram

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "send-photo",
  "state": "inDev",
  "meta": {
    "short": "Send Photo",
    "description": "Send a photo to a Telegram chat."
  },
  "input": [
    {
      "name": "chatId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)."
      }
    },
    {
      "name": "photo",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers, or a URL to send a new photo."
      }
    },
    {
      "name": "caption",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Photo caption (may also be used when resending photos by file_id)."
      }
    },
    {
      "name": "parseMode",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Mode for parsing entities in the photo caption. See formatting options for more details.",
        "options": ["Markdown", "HTML"]
      }
    }
  ],
  "output": [
    {
      "name": "messageId",
      "type": "Integer",
      "selector": ["result", "message_id"],
      "meta": {
        "description": "Unique message identifier."
      }
    },
    {
      "name": "date",
      "type": "Integer",
      "selector": ["result", "date"],
      "meta": {
        "description": "Date the message was sent in Unix time."
      }
    },
    {
      "name": "chat",
      "type": "Object",
      "selector": ["result", "chat"],
      "meta": {
        "description": "Information about the chat where the photo was sent."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/bot{{.token}}/sendPhoto",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"chat_id\": \"{{.chatId}}\", \"photo\": \"{{.photo}}\", \"caption\": \"{{.caption}}\", \"parse_mode\": \"{{.parseMode}}\"}",
          "placeholders": [
            {
              "name": "chatId",
              "type": "String",
              "description": "Unique identifier for the target chat or username of the target channel.",
              "required": true
            },
            {
              "name": "photo",
              "type": "String",
              "description": "Photo to send. Pass a file_id or URL.",
              "required": true
            },
            {
              "name": "caption",
              "type": "String",
              "description": "Photo caption.",
              "required": false
            },
            {
              "name": "parseMode",
              "type": "String",
              "description": "Mode for parsing entities in the photo caption.",
              "required": false,
              "options": ["Markdown", "HTML"]
            }
          ]
        }
      }
    }
  ]
}