Memz — Agent Memory Bank

Source

# Chat SDK > Build chatbots that work across Instagram, Facebook, Telegram, WhatsApp, Twitter/X, Bluesky, and Reddit through a single Chat SDK adapter. Source: Zernio API Documentation (https://docs.zernio.com) API Base URL: https://zernio.com/api/v1 --- # Chat SDK Build chatbots that work across Instagram, Facebook, Telegram, WhatsApp, Twitter/X, Bluesky, and Reddit through a single Chat SDK adapter. import { Callout } from 'fumadocs-ui/components/callout'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; import { Step, Steps } from 'fumadocs-ui/components/steps'; [Chat SDK](https://chat-sdk.dev) is Vercel's unified TypeScript framework for building chatbots across messaging platforms. The `@zernio/chat-sdk-adapter` is the **vendor official** Zernio adapter, [listed on chat-sdk.dev](https://chat-sdk.dev/adapters/zernio), letting you build a single chatbot that works across all Zernio-supported messaging platforms. ## Why use this? Even if Chat SDK shipped native adapters for every social platform, you'd still need to apply to Meta's developer program, go through App Review, get WhatsApp Business verification, apply for X elevated API access, register a Reddit OAuth app, and set up a Telegram bot. That's 6+ developer programs, review processes, OAuth app configurations, and ongoing token refresh management. Zernio handles all of that. Your users connect their accounts through OAuth in the Zernio dashboard, and you get a single API key. No developer program applications, no app reviews, no token management. | Without Zernio | With Zernio | |---|---| | Apply to 6+ developer programs | Connect accounts in a dashboard | | Go through platform App Reviews | No reviews needed | | Build 7 OAuth app configurations | 1 API key | | Manage token refresh per platform | Zernio handles token lifecycle | | 7 webhook endpoints to maintain | 1 webhook endpoint | | Platform-specific error handling | Unified error responses | ## Setup <Steps> <Step> ### Install the adapter ```bash npm install @zernio/chat-sdk-adapter chat @chat-adapter/state-memory ``` <Callout type="info"> For production, swap `@chat-adapter/state-memory` for a persistent state adapter like `@chat-adapter/state-redis` or `@chat-adapter/state-pg`. See [State Adapters](https://chat-sdk.dev/docs/state) for all options. </Callout> </Step> <Step> ### Configure environment variables ```bash # Required: your Zernio API key (read-write) ZERNIO_API_KEY=your_api_key # Recommended: webhook secret for signature verification ZERNIO_WEBHOOK_SECRET=your_webhook_secret ``` Get your API key from [zernio.com/dashboard/api-keys](https://zernio.com/dashboard/api-keys). Make sure the key has **read-write** permissions. </Step> <Step> ### Create your bot ```typescript title="lib/bot.ts" import { Chat } from "chat"; import { createZernioAdapter } from "@zernio/chat-sdk-adapter"; import { createMemoryState } from "@chat-adapter/state-memory"; export const bot = new Chat({ userName: "pizza-bot", adapters: { zernio: createZernioAdapter(), }, state: createMemoryState(), }); // Register a handler for incoming messages (use /.*/ to match every message) bot.onNewMessage(/.*/, async (thread, message) => { const platform = (message.raw as any).platform; await thread.post(`Hello from ${platform}!`); }); ``` </Step> <Step> ### Add a webhook route <Tabs items={['Next.js App Router', 'Express']}> <Tab value="Next.js App Router"> ```typescript title="app/api/chat-webhook/route.ts" import { bot } from "@/lib/bot"; export async function POST(request: Request) { return bot.webhooks.zernio(request); } ``` </Tab> <Tab value="Express"> ```typescript title="server.ts" import express from "express"; import { bot } from "./lib/bot"; const app = express(); app.post("/api/chat-webhook", async (req, res) => { const response = await bot.webhooks.zernio(req); res.status(response.status).send(await response.text()); }); ``` </Tab> </Tabs> </Step> <Step> ### Configure your Zernio webhook In the [Zernio dashboard](https://zernio.com/dashboard/webhooks), create a webhook: - **URL**: `https://your-app.com/api/chat-webhook` - **Events**: Select `message.received` and `comment.received` - **Secret**: Set a strong secret (same as `ZERNIO_WEBHOOK_SECRET`) </Step> </Steps> ## Configuration The adapter auto-detects credentials from environment variables. You can also pass them explicitly: ```typescript const adapter = createZernioAdapter({ apiKey: "your-api-key", webhookSecret: "your-webhook-secret", baseUrl: "https://zernio.com/api", // default botName: "My Bot", // default: "Zernio Bot" }); ``` | Env Variable | Config Key | Required | Description | |---|---|---|---| | `ZERNIO_API_KEY` | `apiKey` | Yes | API key for sending messages | | `ZERNIO_WEBHOOK_SECRET` | `webhookSecret` | Recommended | HMAC-SHA256 secret for webhook verification | | `ZERNIO_API_BASE_URL` | `baseUrl` | No | Override API base URL | | `ZERNIO_BOT_NAME` | `botName` | No | Bot display name | ## Accessing platform data Every message includes the raw Zernio payload, so you can access platform-specific data: ```typescript bot.onNewMessage(/.*/, async (thread, message) => { const raw = message.raw as any; // Which platform sent this message console.log(raw.platform); // "instagram" | "facebook" | "telegram" | ... // Instagram-specific sender info if (raw.sender.instagramProfile) { console.log(raw.sender.instagramProfile.followerCount); console.log(raw.sender.instagramProfile.isVerified); } // WhatsApp phone number if (raw.sender.phoneNumber) { console.log(raw.sender.phoneNumber); } // Attachments (images, videos, etc.) for (const att of raw.attachments) { console.log(att.type, att.url); } }); ``` ## Supported features | Feature | Supported | Notes | |---|---|---| | Send messages | Yes | Text across all platforms | | Rich messages (cards) | Yes | Buttons and templates on FB, IG, Telegram, WhatsApp | | Edit messages | Partial | Telegram only | | Delete messages | Partial | Telegram, X (full); Bluesky, Reddit (self-only) | | Reactions | Partial | Telegram and WhatsApp | | Typing indicators | Partial | Facebook Messenger and Telegram | | AI streaming | Partial | Post+edit on Telegram; single post on others | | File attachments | Yes | Via media upload endpoint | | Fetch messages | Yes | Full conversation history | | Fetch thread info | Yes | Participant details, platform, status | | Webhook verification | Yes | HMAC-SHA256 | | Comment webhooks | Yes | `comment.received` routed through handlers | ## API client The adapter exports a standalone API client for direct Zernio API calls beyond what Chat SDK covers: ```typescript import { ZernioApiClient } from "@zernio/chat-sdk-adapter"; const client = new ZernioApiClient("your-api-key", "https://zernio.com/api"); // List conversations const { data, pagination } = await client.listConversations({ platform: "instagram", status: "active", limit: 20, }); // Send a message with an attachment await client.sendMessage(conversationId, { accountId: "acc-123", message: "Check this out!", attachmentUrl: "https://example.com/image.jpg", attachmentType: "image", }); ``` ## Prerequisites - A [Zernio API key](https://zernio.com/dashboard/api-keys) with read-write permissions - At least one [connected social account](/guides/connecting-accounts) - Inbox features available on your Zernio account (included with the [Usage plan](/pricing); AppSumo users need the Inbox add-on) - Node.js 20+ (for native `fetch` and `crypto` support) <Callout type="info"> Inbox features (including `message.received` webhooks) are bundled with every paid account on the Usage plan. AppSumo users need the Inbox add-on; contact support if you need to enable it. </Callout> ## Resources - [GitHub repository](https://github.com/zernio-dev/chat-sdk-adapter) - [npm package](https://www.npmjs.com/package/@zernio/chat-sdk-adapter) - [Chat SDK documentation](https://chat-sdk.dev) - [Zernio Webhook API](/webhooks) - [Zernio Inbox API](/messages/list-inbox-conversations)

Timeline