Messaging For Zergs

SMS, WhatsApp, and voice-ready routing behind one control plane.

zmsg gives Zergs a real messaging surface. It wraps providers like Twilio and Telnyx, supports session-backed channels like WhatsApp Web, owns sender registration and routing, stores conversations, handles inbound delivery, and gives operators a control panel instead of raw provider consoles.

Native Chat Owned first-party messaging for Zergs with no provider dependency on the core path.
Providers Twilio, Telnyx, WhatsApp Web, and future adapters behind one surface.
Channels Native chat, SMS, MMS, WhatsApp, Telegram, with voice staged next.
Control Senders, conversations, routing, delivery state, and agent ownership.
Bridges Zerg modules talk to zmsg, not directly to provider SDKs.

What zmsg owns

  • First-party messaging Native `zmsg` chat identities let humans talk to Zergs without waiting on telecom or chat-provider setup.
  • Sender lifecycle Register, assign, and monitor provider-backed identities or QR-linked sessions for each agent.
  • Conversation state Keep inbound and outbound history in one place so Zergs can reason over threads.
  • Inbound delivery Terminate provider webhooks once and route structured events into agent workflows.
  • Operator tooling Use /admin to inspect senders, traffic, and routing health.

For Personal OS

  • Use zmsg_bridge Personal OS should talk to zmsg as the messaging gateway, not to Twilio directly.
  • Bootstrap with QR Use the WhatsApp Web sender flow in /admin/whatsapp-web when you want a lightweight, non-business Personal OS chat channel.
  • Async by design External messages arrive on their own time and bubble into the module event system.

API Surface

  • https://api.zmsg.io/senders/register Register provider senders to agents.
  • https://api.zmsg.io/send Queue outbound traffic through the control plane.
  • https://api.zmsg.io/messages Inspect message state and recent history.

Control Surfaces

  • /admin Dashboard, senders, messages, conversations, and settings.
  • https://api.zmsg.io/docs Provider/admin API docs.
  • https://api.zmsg.io/health Live service health for automation and ops.