Free & open source ยท AGPL-3.0

ChatDesk: open-source WhatsApp Cloud API inbox, built by Yoorie

A self-hosted shared inbox for your whole team. Chat with customers, send template campaigns and run chatbots from your own server, with your own Meta app. No lock-in, no per-message markup.

ChatDesk shared team inbox showing a customer conversation

Everything your team needs to talk to customers

One install, one business, as many team users and agents as you need. Your data stays on your server.

๐Ÿ’ฌ

Shared team inbox

Every message type, agent assignment, internal notes, quick replies and real-time updates.

๐Ÿ“ฃ

Campaigns

Send approved templates to lists, tags or segments. Schedule, pause, retry and track reads.

๐Ÿค–

Chatbots

Keyword triggers, welcome and away messages, and a visual flow builder with human hand-off.

๐Ÿงพ

Templates

Sync, create and submit message templates, then track approval status and quality.

๐Ÿ‘ฅ

Contacts & team

Import contacts, tag and segment them, and invite agents with roles from a simple Team page.

๐Ÿ”Œ

Your own connection

Connect your number manually with a step-by-step guide. You talk to the Cloud API directly.

An inbox built for teams

Text, images, video, voice notes, documents, stickers, locations, reactions, buttons and lists, all in one tidy conversation view.

  • Assign chats and leave internal notes
  • 24-hour service window handling
  • Works on shared hosting with a polling fallback
Shared inbox

Campaigns that respect your customers

Broadcast approved templates to the right audience, test first and follow delivery and read stats per recipient.

  • Schedule, pause and resume
  • Retry failed messages
  • STOP / START opt-outs handled automatically
Campaign builder

Chatbots without code

Design conversations with buttons, lists and conditions in a visual flow builder, then hand off to a human when it matters.

  • Keyword triggers
  • Welcome and away messages
  • Pause the bot per chat
Chatbot flow builder

Contacts and templates in one place

Import, tag and segment your audience, and manage your message templates from sync to approval.

Contacts

Clear numbers at a glance

A dashboard and campaign stats that show what is sent, delivered and read.

Dashboard

Connect your number your way

Paste your phone number ID, business account ID and permanent token. The built-in guide walks you through the Meta app and webhook setup.

Connection settings

Why we made ChatDesk open source

We'll be honest with you. We built ChatDesk to sell it. We spent months on the inbox, the campaigns and the chatbots, and we were proud of the result.

But the closer we got, the more one thought kept coming back. Talking to customers on WhatsApp is not a luxury feature anymore. It is how small shops, clinics, schools and start-ups run their day. A tool that sits in the middle of those conversations should be something you can see inside, run yourself and truly own.

So we decided to give it away. The whole thing, on GitHub, for anyone to use.

Now any business or developer can run a transparent, self-hosted WhatsApp inbox with no lock-in and no markup on every message. You pay Meta's own prices and nothing more. And every fix, idea and pull request from the community makes ChatDesk better for everyone who uses it.

๐Ÿ”

Transparent

Every line is open. Read it, audit it and know exactly what happens to your customers' messages.

๐Ÿ 

Yours to own

Your server, your database, your Meta app. No vendor can switch you off or raise your price.

๐ŸŒฑ

Better together

Built in the open so developers everywhere can improve it, translate it and extend it.

โ˜… Star ChatDesk on GitHub

Up and running in minutes

Runs on any PHP 8.2+ host with MySQL, from a VPS to shared hosting.

  1. Clone the repo and copy .env.example to .env
  2. Install dependencies and run the migrations, or use the web installer at /install/
  3. Register: the first account becomes the admin
  4. Follow the connect your number guide

Needs PHP 8.2+, MySQL 5.7+ or MariaDB 10.3+, Composer 2, Node.js 20+ to build, HTTPS and a cron job.

git clone https://github.com/yoorie/chatdesk.git
cd chatdesk
cp .env.example .env
composer install --no-dev --optimize-autoloader
npm ci && npm run build
php artisan key:generate
php artisan migrate --seed
php artisan storage:link

Open source or Zyptos?

ChatDesk is perfect for one business running its own inbox. Need to serve many clients as a SaaS? Zyptos is the premium version of ChatDesk.

FeatureChatDesk
Open source
Zyptos
Premium
Shared team inbox, all message typesโœ“โœ“
Team users and agentsโœ“โœ“
Contacts, tags and segmentsโœ“โœ“
Templates, campaigns and chatbotsโœ“โœ“
Self-hosted on your own serverโœ“โœ“
Multi-tenant SaaS (many businesses)โ€“โœ“
Billing, subscription plans and paymentsโ€“โœ“
Super-admin panel and managementโ€“โœ“
Advanced features and integrationsโ€“โœ“
Priority supportCommunityโœ“
PriceFreePaid

Custom features on demand, by Yoorie

Need a CRM integration, a payment flow, a new chatbot action or your own branding? The team that built ChatDesk can extend it, improve it and build exactly what your business needs.

Tell us what you need

Frequently asked questions

Is ChatDesk really free?

Yes. ChatDesk is released under the AGPL-3.0 licence. You can use it, change it and run it for your business at no cost. You only pay Meta for the conversations you send, at Meta's own rates.

What do I need to run it?

A PHP 8.2+ host with MySQL or MariaDB, HTTPS on a public domain and a cron job. A Meta developer app and a WhatsApp Business phone number connected to the Cloud API.

Can I use it on shared hosting?

Yes. Build it locally, upload the folder, point your domain to public/ and use the web installer. Real-time updates fall back to polling when Pusher isn't configured.

Can I run it for several clients as a SaaS?

The open-source edition is built for one organisation per install. For multi-tenant SaaS with plans and billing, use Zyptos, the premium version of ChatDesk.

What does AGPL-3.0 mean for me?

You're free to use and modify ChatDesk. If you offer a modified version to others over a network, you must share your changes under the same licence. Running it for your own business is simple and free.

Can Yoorie install it or add features for me?

Yes. Yoorie offers installation, setup and custom development on demand. Write to hello@yoorie.com.

How can I contribute?

Star the repo, report issues and open pull requests on GitHub. Translations and docs improvements are very welcome.