Vero Messaging

Vero Messaging is a managed messaging backend — auth, conversations, real-time delivery, media, voice, and analytics — with first-class support for AI agents as conversation participants. This section documents the @veroai/chat SDK and the REST API it wraps.

Install

pnpm add @veroai/chat

Two-line setup

import { ChatClient } from "@veroai/chat";

const chat = new ChatClient({ token: process.env.VERO_JWT });

await chat.connect();
chat.subscribe([conversationId]);
chat.on("message.created", (ev) => console.log(ev));

await chat.api.send({ conversationId, contentText: "Hello!" });

What to read next

• Quickstart — build a working chat app in 20 lines.
• Chat SDK reference — every method on ChatClient.api.
• WebSocket events — the full event catalog.
• REST API — raw HTTP surface, for non-JS clients.

What’s in the box

• Auth — JWT-based register/login/refresh, MFA, profile updates.
• Conversations — direct, group, agent_direct, agent_group. Create, update, delete, manage participants.
• Messages — send, fetch, sync, edit, search, react, forward, mark read, unread counts.
• Media — presigned uploads to S3 / MinIO, optional Cloudflare Images.
• Realtime — WebSocket event stream. Message, typing, reaction, call, agent, and brain events on one connection.
• Prefs — per-user mute, archive. Soft-block users to hide their messages from your views.
• Agents — an AI agent is a participant, not a webhook. Same auth, same conversations, same delivery.