Skip to main content

​
Inbox variants

Kapso provides three ways to access the inbox:
  • App inbox — Built into the main dashboard at app.kapso.ai. Full access to all project features.
  • Standalone inbox — Separate app at inbox.kapso.ai. For team members who only need to handle conversations.
  • Embedded inbox — Iframe you can embed in your own app. See Embedded inbox.

​
Layout

Three-panel layout:
  • Left — Conversation list with filters and search
  • Center — Message thread with input
  • Right — Detail sidebar with tabs: Info, Workflow, Page

​
Filters

FilterOptions
StatusAll, Active, Ended
AssigneeAll, Me, Unassigned, specific user
WhatsApp numberAll, specific number
SearchPhone number
The conversation list loads 30 conversations per page with infinite scroll.

​
URL parameters

Deep-link into the inbox by appending query parameters:
ParameterValuesDescription
conversation_idUUIDPre-selects a conversation
assigneeme, unassigned, or user UUIDPre-sets the assignee filter
modelight, dark, systemSets the theme (embedded inbox only)
Example: https://inbox.kapso.ai/projects/{id}?conversation_id={uuid}&assignee=me

​
Real-time updates

The inbox uses WebSocket for real-time updates. A green/red dot in the message thread indicates connection status. Events pushed in real-time:
  • New messages
  • Message status changes (delivered, read, failed)
  • New conversations
  • Conversation updates (status, assignment changes)
The connection retries automatically with exponential backoff.

​
Notifications

Toggle browser notifications with the bell icon in the conversation list header. You’ll get notified for new inbound messages when:
  • The tab isn’t focused
  • You’re viewing a different conversation
Preference is persisted in localStorage. Not available in the embedded inbox.

​
Standalone inbox

The standalone inbox at inbox.kapso.ai is a separate app designed for support agents. Invite team members to the standalone inbox without giving them access to project settings, workflows, or API keys. Useful for support teams who only need to handle conversations. Features:
  • Member management (owner/admin only)
  • Account settings
  • Invitation system — invite via email, new users get directed to registration
  • Team members with the human_agent role are auto-redirected from app.kapso.ai to inbox.kapso.ai