---
title: Kapso
description: Managed WhatsApp conversations, media, buttons, and history through Kapso.
type: channel
keywords:
  - chat sdk
  - kapso
  - whatsapp
  - meta
  - business
  - buttons
  - media
---

# Kapso

Channel integration for eve. Managed WhatsApp conversations, media, buttons, and history through Kapso.

## Install

Add this Chat SDK channel from eve's registry. This writes `agent/channels/kapso.ts` and installs Chat SDK and its adapter dependencies:

```bash
eve add channel/chat-sdk-kapso
```

## Quick start

Create `agent/channels/kapso.ts`:

```ts
// agent/channels/kapso.ts
import { createKapsoAdapter } from "@kapso/chat-adapter";
import { createMemoryState } from "@chat-adapter/state-memory";
import type { Message, Thread } from "chat";
import { chatSdkChannel } from "eve/channels/chat-sdk";

export const { bot, channel, send } = chatSdkChannel({
  userName: "My Agent",
  adapters: {
    kapso: createKapsoAdapter({
      kapsoApiKey: process.env.KAPSO_API_KEY!,
      phoneNumberId: process.env.KAPSO_PHONE_NUMBER_ID!,
      webhookSecret: process.env.KAPSO_WEBHOOK_SECRET!,
    }),
  },
  state: createMemoryState(),
});

bot.onNewMention(async (thread: Thread, message: Message) => {
  await thread.subscribe();
  await send(message.text, { thread });
});

bot.onSubscribedMessage(async (thread: Thread, message: Message) => {
  await send(message.text, { thread });
});

export default channel;
```

See the [Kapso adapter documentation](https://chat-sdk.dev/adapters/vendor-official/kapso) for supported events, capabilities, and credentials.

## Configure

Connect a WhatsApp number in Kapso, set `KAPSO_API_KEY`, `KAPSO_PHONE_NUMBER_ID`, and `KAPSO_WEBHOOK_SECRET`, then point the Kapso webhook at `/eve/v1/kapso`. Use this provider-managed option when you do not want to integrate directly with the WhatsApp Cloud API. See the [Chat SDK channel docs](/docs/channels/chat-sdk) for eve session dispatch, state, streaming, and human-in-the-loop behavior.

[Read the full channel documentation](/docs/channels/chat-sdk)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)