📚 WhatsApp Flow Documentation

🚀 Getting Started

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

📥 Installation

Step 1: Add Power-Up to Trello

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

Step 2: Authorize WhatsApp Flow

1. After adding the Power-Up, click the WhatsApp 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 WhatsApp Flow → "Setup" in your board menu
2. Enter Phone Number: Provide your WhatsApp phone number (with country code, e.g., +1234567890)
3. Receive Verification Code: A 6-digit code will be sent to your WhatsApp
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 WhatsApp phone number in the setup form
2. Request Code: Click "Send Verification Code"
3. Receive Code: A WhatsApp 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 WhatsApp message
• Resend: Click button to request a new code

🔗 Webhook Setup

Getting Your Webhook URL

1. Go to WhatsApp 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

// WhatsApp Flow will send the payload above

⚙️ Configuration

Settings Page

• Phone Number: Your verified WhatsApp 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 "WhatsApp Flow" messages

💬 Support & Help

Feature Requests

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

• Feature description
• Your use case
• Expected benefit

Bug Reports

Found a bug? Report it at support@whatsappflow.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)