> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lyzr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Messaging

> Connect your GitAgent instance to Telegram, WhatsApp, and phone calls via Twilio.

All three channels run through the same GitAgent instance — no separate services to manage.

## Telegram

Set `TELEGRAM_BOT_TOKEN` and the agent automatically becomes a Telegram bot. No extra config needed.

```bash theme={null}
TELEGRAM_BOT_TOKEN=your_token gitagent --voice --dir ~/assistant
```

## WhatsApp

<Note>
  WhatsApp has no env var toggle. Set it up once through the Web UI — credentials persist automatically after that.
</Note>

1. Start `gitagent --voice`
2. Open `localhost:3333` → go to **Integrations** → scan the QR code
3. Credentials are saved to `.gitagent/whatsapp-auth/creds.json`
4. On every subsequent start, WhatsApp auto-reconnects if that file exists

## Phone (via Twilio)

<Note>
  GitAgent does not read `TWILIO_ACCOUNT_SID` or `TWILIO_AUTH_TOKEN`. Setup is done entirely in the Twilio Console.
</Note>

1. Start `gitagent --voice`
2. In the Twilio Console, set your webhook URL to your server's phone endpoint
3. Incoming calls are routed to the agent automatically

```
# Webhook URL to set in Twilio Console:
https://your-server/api/phone/webhook
```

<CardGroup cols={2}>
  <Card title="Personal Assistant Quick Start" icon="rocket" href="/open-source/gitagent/personal-assistant/quickstart">
    Install GitAgent and run your first session
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/open-source/gitagent/personal-assistant/cli">
    All flags, REPL commands, and the plugin CLI
  </Card>

  <Card title="Web & Voice" icon="browser" href="/open-source/gitagent/personal-assistant/web-voice">
    Run the full browser interface with real-time voice
  </Card>

  <Card title="Integrations" icon="diagram-project" href="/open-source/gitagent/data-integrations/integrations">
    Connect Composio services like Gmail, Slack, and GitHub
  </Card>
</CardGroup>