Skip to content

Getting started ​

From the zip to your first WhatsApp conversation in about an hour. Most of that time is spent at Meta, not in Desorix.

The Desorix inbox: a conversation that started from the website widget

What you need ​

  • Hosting: PHP 8.3 or newer, MySQL 8 or MariaDB 10.6+, one cron job, and HTTPS. Ordinary cPanel hosting is fine. See Requirements.
  • A domain or subdomain for Desorix, for example chat.example.com.
  • A phone number for WhatsApp that isn't in use on the WhatsApp or WhatsApp Business app. If it is, delete that WhatsApp account in the app first.
  • A Meta Business account (free) and a payment method for Meta's message charges.
  • Optional: an Anthropic or OpenAI API key for the AI assistant.

The steps ​

StepWhereTimeGuide
1. Install DesorixcPanel and your browser15 minInstall on cPanel
2. Add the cron jobcPanel2 minInstall on cPanel → cron
3. Create the Meta app, number and permanent tokenMeta30 minConnect WhatsApp
4. Connect the number in DesorixDesorix → WhatsApp → Connect WhatsApp5 minConnect WhatsApp
5. Invite your teamTeam → Invite member2 minUser guide
6. Create or sync templatesTemplates5 min, plus Meta's reviewUser guide

Then send a message from your own phone to the business number: it appears in the Inbox within seconds.

Ideas worth knowing first ​

  • Workspaces keep teams and their data apart. Each workspace has its own numbers, contacts, templates and settings. One person can belong to several.
  • Roles:
    • Owner and admin: run the workspace.
    • Agent: answers chats.
    • Viewer: sees reports.
    • Platform administrator: looks after the whole install under Administration.
  • The 24-hour window: you can reply freely for 24 hours after the customer's last message. After that, or to start a conversation, WhatsApp only allows an approved template. The inbox shows the countdown and switches to templates by itself.
  • Costs: Meta charges your WhatsApp Business Account per delivered message, by category (marketing, utility, authentication, service) and country. Desorix records an estimate for every outgoing message and the final cost when Meta reports it. See Costs and alerts.

Next ​