Documentation

Install, configure & go live

Full guides ship with your purchase. Preview the essentials below — buyers get the complete PDF + video walkthrough after login.

Server requirements

Waify runs on any standard PHP hosting with the following minimum specs:

  • PHP 8.2+ with extensions: BCMath, Ctype, cURL, DOM, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML
  • MySQL 8.0+ or MariaDB 10.6+
  • Composer 2.x
  • Node.js 18+ & npm (for building frontend assets)
  • SSL certificate (required for WhatsApp webhooks)
  • Cron job access for queues & scheduled tasks

Installation

After purchase, download the package from your account and upload to your server:

composer install --no-dev cp .env.example .env php artisan key:generate php artisan migrate --seed npm install && npm run build php artisan queue:work

Extended license buyers can request free installation — contact support.

WhatsApp Cloud API

Connect via Meta Business Manager. You'll need a Meta App, WhatsApp Business Account, and a verified phone number. Configure in Settings → Connections → Embedded Signup.

Set your webhook URL to https://yourdomain.com/api/webhook/whatsapp and verify token from .env.

Billing setup

Enable Stripe, Razorpay, or PayPal in Super Admin → Billing. Each workspace subscribes to a plan you define. Manual payment option supports bank transfers.

AI configuration

Add your OpenAI or Google Gemini API keys in Super Admin → AI Settings. Workspaces can override with their own keys or use platform defaults.

Production deployment

Recommended stack: Ubuntu 22.04, Nginx, PHP-FPM, Redis for queues, Supervisor for queue:work and Laravel Echo with Pusher for real-time inbox.

REST API

Authenticate with workspace API tokens. Example:

GET /api/v1/contacts Authorization: Bearer {workspace_token} Content-Type: application/json

Full OpenAPI spec is included in the download package under /docs/api-reference.pdf.