agent-messenger 1.15.0 → 2.1.0

package/docs/content/docs/cli/whatsappbot.mdx

@@ -0,0 +1,169 @@
+---
+title: WhatsApp Bot
+description: Complete reference for the agent-whatsappbot CLI.
+---
+
+> **Tip**: `agent-whatsappbot` is a shortcut for `agent-messenger whatsappbot`.
+
+## Quick Start
+
+```bash
+# 1. Set your API credentials
+agent-whatsappbot auth set your-phone-number-id your-access-token
+
+# 2. Verify authentication
+agent-whatsappbot auth status
+
+# 3. List available message templates
+agent-whatsappbot template list --pretty
+
+# 4. Send a text message (recipient must have messaged you within 24h)
+agent-whatsappbot message send 15551234567 "Hello from the CLI!"
+```
+
+## Key Concepts
+
+WhatsApp Business Cloud API works differently from the user-mode WhatsApp integration:
+
+| Concept              | Description                                                                 |
+| -------------------- | --------------------------------------------------------------------------- |
+| **Send-only**        | Cannot list or read received messages. Inbound messages require webhooks.    |
+| **Template messages** | Required outside the 24-hour customer service window. Must be pre-approved. |
+| **Phone Number ID**  | Your WhatsApp Business phone number's unique identifier (not the number).   |
+| **Access Token**     | Token from Meta Business Manager with `whatsapp_business_messaging` permission. |
+| **Rate limits**      | Tier 0-3: 80 msg/s. Tier 4: 1,000 msg/s. Based on business verification.   |
+
+## Authentication
+
+### API Credential Setup
+
+agent-whatsappbot uses Phone Number ID + Access Token pairs from Meta Business Manager:
+
+```bash
+# Set credentials (validates against WhatsApp Cloud API before saving)
+agent-whatsappbot auth set <phone-number-id> <access-token>
+
+# Check auth status
+agent-whatsappbot auth status
+agent-whatsappbot auth status --account <account-id>
+
+# Clear stored credentials
+agent-whatsappbot auth clear
+```
+
+### How to Get API Credentials
+
+1. Go to [Meta Business Manager](https://business.facebook.com/)
+2. Navigate to your WhatsApp Business Account
+3. Open **WhatsApp Manager > Phone Numbers** to find your **Phone Number ID**
+4. Go to **Business Settings > System Users** to create a system user and generate an **Access Token** with `whatsapp_business_messaging` permission
+5. Run `agent-whatsappbot auth set <phone-number-id> <access-token>`
+
+### Multi-Account Management
+
+```bash
+# List stored accounts
+agent-whatsappbot auth list
+
+# Switch active account
+agent-whatsappbot auth use <account-id>
+
+# Remove a stored account
+agent-whatsappbot auth remove <account-id>
+```
+
+## Commands
+
+### Message Commands
+
+```bash
+# Send a text message
+agent-whatsappbot message send <to> <text>
+agent-whatsappbot message send 15551234567 "Your order has shipped!"
+
+# Send a template message
+agent-whatsappbot message send-template <to> <template-name>
+agent-whatsappbot message send-template 15551234567 order_confirmation \
+  --language en_US \
+  --components '[{"type":"body","parameters":[{"type":"text","text":"Alice"},{"type":"text","text":"ORD-9876"}]}]'
+
+# Send a reaction to a message
+agent-whatsappbot message send-reaction <to> <message-id> <emoji>
+agent-whatsappbot message send-reaction 15551234567 wamid.abc123 "👍"
+
+# Send an image
+agent-whatsappbot message send-image <to> <url>
+agent-whatsappbot message send-image 15551234567 "https://example.com/photo.jpg" --caption "Product photo"
+
+# Send a document
+agent-whatsappbot message send-document <to> <url>
+agent-whatsappbot message send-document 15551234567 "https://example.com/invoice.pdf" \
+  --filename "invoice.pdf" --caption "Your invoice"
+```
+
+### Template Commands
+
+```bash
+# List message templates
+agent-whatsappbot template list
+agent-whatsappbot template list --limit 20
+
+# Get template details
+agent-whatsappbot template get <template-name>
+agent-whatsappbot template get order_confirmation
+```
+
+## Global Options
+
+| Option           | Description                                |
+| ---------------- | ------------------------------------------ |
+| `--pretty`       | Human-readable output instead of JSON      |
+| `--account <id>` | Use a specific account for this command     |
+
+## Storage
+
+Credentials stored in `~/.config/agent-messenger/whatsappbot-credentials.json` (0600 permissions).
+
+## Limitations
+
+- **Cannot list or read received messages** -- WhatsApp Cloud API delivers inbound messages via webhooks only. This CLI is send-only.
+- **Template messages required outside 24h window** -- Free-form text only works within 24 hours of the customer's last message.
+- **Business verification required for higher tiers** -- Unverified businesses are limited in daily messaging volume.
+- **No group chat support** -- WhatsApp Cloud API does not support group messaging.
+- **No real-time events / WebSocket connection** -- Inbound messages require a separate webhook server.
+- **No message editing or deletion**
+- **No file upload from local disk** -- Images and documents must be provided as URLs.
+- **No voice or video calls**
+- **Phone number must be registered with WhatsApp Business** -- Personal WhatsApp numbers won't work.
+
+## Troubleshooting
+
+### `agent-whatsappbot: command not found`
+
+**`agent-whatsappbot` is NOT the npm package name.** The npm package is `agent-messenger`.
+
+```bash
+# If installed globally
+agent-whatsappbot message send 15551234567 "Hello"
+
+# If not installed, use npx
+npx -y agent-messenger whatsappbot message send 15551234567 "Hello"
+```
+
+### Template messages not sending
+
+- Verify the template exists: `agent-whatsappbot template get <name>`
+- Check the template status is `APPROVED` (not `PENDING` or `REJECTED`)
+- Ensure the `--language` matches the template's language code exactly
+- Verify `--components` JSON matches the template's parameter structure
+
+### Rate limiting
+
+WhatsApp enforces rate limits based on your business tier. The CLI automatically retries on rate limit (429) responses. For bulk operations, add delays between requests.
+
+## AI Agent Integration
+
+See [`skills/agent-whatsappbot/`](https://github.com/devxoul/agent-messenger/tree/main/skills/agent-whatsappbot) for:
+
+- Complete skill documentation
+- Common patterns for AI agent workflows

package/docs/content/docs/index.mdx

@@ -1,10 +1,10 @@
 ---
 title: What is Agent Messenger?
-description: Give your AI agent the power to read and send messages across Slack, Discord, Teams, Channel Talk and more
+description: Give your AI agent the power to read and send messages across Slack, Discord, Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, Channel Talk, and more
 icon: Info
 ---
 
-Agent Messenger is a unified, agent-friendly CLI for messaging platforms. Zero-config credential extraction from your desktop apps—no OAuth flows, no API keys, no admin approval needed. Works out of the box. Supports Slack, Discord, Teams, and Channel Talk (beta).
+Agent Messenger is a unified, agent-friendly CLI for messaging platforms. Zero-config credential extraction from your desktop apps—no OAuth flows, no API keys, no admin approval needed. Works out of the box. Supports Slack, Discord, Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk (beta).
 
 ## Why Agent Messenger?
 
@@ -12,14 +12,14 @@ Messaging platforms only offer Bot tokens for API access—your AI agent can nev
 
 - **Act as yourself, not a bot** — Extracted user tokens let your agent operate on your behalf
 - **No API keys needed** — Automatically extracts credentials from your installed desktop apps
-- **One interface, multiple platforms** — Learn once, use everywhere (Slack, Discord, Teams, Channel Talk)
+- **One interface, multiple platforms** — Learn once, use everywhere (Slack, Discord, Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, Channel Talk)
 - **AI-agent friendly** — JSON output by default, perfect for LLM tool use
 - **Human friendly too** — Add `--pretty` for readable output
 - **Token efficient** — CLI, not MCP. Load only what you need
 
 ## How It Works
 
-Agent Messenger reads authentication tokens directly from your installed desktop apps (Slack, Discord, Teams, Channel Talk). These apps store session tokens locally, and Agent Messenger safely extracts them.
+Agent Messenger reads authentication tokens directly from your installed desktop apps (Slack, Discord, Teams, KakaoTalk, Channel Talk). Telegram uses TDLib with auto-provisioned API credentials. WhatsApp authenticates via pairing code. KakaoTalk supports both credential extraction and sub-device login. These apps store session tokens locally, and Agent Messenger safely extracts them.
 
 ```bash
 # Extract credentials from Slack desktop app
@@ -36,11 +36,11 @@ No app creation. No admin approval. No waiting.
 | Feature             | Description                                                                                                                       |
 | ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
 | **Auto-extraction** | Pulls tokens from desktop apps automatically                                                                                      |
-| **Multi-platform**  | Slack, Discord, Microsoft Teams, and Channel Talk (beta)                                                                          |
+| **Multi-platform**  | Slack, Discord, Microsoft Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk (beta)                                                                          |
 | **Multi-workspace** | Switch between workspaces/servers easily                                                                                          |
 | **JSON output**     | Machine-readable by default, `--pretty` for humans                                                                                |
 | **Comprehensive**   | Messages, channels, users, reactions, files                                                                                       |
-| **Bot support**     | [`agent-slackbot`](/docs/integrations/slackbot), [`agent-discordbot`](/docs/integrations/discordbot), and [`agent-channeltalkbot`](/docs/integrations/channeltalkbot) for server-side and CI/CD |
+| **Bot support**     | [`agent-slackbot`](/docs/cli/slackbot), [`agent-discordbot`](/docs/cli/discordbot), and [`agent-channeltalkbot`](/docs/cli/channeltalkbot) for server-side and CI/CD |
 
 ## Why Not MCP?
 
@@ -81,7 +81,7 @@ OAuth is better when you need:
 - **Multi-user applications** - Many users authenticating separately
 - **Granular permissions** - Fine-tuned access control
 
-For these use cases, Agent Messenger also supports bot tokens via [`agent-slackbot`](/docs/integrations/slackbot), [`agent-discordbot`](/docs/integrations/discordbot), and [`agent-channeltalkbot`](/docs/integrations/channeltalkbot).
+For these use cases, Agent Messenger also supports bot tokens via [`agent-slackbot`](/docs/cli/slackbot), [`agent-discordbot`](/docs/cli/discordbot), and [`agent-channeltalkbot`](/docs/cli/channeltalkbot).
 
 ## Design Principles
 
@@ -95,7 +95,7 @@ Default output is JSON for machines. Add `--pretty` for humans. Both are first-c
 
 ### Unified Interface
 
-Learn once, use everywhere. The same commands work across Slack, Discord, and Teams.
+Learn once, use everywhere. The same commands work across Slack, Discord, Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk.
 
 ### Fail Fast, Fail Clear
 
@@ -108,13 +108,19 @@ Tokens stay on your machine. Nothing is sent to external servers. Your credentia
 ## Next Steps
 
 - [Quick Start](/docs/quick-start) - Get running in 30 seconds
-- [Slack](/docs/integrations/slack) - Full Slack command reference
-- [Slack Bot](/docs/integrations/slackbot) - Bot token integration for server-side and CI/CD
-- [Discord](/docs/integrations/discord) - Full Discord command reference
-- [Discord Bot](/docs/integrations/discordbot) - Bot token integration for server-side and CI/CD
-- [Teams](/docs/integrations/teams) - Full Teams command reference
-- [Channel Talk](/docs/integrations/channeltalk) - Full Channel Talk command reference (beta)
-- [Channel Talk Bot](/docs/integrations/channeltalkbot) - Bot API integration for Channel Talk (beta)
+- [Slack](/docs/cli/slack) - Full Slack command reference
+- [Slack Bot](/docs/cli/slackbot) - Bot token integration for server-side and CI/CD
+- [Discord](/docs/cli/discord) - Full Discord command reference
+- [Discord Bot](/docs/cli/discordbot) - Bot token integration for server-side and CI/CD
+- [Teams](/docs/cli/teams) - Full Teams command reference
+- [Telegram](/docs/cli/telegram) - TDLib setup and Telegram command reference
+- [WhatsApp](/docs/cli/whatsapp) - Full WhatsApp command reference
+- [WhatsApp Bot](/docs/cli/whatsappbot) - Cloud API integration for WhatsApp Business
+- [LINE](/docs/cli/line) - Full LINE command reference
+- [Instagram](/docs/cli/instagram) - Instagram DM integration via private mobile API
+- [KakaoTalk](/docs/cli/kakaotalk) - Full KakaoTalk command reference
+- [Channel Talk](/docs/cli/channeltalk) - Full Channel Talk command reference (beta)
+- [Channel Talk Bot](/docs/cli/channeltalkbot) - Bot API integration for Channel Talk (beta)
 
 ## Inspiration
 

package/docs/content/docs/meta.json

@@ -1,3 +1,11 @@
 {
-  "pages": ["index", "quick-start", "integrations", "agent-skills"]
+  "pages": [
+    "index",
+    "quick-start",
+    "agent-skills",
+    "tui",
+    "---",
+    "cli",
+    "sdk"
+  ]
 }

package/docs/content/docs/quick-start.mdx

@@ -23,13 +23,19 @@ yarn global add agent-messenger
 bun add -g agent-messenger
 ```
 
-This installs seven CLI tools:
+This installs these CLI tools:
 
 - `agent-slack` — Slack CLI (user token, zero-config)
 - `agent-slackbot` — Slack Bot CLI (bot token, for server-side/CI/CD)
 - `agent-discord` — Discord CLI (user token, zero-config)
 - `agent-discordbot` — Discord Bot CLI (bot token, for server-side/CI/CD)
 - `agent-teams` — Microsoft Teams CLI
+- `agent-telegram` — Telegram CLI (user account via TDLib)
+- `agent-whatsapp` — WhatsApp CLI (user account via Baileys, pairing code auth)
+- `agent-whatsappbot` — WhatsApp Bot CLI (Cloud API, for server-side/CI/CD)
+- `agent-line` — LINE CLI (QR code login, Thrift protocol)
+- `agent-instagram` — Instagram DM CLI (user account via private mobile API)
+- `agent-kakaotalk` — KakaoTalk CLI (sub-device login, LOCO protocol)
 - `agent-channeltalk` — Channel Talk CLI (beta, zero-config, extracted cookies)
 - `agent-channeltalkbot` — Channel Talk Bot CLI (beta, API credentials, for server-side/CI/CD)
 
@@ -47,6 +53,12 @@ agent-discord auth extract
 # For Teams
 agent-teams auth extract
 
+# For Telegram — interactive login with auto API credential provisioning
+agent-telegram auth login
+
+# For KakaoTalk — login as sub-device (desktop stays running)
+agent-kakaotalk auth login
+
 # For Channel Talk (beta) — auto-extracted from desktop app
 agent-channeltalk auth extract
 ```
@@ -105,11 +117,15 @@ agent-slack workspace current
 
 ## Next Steps
 
-- [Slack Reference](/docs/integrations/slack) - Full command reference
-- [Slack Bot Reference](/docs/integrations/slackbot) - Bot token for server-side/CI/CD
-- [Discord Reference](/docs/integrations/discord) - Full command reference
-- [Discord Bot Reference](/docs/integrations/discordbot) - Bot token for server-side/CI/CD
-- [Teams Reference](/docs/integrations/teams) - Full command reference
-- [Channel Talk Reference](/docs/integrations/channeltalk) - Full command reference (beta)
-- [Channel Talk Bot Reference](/docs/integrations/channeltalkbot) - Bot API for Channel Talk (beta)
+- [Slack Reference](/docs/cli/slack) - Full command reference
+- [Slack Bot Reference](/docs/cli/slackbot) - Bot token for server-side/CI/CD
+- [Discord Reference](/docs/cli/discord) - Full command reference
+- [Discord Bot Reference](/docs/cli/discordbot) - Bot token for server-side/CI/CD
+- [Teams Reference](/docs/cli/teams) - Full command reference
+- [Telegram Reference](/docs/cli/telegram) - TDLib setup and command reference
+- [WhatsApp Reference](/docs/cli/whatsapp) - Full command reference
+- [WhatsApp Bot Reference](/docs/cli/whatsappbot) - Cloud API for WhatsApp Business
+- [KakaoTalk Reference](/docs/cli/kakaotalk) - Full command reference
+- [Channel Talk Reference](/docs/cli/channeltalk) - Full command reference (beta)
+- [Channel Talk Bot Reference](/docs/cli/channeltalkbot) - Bot API for Channel Talk (beta)
 - [Agent Skills](/docs/agent-skills) - Integrate with AI coding agents