Your First Warp with Telegram

Bot Creation Steps:

1. Open Telegram and search for '@BotFather'
2. Start a chat with @BotFather
3. Send command: /newbot
4. Choose bot name: 'WarpTrigger Automation Bot'
5. Choose username: 'YourCompanyWarpBot' (must end with 'bot')
6. Save the bot token securely: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
7. Configure bot settings:
   - /setdescription: 'Automated notifications from WarpTrigger'
   - /setabouttext: 'Sends scheduled messages and alerts'
   - /setuserpic: Upload bot avatar image

Finding Chat IDs:

1. For Personal Chats:
   - Send a message to your bot
   - Check updates: https://api.telegram.org/botYOUR_TOKEN/getUpdates
   - Find 'chat.id' in the response

2. For Groups:
   - Add bot to the group
   - Send a message mentioning the bot
   - Check updates for negative chat ID

3. For Channels:
   - Add bot as administrator
   - Chat ID format: @channel_username or -100XXXXXXXXX

4. Using @userinfobot:
   - Add @userinfobot to your group
   - It will display the group's chat ID

Example Chat IDs:
- Personal chat: 123456789
- Group chat: -987654321
- Channel: @your_channel or -1001234567890

# Test bot API connection
curl -X POST \
  "https://api.telegram.org/bot123456789:ABCdefGHIjklMNOpqrsTUVwxyz/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "123456789",
    "text": "🤖 Hello from WarpTrigger! This is a test message to verify the bot integration is working correctly.",
    "parse_mode": "HTML"
  }'

# Expected response:
{
  "ok": true,
  "result": {
    "message_id": 123,
    "from": {
      "id": 123456789,
      "is_bot": true,
      "first_name": "WarpTrigger Bot",
      "username": "YourCompanyWarpBot"
    },
    "chat": {
      "id": 123456789,
      "first_name": "Your Name",
      "type": "private"
    },
    "date": 1647345600,
    "text": "Hello from WarpTrigger! This is a test message..."
  }
}

Warp Configuration:

Warp Name: Daily Team Standup Reminder
Description: Sends daily standup reminders to development team Telegram group
Schedule: Every weekday at 8:45 AM EST
Destination: Telegram Bot API

API Endpoint Configuration:

Base URL: https://api.telegram.org/bot{BOT_TOKEN}/sendMessage
Full URL: https://api.telegram.org/bot123456789:ABCdefGHIjklMNOpqrsTUVwxyz/sendMessage

HTTP Method: POST
Content-Type: application/json
Timeout: 30 seconds

Alternative Methods:
- sendPhoto: For image messages
- sendDocument: For file attachments
- sendLocation: For location sharing
- sendPoll: For interactive polls

{
  "chat_id": "-987654321",
  "text": "🌅 *Good morning, Development Team!*\n\n📅 *Daily Standup - {{current_date}}*\n\n⏰ *Meeting starts in 15 minutes*\n\n📋 *Today's Agenda:*\n• Share yesterday's accomplishments\n• Discuss today's priorities\n• Address any blockers or concerns\n\n🔗 *Meeting Links:*\n[Join Zoom Meeting](https://zoom.us/j/123456789)\n[Sprint Board](https://jira.company.com/sprint)\n\n💡 *Sprint Goals:*\n• Complete user authentication feature\n• Fix critical performance issues\n• Prepare demo for stakeholder review\n\n_Sent automatically by WarpTrigger at {{current_time}}_",
  "parse_mode": "Markdown",
  "disable_web_page_preview": false,
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "🎯 Join Meeting",
          "url": "https://zoom.us/j/123456789"
        },
        {
          "text": "📊 Sprint Board",
          "url": "https://jira.company.com/sprint"
        }
      ],
      [
        {
          "text": "✅ Mark as Read",
          "callback_data": "standup_acknowledged"
        }
      ]
    ]
  }
}

# HTML Formatting Example
{
  "chat_id": "@your_channel",
  "text": "<b>🚀 Deployment Notification</b>\n\n<i>Production deployment completed successfully!</i>\n\n<b>📊 Deployment Details:</b>\n• <u>Version:</u> <code>v2.1.4</code>\n• <u>Environment:</u> Production\n• <u>Deployed by:</u> <code>{{deployed_by}}</code>\n• <u>Time:</u> {{deployment_time}}\n\n<b>🔍 What's New:</b>\n• Enhanced user authentication\n• Performance optimizations\n• Bug fixes and improvements\n\n<b>📈 Metrics:</b>\n• Build time: <code>3m 42s</code>\n• Test coverage: <code>94.2%</code>\n• Performance score: <code>A+</code>\n\n<a href=\"{{monitoring_url}}\">📊 View Monitoring Dashboard</a>",
  "parse_mode": "HTML",
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "📖 Release Notes",
          "url": "{{release_notes_url}}"
        },
        {
          "text": "🔍 Monitor App",
          "url": "{{monitoring_url}}"
        }
      ],
      [
        {
          "text": "🐛 Report Issue",
          "url": "{{issue_tracker_url}}"
        },
        {
          "text": "💬 Discuss",
          "url": "{{discussion_url}}"
        }
      ]
    ]
  }
}

# Markdown Formatting Reference:
*bold text*
_italic text_  
`inline code`
```block code```
[link text](URL)

# HTML Formatting Reference:
<b>bold</b>
<i>italic</i>
<u>underline</u>
<s>strikethrough</s>
<code>code</code>
<pre>preformatted</pre>
<a href="URL">link</a>

# Send Photo with Caption
{
  "chat_id": "-987654321",
  "photo": "https://your-server.com/images/daily-metrics-\{\{current_date\}\}.png",
  "caption": "📊 *Daily Metrics Dashboard*\n\n📅 \{\{current_date\}\}\n\n🎯 *Today's Highlights:*\n• New users: \{\{new_users\}\}\n• Revenue: $\{\{daily_revenue\}\}\n• Conversion rate: \{\{conversion_rate\}\}%\n\n_Updated automatically every morning_",
  "parse_mode": "Markdown"
}

# Send Document
{
  "chat_id": "@your_channel",
  "document": "https://your-server.com/reports/weekly-report-\{\{week_number\}\}.pdf",
  "caption": "📋 Weekly Performance Report - Week \{\{week_number\}\}\n\nGenerated automatically by WarpTrigger",
  "parse_mode": "Markdown"
}

{
  "chat_id": "-987654321",
  "question": "🗳️ What should be our team focus for next sprint?",
  "options": [
    "🚀 New feature development",
    "🐛 Bug fixes and stability",
    "⚡ Performance optimization",
    "📚 Technical documentation",
    "🔧 Infrastructure improvements"
  ],
  "is_anonymous": false,
  "type": "regular",
  "allows_multiple_answers": true,
  "open_period": 86400,
  "explanation": "This poll helps us prioritize our work for the upcoming sprint. You can select multiple options that you think are important.",
  "explanation_parse_mode": "Markdown"
}

Multi-Chat Broadcasting Strategy:

Broadcast Scenarios:
1. Emergency Alerts:
   - Send to all team channels
   - Direct message to key personnel
   - Post to company announcement channel

2. System Maintenance:
   - Notify development teams
   - Update customer support channels
   - Post to public status channel

3. Company Announcements:
   - All-hands channel
   - Department-specific channels
   - Leadership team chat

Implementation Approaches:
1. Multiple Warps (parallel execution)
2. Sequential API calls (single Warp)
3. Webhook chaining (triggered sequence)

Chat ID Management:
- Development Team: -987654321
- Support Team: -123456789
- Announcements: @company_news
- CEO Direct: 555666777