๐ Introduction
What is PulseHub?โ
PulseHub is a self-hosted, open-source omnichannel customer communication platform. It gives your business a single unified inbox where messages from every channel โ WhatsApp, SMS, Email, Telegram, Viber, Instagram, Facebook Messenger, and your own website's chat widget โ arrive together, are routed intelligently, and can be replied to without ever switching apps.
Think of it as the self-hosted equivalent of Intercom or Zendesk, but one you download, install on your own server, and fully control. Your data never leaves your infrastructure.
Why Self-Hosted?โ
| Concern | SaaS Platforms | PulseHub |
|---|---|---|
| Data ownership | Provider holds all data | 100% your server, your DB |
| Cost at scale | Per-seat/per-message pricing | One-time setup, no per-message fees |
| Customisation | Limited to what vendor allows | Full source code access |
| Compliance (GDPR, HIPAA) | Vendor-dependent | You control every byte |
| Vendor lock-in | High | None โ export/migrate anytime |
What Can PulseHub Do?โ
Unified Inboxโ
All inbound messages โ regardless of channel โ appear in a single chronological conversation view. Agents never need to log into WhatsApp Business separately, check a different tab for emails, or miss a Telegram message.
Multi-Channel Supportโ
PulseHub connects natively to:
- WhatsApp via the official Meta Cloud API
- SMS via Twilio (send and receive)
- Email via IMAP (receive) and SMTP (send)
- Telegram via the Bot API
- Viber via the Viber REST API
- Instagram Messenger via Meta's Graph API
- Facebook Messenger via Meta's Graph API
- Web Chat Widget โ an embeddable JavaScript snippet for any website
Automation Engineโ
Create rule-based workflows that fire when events happen:
- A new message arrives โ automatically add a tag, assign to an agent, or send a canned reply
- A conversation is created โ set its status or notify a team
- A contact is created โ tag them by source channel
Analyticsโ
Track team performance and message volume with built-in dashboards: total conversations, resolution rate, average first response time, and a breakdown of messages per channel.
AI Suggestionsโ
Connect your OpenAI API key and get one-click AI-drafted reply suggestions inside any conversation thread, based on the full conversation history.
Role-Based Accessโ
Admins manage workspace settings, channels, automations, and agents. Agents can only read conversations and send messages โ they cannot change configuration.
Project Philosophyโ
- No magic, no framework. Every file is readable PHP. A developer can understand the full codebase in an afternoon.
- Runs anywhere PHP runs. Shared hosting, VPS, dedicated server, Docker โ if PHP + MySQL is available, PulseHub runs.
- Secure by default. Passwords are bcrypt-hashed, webhook signatures are verified, sensitive directories are blocked, sessions are hardened.
- Extensible. Because there's no framework lock-in, you can add your own routes, modify views, and extend the database schema without fighting an abstraction layer.