== Telegram Source Kamelet Description

=== Authentication

This Kamelet requires a Telegram Bot token for authentication. You need to create a Telegram bot through @BotFather and obtain the bot token.

=== Configuration

The Telegram Source Kamelet supports the following configurations:

- **Authorization Token**: Telegram bot token (required)
- **Chat ID**: Telegram chat ID to monitor (optional, can monitor all chats if not specified)

=== Output Format

The Kamelet outputs Telegram messages as JSON objects containing message content, sender information, chat details, and timestamp.

=== Bot Setup

1. Contact @BotFather on Telegram
2. Create a new bot with /newbot command
3. Follow the instructions to set bot name and username
4. Copy the provided bot token
5. Add the bot to your chat or channel

=== Usage Example

[source,yaml,subs='+attributes,macros']
----
- route:
    from:
      uri: "kamelet:telegram-source"
      parameters:
        authorizationToken: "your-bot-token-here"
      steps:
        - to:
            uri: "kamelet:log-sink"
----

=== Example with Specific Chat

[source,yaml,subs='+attributes,macros']
----
- route:
    from:
      uri: "kamelet:telegram-source"
      parameters:
        authorizationToken: "your-bot-token-here"
        chatId: "-1001234567890"
      steps:
        - to:
            uri: "kamelet:log-sink"
----

=== Message Processing

The kamelet receives all types of Telegram messages including text, photos, documents, and other media. Message metadata includes sender information, chat details, and message type.