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

# Overview

> Self-host GAIA's Discord, Slack, Telegram, and WhatsApp bots, architecture, prerequisites, and per-platform setup guides

GAIA ships open-source bots for Discord, Slack, Telegram, and WhatsApp. All four live in the monorepo under `apps/bots/` and talk to the same GAIA API, so a self-hosted instance gives users the same synced conversations, todos, and workflows on every platform.

<Note>
  Looking to chat with GAIA on these platforms as a user? See [Slack](/guides/slack-bot), [Discord](/guides/discord-bot), [Telegram](/guides/telegram-bot), or [WhatsApp](/guides/whatsapp-bot).
</Note>

## How the bots work

Each bot is a thin TypeScript client that forwards messages to your GAIA API and renders responses in the platform's native format (embeds on Discord, Block Kit on Slack, Markdown on Telegram). Authentication is shared: users run `/auth` once per platform to link their messaging identity to their GAIA account.

All bots require:

* Node.js 18+ and pnpm
* A running GAIA API (see [Self-Hosting](/self-hosting/overview))
* `GAIA_BOT_API_KEY` matching the value configured in your API

## Setup guides

<CardGroup cols={3}>
  <Card title="Discord" icon="discord" href="/bots/discord">
    Discord application, gateway intents, OAuth account linking, slash command deployment
  </Card>

  <Card title="Slack" icon="slack" href="/bots/slack">
    Slack app with Socket Mode, no public URL required
  </Card>

  <Card title="Telegram" icon="telegram" href="/bots/telegram">
    BotFather setup with long polling, no webhook required
  </Card>

  <Card title="WhatsApp" icon="whatsapp" href="/bots/whatsapp">
    Kapso + Meta Cloud API via signed webhook
  </Card>
</CardGroup>

## Commands

All platforms expose the same core command set (`/gaia`, `/todo`, `/workflow`, `/conversations`, `/auth`). The full list, including platform-specific behavior, is in the [Commands Reference](/bots/commands).