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

# Integrations Overview

> Two ways to connect external services to MeepaChat

MeepaChat integrations are standalone HTTP services that communicate with MeepaChat via its REST API. The platform provides two integration models depending on how much interactivity you need.

## Two ways to integrate

<CardGroup cols={2}>
  <Card title="Incoming Webhooks" icon="webhook" href="/meepachat/integrations/webhooks">
    Post messages to a channel via a single HTTP POST. No OAuth, no hosting required beyond the HTTP call. Best for CI/CD notifications, monitoring alerts, and one-way event feeds.
  </Card>

  <Card title="Full Apps" icon="grid-2" href="/meepachat/integrations/apps">
    Interactive integrations with OAuth install flows, slash commands, buttons, select menus, and modals. Best for two-way workflows like GitHub PR review, ticket management, or approval queues.
  </Card>
</CardGroup>

## Architecture

MeepaChat is the platform. Your integration is a separate HTTP service you build and host.

```
External service  →  Your integration  →  MeepaChat REST API
     (event)           (Worker / server)       (messages, webhooks)

MeepaChat  →  Your integration  →  Response
  (interaction)    (Worker / server)   (message, update, defer)
```

For webhooks, the flow is one-way: your service calls MeepaChat. For apps, the flow is bidirectional: MeepaChat also calls your service when users interact with buttons, slash commands, or modals.

## Developer Portal

Manage your integrations at `/developer` on your MeepaChat instance. From there you can:

* Create and configure apps
* Generate incoming webhook URLs
* View app credentials (client ID, client secret)
* Set your interaction URL for receiving events

<Note>
  The Developer Portal is available to all registered users. Each app is owned by the user who created it and can be installed across multiple servers.
</Note>

## Choosing a model

|                     | Webhooks | Full Apps |
| ------------------- | -------- | --------- |
| Setup complexity    | Low      | Medium    |
| Requires hosting    | No       | Yes       |
| OAuth install flow  | No       | Yes       |
| Slash commands      | No       | Yes       |
| Buttons / modals    | No       | Yes       |
| Two-way interaction | No       | Yes       |

## Starter template

The [Cloudflare Worker template](https://github.com/bogpad/meepachat/tree/main/integrations/template) is the fastest way to start building a full app. Clone it and deploy to Cloudflare Workers in minutes.

```bash theme={null}
git clone https://github.com/bogpad/meepachat
cp -r meepachat/integrations/template my-integration
cd my-integration
npm install
```

See the [Apps guide](/meepachat/integrations/apps) for a full walkthrough.