---
title: Adeli
description: Instagram, Facebook, and WhatsApp DMs, and Instagram and TikTok comments, through one Adeli API key. Users connect their accounts in the Adeli dashboard, so the bot needs no Meta app, App Review, or TikTok developer access.
tagline: Answer Instagram, Facebook, and WhatsApp DMs, and Instagram and TikTok comments, from one bot and one API key, with signed webhooks and native Instagram buttons.
package: @adeli/chat-sdk-adapter
---
# Adeli
## Create a new bot
Scaffold a Next.js bot with the Adeli adapter using [`create-chat-sdk`](/docs/create-chat-sdk):
The generated app uses the [Memory state adapter](/adapters/official/memory) for local development. To add the adapter to an existing app, start at [Install](#install).
## Install
## Quick start
```typescript title="lib/bot.ts" lineNumbers
import { Chat } from "chat";
import { createMemoryState } from "@chat-adapter/state-memory";
import { createAdeliAdapter } from "@adeli/chat-sdk-adapter";
export const bot = new Chat({
userName: "shopbot",
adapters: {
adeli: createAdeliAdapter({
apiKey: process.env.ADELI_API_KEY!,
webhookSecret: process.env.ADELI_WEBHOOK_SECRET!,
}),
},
state: createMemoryState(),
});
// A new DM, or a new top-level comment on one of the account's posts.
bot.onNewMention(async (thread, message) => {
await thread.subscribe();
await thread.post(`Thanks for reaching out! You said: ${message.text}`);
});
// Later messages in a DM, or replies under the same comment.
bot.onSubscribedMessage(async (thread, message) => {
await thread.post("Got it. A teammate will follow up shortly.");
});
```
The memory state adapter forgets subscriptions on every restart. Use [Redis](/adapters/official/redis) or [PostgreSQL](/adapters/official/postgres) in production.
Then create the webhook route:
```typescript title="app/api/webhooks/adeli/route.ts" lineNumbers
import { after } from "next/server";
import { bot } from "@/lib/bot";
export async function POST(request: Request) {
return bot.webhooks.adeli(request, { waitUntil: (task) => after(() => task) });
}
```
## Platform setup
1. Sign in at [app.tryadeli.com](https://app.tryadeli.com), open **API keys**, create a key, and set it as `ADELI_API_KEY`.
2. On the **Accounts** page, connect the Instagram, Facebook Page, WhatsApp Business, or TikTok accounts the bot should answer for. Each connected account is one Chat SDK channel, `adeli:`.
3. Deploy the webhook route from [Quick start](#quick-start), for example at `https://bot.example.com/api/webhooks/adeli`. The URL must use `https`.
4. Register a webhook for `message.created`, `message.postback`, and `comment.created`. In the dashboard, open **Webhooks**, click **Add webhook**, and enter the URL. You can also create it with the API:
```bash
curl https://app.tryadeli.com/api/v1/webhooks \
-H "Authorization: Bearer $ADELI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"profileId": "",
"url": "https://bot.example.com/api/webhooks/adeli",
"events": ["message.created", "message.postback", "comment.created"]
}'
```
Replace `` with your Adeli profile id (see [List profiles](https://www.tryadeli.com/docs/api/profiles/list-profiles)).
5. Store the signing secret from the response as `ADELI_WEBHOOK_SECRET`. Adeli shows it only once. To rotate it, delete the webhook and create it again.
6. Send a test event from the webhook's row in the dashboard. The adapter verifies and acknowledges test events (`"test": true`) without calling your handlers.
## Configuration
`createAdeliAdapter()` reads each credential from its environment variable when you omit it from the config.
string | Promise)",
description:
"Adeli API key (`rk_live_…`), or a function returning it. Resolved before every API request. Falls back to `ADELI_API_KEY`.",
},
webhookSecret: {
type: "string | (() => string | Promise)",
description:
"Signing secret of the Adeli webhook that delivers to the bot (`whsec_…`), or a function returning it. Resolved on every webhook. Falls back to `ADELI_WEBHOOK_SECRET`.",
},
profileId: {
type: "string",
description:
"Profile id sent with API calls. Also scopes Chat SDK locks and dedupe. Only needed when the key can reach more than one profile. Falls back to `ADELI_PROFILE_ID`. Creating the webhook always takes a profile id, even when the adapter doesn't need one.",
},
baseURL: {
type: "string",
description:
"Adeli API origin. Falls back to `ADELI_BASE_URL`, then `https://app.tryadeli.com`.",
},
userName: {
type: "string",
description: 'Bot display name. Defaults to `"adeli-bot"`.',
},
webhookToleranceSeconds: {
type: "number",
description:
"Maximum age of a webhook's signed timestamp. Defaults to `300`.",
},
fetch: {
type: "typeof fetch",
description:
"`fetch` implementation for API calls. Defaults to `globalThis.fetch`.",
},
logger: {
type: "Logger",
description: "Custom logger. Defaults to the `Chat` instance's logger.",
},
}}
/>
### Environment variables
| Variable | Required | Description |
| ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
| `ADELI_API_KEY` | Yes | Adeli API key (`rk_live_…`), from **API keys** in the Adeli dashboard |
| `ADELI_WEBHOOK_SECRET` | Yes | Signing secret of the Adeli webhook that delivers to your bot (`whsec_…`) |
| `ADELI_PROFILE_ID` | No | Adeli profile id. Only needed when the key can reach more than one profile. Creating the webhook always takes one |
| `ADELI_BASE_URL` | No | Adeli API origin. Defaults to `https://app.tryadeli.com` |
### Rotating credentials
`apiKey` and `webhookSecret` each accept a function instead of a string. The adapter calls `apiKey` before every API request and `webhookSecret` on every webhook, and never caches the result, so a rotated or short-lived credential takes effect on the next call:
```typescript
createAdeliAdapter({
apiKey: async () => (await secrets.get("adeli-api-key")).value,
webhookSecret: () => process.env.ADELI_WEBHOOK_SECRET!,
});
```
## Webhooks
Adeli signs every delivery with an `Adeli-Signature` header (HMAC-SHA256 with a timestamp). The adapter rejects unsigned, mis-signed, and stale deliveries (older than `webhookToleranceSeconds`) with `401`, answers `200` at once, and runs your handlers in `waitUntil`. Adeli retries failed deliveries for about nine hours with the same event id. Chat SDK drops redelivered messages and comments that arrive within its dedupe window (`dedupeTtlMs`, 10 minutes by default); button taps (`message.postback`) are not deduplicated.
Unless you register `onDirectMessage`, every inbound DM reaches `onNewMention`, as does every new top-level comment. Replies under a comment reach `onSubscribedMessage` once the thread is subscribed. See the [Adeli webhooks docs](https://www.tryadeli.com/docs/api/webhooks) for the event payloads.
## Buttons
On Instagram DMs, a card's `