# Get the next new post in a chat — Telegram User Botize method — `telegram_users.new_private_group_post` (trigger). It is triggered every time there is a new message on a public/private group, channel or chat. Allows you to read the content of any chat, including chats with download-protected content. - Requires a user with access to the group/channel - You don't need to register a Telegram bot. This is a trigger: it starts the task. A task has exactly one. ## Fields you set The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps. - `chat_url` *(string)* — Private Group or Channel Id - `up_to_5_messages` *(boolean)* — Extract up to a maximum of 5 messages at a time - `max_file_mb` *(string, one of: "20" = 20 MB; "50" = 50 MB; "100" = 100 MB; "250" = 250 MB; "500" = 500 MB; "1024" = 1 GB; "2048" = 2 GB; "0" = Exclude all files (no images, video or files will be downloaded))* — Exclude files bigger than this size It also accepts repeatable field groups, with these prefixes: `filter_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added. ## Output variables Data this step makes available. Reference them in later steps with the double-brace tag. - `{{post_id}}` *(int)* — Post Id. Unique identifier for the post or message - `{{chat_id}}` *(int)* — Chat Id. Unique identifier for the chat where the post was published - `{{message_thread_id}}` *(int)* — Message Thread Id. Unique identifier for the chat thread (topic) where the post was published - `{{url_message}}` *(text)* — URL Message. URL address of the published message - `{{message}}` *(text)* — Message. Content of the published message - `{{message_html}}` *(text)* — Message HTML. Message in HTML format if the message includes HTML tags. If not, the content of this tag is identical to that of the {{message}} tag - `{{post_datetime}}` *(text)* — Post Date-time. Date and time when the post was published - `{{image_url}}` *(text)* — Image URL. URL address of the image related to the post, video or post file - `{{user_id}}` *(int)* — User Id. Unique identifier for the user who published the post - `{{reply_to_msg_id}}` *(int)* — Reply to Message Id. Identifier of the message the post is responding to (if applicable) - `{{media}}` *(array)* — Media. Array containing information about the images attached to the post - `{{media.0}}` *(text)* — Media 1. URL of the first image attached to the post (if applicable). This URL coincides with the one indicated in the {{image_url}} tag - `{{media.1}}` *(text)* — Media 2. URL of the second attached image to the post (if applicable) - `{{media.2}}` *(text)* — Media 3. URL of the third attached image to the post (if applicable) - `{{media.3}}` *(text)* — Media 4. URL of the fourth attached image to the post (if applicable) - `{{media.4}}` *(text)* — Media 5. URL of the fifth attached image to the post (if applicable) - `{{media.5}}` *(text)* — Media 6. URL of the sixth attached image to the post (if applicable) - `{{media.6}}` *(text)* — Media 7. URL of the seventh attached image to the post (if applicable) - `{{media.7}}` *(text)* — Media 8. URL of the eighth attached image to the post (if applicable) - `{{media.8}}` *(text)* — Media 9. URL of the ninth attached image to the post (if applicable) - `{{media.9}}` *(text)* — Media 10. URL of the tenth attached image to the post (if applicable) - `{{is_text_message}}` *(boolean)* — Is a text message. The received message is a text message - `{{is_poll_message}}` *(boolean)* — Is a poll message. The received message contains a poll - `{{is_document_message}}` *(boolean)* — Is a document message. The received message contains a document - `{{is_video_message}}` *(boolean)* — Is a video message. The received message contains a video - `{{is_photo_message}}` *(boolean)* — Is a photo message. The received message contains a photo - `{{is_audio_message}}` *(boolean)* — Is an audio message. The received message contains an audio file - `{{is_animation_message}}` *(boolean)* — Is an animation message. The received message contains an animation - `{{is_video_note_message}}` *(boolean)* — Is a video note message. The received message contains a video note - `{{is_voice_message}}` *(boolean)* — Is a voice message. The received message contains a voice note - `{{is_animated_emoji_message}}` *(boolean)* — Is an animated emoji message. The received message contains an animated emoji - `{{is_album_message}}` *(boolean)* — Is an album message. The received message is part of an album - `{{is_outgoing}}` *(boolean)* — Is an outgoing message. True if the message was sent by the owner of the account (or sent via Botize) - `{{chat_username}}` *(text)* — Chat username. Public username of the chat, without the @ (only available on public chats) - `{{post_number}}` *(int)* — Post Number. Number of the message that was posted - `{{seconds_ago}}` *(int)* — Seconds since it was posted. Seconds elapsed between the moment the message was published and the moment the task read it - `{{elapse}}` *(int)* — Seconds until it was detected. Seconds elapsed between the publication of the message and the moment Botize detected it - `{{poll}}` *(array)* — Poll: Data. Contains all the information related to a possible poll that the message may include - `{{poll.question}}` *(text)* — Poll: Question. Contains the question of the poll - `{{poll.options}}` *(array)* — Poll: Options. Contains all the different options of the poll - `{{poll.options.0}}` *(text)* — Poll: Option Nº1. Contains the text of the first option of the poll. If there are more options, you can access them with {{poll.options.1}}, {{poll.options.2}}, etc. - `{{buttons}}` *(array)* — Buttons. Array containing the buttons attached to the message (if applicable) - `{{buttons.0.type}}` *(text)* — Button Nº1: Type. Type of the first button attached to the message. If there are more buttons, you can access them with {{buttons.1.type}}, {{buttons.2.type}}, etc. - `{{buttons.0.text}}` *(text)* — Button Nº1: Text. Text of the first button attached to the message. If there are more buttons, you can access them with {{buttons.1.text}}, {{buttons.2.text}}, etc. - `{{buttons.0.url}}` *(text)* — Button Nº1: URL. URL of the first button attached to the message. If there are more buttons, you can access them with {{buttons.1.url}}, {{buttons.2.url}}, etc. ## Account Needs a connected Telegram User account in Botize: https://botize.com/en/app/telegram_users/authenticate ## This app Every trigger and action for Telegram User: https://botize.com/en/app/telegram_users.md ## How to build this An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan: https://webhook.botize.es/mcp - Connection guide: https://botize.com/en/mcp - Agent map: https://botize.com/llms.txt - New account: https://botize.com/en/join (500 free operations, no card) --- Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/telegram_users/new_private_group_post