# Instantly when receiving a text message in a chat — Telegram User

Botize method — `telegram_users.webhook_all` (trigger).

It is triggered every time you receive a message in the specified chat.
Allows you to read the content of any chat, including chats with download-protected content.

- Requires a user with access to the chat/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_id` *(string)* — Chat Id
- `only_messages_directed_to_me` *(boolean)* — Only messages from other users directed to meIgnore messages from channels and groups unless they are specifically addressed to you.
- `include_outgoing_messages` *(boolean)* — Include messages written by me or sent via BotizeUse with caution to avoid potential endless loops in the automation.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{post_number}}` *(int)* — Post Number. Number of the message that was posted
- `{{post_id}}` *(int)* — Post Id. Internal 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
- `{{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)
- `{{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.
- `{{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_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

## 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/webhook_all