Telegram Jorge

Steps:

1. Load the environment variables from .env:

   source <(grep -E '^TELEGRAM_' .env | sed 's/^/export /')
   

2. Confirm with the user what message they want to send before sending it.
3. Send the message using curl.
4. Check the response — "ok":true means success.
5. Report back to the user that the message was delivered to the recipient (use TELEGRAM_RECIPIENT_NAME).

How to Send an Image

From a local file:

curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendPhoto" \
  -F "chat_id=${TELEGRAM_CHAT_ID}" \
  -F "photo=@/path/to/image.jpg" \
  -F "caption=Optional caption here"

From a URL:

curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendPhoto" \
  -H "Content-Type: application/json" \
  -d "{\"chat_id\": \"${TELEGRAM_CHAT_ID}\", \"photo\": \"IMAGE_URL_HERE\", \"caption\": \"Optional caption\"}"

Steps:

1. Load the environment variables from .env.
2. Confirm with the user what image and optional caption they want to send.
3. If a local file path is provided, use the multipart form approach (-F).
4. If a URL is provided, use the JSON approach.
5. Check the response for success.
6. Report back to the user.

How to Send a Document/File

curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendDocument" \
  -F "chat_id=${TELEGRAM_CHAT_ID}" \
  -F "document=@/path/to/file.pdf" \
  -F "caption=Optional caption here"

Supported Markdown Formatting (parse_mode: Markdown)

• *bold*
• _italic_
• `inline code`
• code block
• [link text](URL)

Important Rules

1. ALWAYS confirm the message content with the user before sending. Never send without approval.
2. ALWAYS load env vars from .env before making API calls.
3. If TELEGRAM_BOT_TOKEN is not set, inform the user they need to:
   • Create a bot via @BotFather on Telegram
   • Add the token to .env as TELEGRAM_BOT_TOKEN=your-token-here
4. On error, show the API response to help debug.
5. Keep messages concise and useful — avoid sending walls of text.