Chat SDK

npm install chat @kapso/chat-adapter @chat-adapter/state-memory

import { Chat } from 'chat';
import { createMemoryState } from '@chat-adapter/state-memory';
import { createKapsoAdapter } from '@kapso/chat-adapter';

export const bot = new Chat({
  userName: 'support',
  state: createMemoryState(),
  adapters: {
    kapso: createKapsoAdapter(),
  },
});

bot.onDirectMessage(async (thread, message) => {
  await thread.post(`You said: ${message.text}`);
});

KAPSO_API_KEY=your_project_api_key
KAPSO_PHONE_NUMBER_ID=your_phone_number_id
KAPSO_WEBHOOK_SECRET=your_webhook_secret

createKapsoAdapter({
  kapsoApiKey: process.env.KAPSO_API_KEY,
  phoneNumberId: process.env.KAPSO_PHONE_NUMBER_ID,
  webhookSecret: process.env.KAPSO_WEBHOOK_SECRET,
});

import { bot } from '@/lib/bot';

export async function POST(request: Request): Promise<Response> {
  return bot.webhooks.kapso(request);
}

bot.onDirectMessage(async (thread, message) => {
  await thread.post({
    markdown: `Received: **${message.text}**`,
  });
});

import type { KapsoAdapter } from '@kapso/chat-adapter';

const adapter = bot.getAdapter('kapso') as KapsoAdapter;
const threadId = await adapter.openDM('15551234567');
const thread = bot.thread(threadId);

await thread.post('Hello from Kapso.');

import { Actions, Button, Card } from 'chat';

await thread.post(
  Card({
    title: 'Approve refund?',
    children: [
      Actions([
        Button({ id: 'approve', label: 'Approve', value: 'refund-123' }),
        Button({ id: 'reject', label: 'Reject', value: 'refund-123' }),
      ]),
    ],
  }),
);

bot.onAction('approve', async (action) => {
  await action.thread?.post(`Approved ${action.value}`);
});

await thread.post({
  markdown: 'Here is the receipt.',
  files: [
    {
      filename: 'receipt.pdf',
      mimeType: 'application/pdf',
      data: await fs.promises.readFile('receipt.pdf'),
    },
  ],
});

const page = await thread.adapter.fetchMessages(thread.id, { limit: 20 });