Communications Hub¶
Overview¶
Cross-channel communication center — unifies telephony, WhatsApp, Telegram, WebRTC and web chat in a single room. Automatic speech↔text conversion.
┌─────────────────────────────────────────┐
│ Unified Communication Room │
│ │
│ 👤 Agent (Web-Chat) — types + listens │
│ 📞 Customer (SIP) — speaks, listens │
│ 💬 Partner (WhatsApp) — types │
│ ✈️ Colleague (Telegram) — types │
│ │
│ Routing Engine: │
│ Speech → STT → Text for all │
│ Text → TTS → Audio for SIP │
└─────────────────────────────────────────┘
Features¶
Unified Communication Rooms¶
Create a room with participants from different channels:
- "+" button in the conversations sidebar
- Enter subject
- Add participants: choose channel + enter number/ID
- For SIP: "Call" checkbox → phone rings immediately
- For WhatsApp/Telegram: invitation message sent automatically
Channels¶
| Channel | Native | Conversion |
|---|---|---|
| SIP (Phone) | Speech | STT → Text for chat, TTS ← Text from chat |
| Text + Voice | Voice → STT → Text | |
| Telegram | Text + Voice | Voice → STT → Text |
| WebRTC | Video + Audio | Browser-based via LiveKit |
| Web-Chat | Text | Direct via WebSocket |
| Matrix | Text + Media | Via mautrix bridges |
Conversation Management¶
- Priority: Low / Normal / High / Urgent
- Agent assignment: Dropdown in info sidebar
- Invite participants later: Info sidebar → "Invite"
- Delete: Removes conversation + messages + participants
Voice Integration¶
- Incoming SIP call → Conversation created automatically
- Outgoing call → "Call" button calls customer
- Real-time transcription: Whisper STT converts speech to text
- Text-to-Speech: Piper TTS reads chat replies to caller
Access¶
- URL:
https://platform.xynap.tech/app/communications - Permission:
support.read - Roles: Platform Admin, Reseller
Link WhatsApp¶
Link your own WhatsApp account via the platform UI:
- Settings → Security → WhatsApp → "Link"
- Scan QR code with WhatsApp → Linked Devices → Link a Device
- Status shows as "Connected"
Uses mautrix-whatsapp (Provisioning API v3) — multi-user capable.