📚 Telegram Flow Documentation

🚀 Getting Started

Telegram Flow connects your Trello board to Telegram, delivering real-time notifications about card, list, and board changes. Stay updated on what matters most without leaving Telegram.

📥 Installation

Step 1: Add Power-Up to Trello

1. Open any Trello board
2. Click "Power-Ups" in the board menu
3. Search for "Telegram Flow"
4. Click "Add" button

Step 2: Authorize Telegram Flow

1. After adding the Power-Up, click the Telegram Flow button in the board menu
2. Click "Settings" → "Authorize"
3. Allow Trello permissions on the authorization page
4. You'll see a success message

🔧 Setup Guide

Initial Setup Steps

1. Go to Setup Page: Click Telegram Flow → "Setup" in your board menu
2. Enter Phone Number: Provide your Telegram phone number (with country code, e.g., +1234567890)
3. Receive Verification Code: A 6-digit code will be sent to your Telegram
4. Verify Code: Enter the code on the setup page
5. Configure Events: Choose which Trello events trigger notifications
6. Save Settings: Click "Save" to activate notifications

🎯 Features Overview

Board-Level Settings

Access these from the Power-Ups menu:

📬 Supported Events

Card Events

List Events

Board Events

Card Details Events

📱 Phone Verification Process

How It Works

1. Submit Phone Number: Enter your Telegram phone number in the setup form
2. Request Code: Click "Send Verification Code"
3. Receive Code: A Telegram message with a 6-digit code arrives within 30 seconds
4. Enter Code: Paste the code into the verification field
5. Verification Complete: Your phone is now verified

Verification Codes

• Format: 6 random digits (e.g., 123456)
• Validity: 10 minutes
• Delivery: Via Telegram message
• Resend: Click button to request a new code

🔗 Webhook Setup

Getting Your Webhook URL

1. Go to Telegram Flow Settings
2. Look for "Webhook URL" section
3. Copy your unique webhook URL
4. Use this URL to integrate with external services

Webhook Payload Format

{
  "event": "card.created",
  "board_id": "your_board_id",
  "board_name": "Board Name",
  "data": {
    "id": "card_id",
    "name": "Card Title",
    "description": "Card description",
    "list": "List Name",
    "members": ["member1", "member2"],
    "due_date": "2024-12-31",
    "labels": ["label1", "label2"]
  },
  "timestamp": "2024-12-21T10:30:00Z"
}

Example Integration

Send webhooks to Zapier, Make, or any webhook receiver:

POST https://your-webhook-url.com/webhooks
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

// Telegram Flow will send the payload above

⚙️ Configuration

Settings Page

• Phone Number: Your verified Telegram number
• Enable Notifications: Toggle to pause/resume
• Event Types: Select which events trigger notifications
• Quiet Hours: (Optional) Set times to mute notifications
• Message Prefix: Customize notification prefix

Event Configuration

🔌 API Reference

Available Endpoints

Send Verification Code

POST /api/send-verification
Content-Type: application/json

{
  "phone_number": "+1234567890"
}

Response:
{
  "success": true,
  "message": "Verification code sent",
  "expires_in": 600
}

Verify Code

POST /api/verify-code
Content-Type: application/json

{
  "phone_number": "+1234567890",
  "code": "123456"
}

Response:
{
  "success": true,
  "message": "Phone verified",
  "verified_at": "2024-12-21T10:30:00Z"
}

🔧 Troubleshooting

Common Issues

Debug Mode

To view detailed logs:

1. Open your board
2. Press F12 to open Developer Console
3. Go to "Console" tab
4. Look for "Telegram Flow" messages

💬 Support & Help

Feature Requests

Have a feature idea? We'd love to hear it! Email support@Telegramflow.app with:

• Feature description
• Your use case
• Expected benefit

Bug Reports

Found a bug? Report it at support@Telegramflow.app with:

• Description of the issue
• Steps to reproduce
• Screenshots (if applicable)
• Browser and OS version
• Console errors (F12 → Console)

Privacy & Security

• Privacy Policy: Read our Privacy Policy
• Terms of Service: Read our Terms
• Security: We use industry-standard encryption (TLS/HTTPS)