How opencom-org/opencom works
Opencom is a multi-client customer messaging and engagement platform: support teams configure workspace content and campaigns in the web dashboard, while visitors use the web widget or mobile SDKs to chat, find help, and receive in-product guidance. Those clients use Convex backend functions for sessions and product data. The graph highlights the documented product stages and sampled runtime links; many backend features are represented by their exact module paths but their internal calls were not sampled, so those links are omitted rather than inferred.
Main entry points: app Web dashboard · Widget.tsx Embedded widget · main.tsx Widget bootstrap · inbox.tsx Admin mobile app
Components 28
Workspace administration
- Web dashboard
apps/web/src/app - Workspace settings
apps/web/src/app/settings/hooks/useSettingsPageController.ts - Outbound editor
apps/web/src/app/outbound/hooks/useOutboundMessageEditorController.ts - Help content admin
apps/web/src/app/articles - Conversation inbox
apps/web/src/app/inbox - Campaigns and series
apps/web/src/app/campaigns - Reports and segments
apps/web/src/app/reports
Visitor engagement
- Embedded widget
apps/widget/src/Widget.tsx - Widget bootstrap
apps/widget/src/main.tsx - Visitor sessions
apps/widget/src/hooks/useWidgetSession.ts - Tour runtime
apps/widget/src/tourOverlay/useTourOverlaySession.ts - Help center
apps/widget/src/components/HelpCenter.tsx - Visitor tickets
apps/widget/src/components/TicketCreate.tsx
Platform backend
- Series runtime
packages/convex/convex/series/runtime.ts - Conversations and tickets
packages/convex/convex/conversations.ts - Knowledge and imports
packages/convex/convex/helpCenterImports/syncPipeline.ts - Workspace and identity
packages/convex/convex/authConvex.ts - Campaigns and surveys
packages/convex/convex/outboundMessages.ts - Reporting
packages/convex/convex/reporting.ts - Convex data model
packages/convex/convex/schema.ts
Mobile SDKs
- Admin mobile app
apps/mobile/app/(app)/inbox.tsx - React Native SDK
packages/react-native-sdk/src/hooks/useConversations.ts - iOS SDK
packages/ios-sdk/Sources/OpencomSDK/Core/SessionManager.swift - Android SDK
packages/android-sdk/sdk/src/main/kotlin/com/opencom/sdk/core/SessionManager.kt
Other components
- Support agents
- Website visitors
- Convex service
- Resend email
Connections 32
- Support agents → Web dashboard: manage workspace
README.md - Web dashboard → Workspace settings: configure
README.md - Web dashboard → Outbound editor: edit messages
README.md - Web dashboard → Help content admin: manage articles
README.md - Web dashboard → Conversation inbox: reply to chats
README.md - Web dashboard → Campaigns and series: author campaigns
README.md - Web dashboard → Reports and segments: review metrics
README.md - Outbound editor → Workspace settings: load workspace
apps/web/src/app/outbound/hooks/useOutboundMessageEditorController.ts - Website visitors → Widget bootstrap: open widget
README.md - Widget bootstrap → Embedded widget: renders
apps/widget/src/main.tsx - Widget bootstrap → Convex service: provides client
apps/widget/src/main.tsx - Embedded widget → Visitor sessions: starts session
- Visitor sessions → Convex service: boots session
apps/widget/src/hooks/useWidgetSession.ts - Embedded widget → Tour runtime: runs tours
- Embedded widget → Help center: shows help
- Embedded widget → Visitor tickets: creates tickets
- Embedded widget → Convex service: loads product data
- Admin mobile app → Convex service: uses backend
- React Native SDK → Convex service: queries conversations
packages/react-native-sdk/src/hooks/useConversations.ts - React Native SDK → Convex service: submits surveys
- iOS SDK → Convex service: boots session
packages/ios-sdk/Sources/OpencomSDK/Core/SessionManager.swift - Android SDK → Convex service: calls API
packages/android-sdk/sdk/src/main/kotlin/com/opencom/sdk/core/SessionManager.kt - Web dashboard → Convex service: uses backend
- Admin mobile app → Convex service: uses backend
- Convex service → Convex data model: persists records
- Convex service → Conversations and tickets: serves conversations
- Convex service → Knowledge and imports: serves knowledge
- Convex service → Workspace and identity: handles identity
- Convex service → Campaigns and surveys: serves campaigns
- Convex service → Series runtime: runs sequences
- Convex service → Reporting: computes reports
- Convex service → Resend email: sends email