WP Manifestindependent plugin directory
manifest / email / darins-shared-inbox

WP WhatsApp Inbox

A WhatsApp-style inbox for WordPress Admin powered by Meta WhatsApp Cloud API.

by WP WhatsApp Inbox · github.com/mohamedashraf19961996-arch/darins-shared-inbox

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/mohamedashraf19961996-arch/darins-shared-inbox/archive/refs/heads/main.zip
Readme github.com/mohamedashraf19961996-arch/darins-shared-inbox ↗

WP WhatsApp Inbox adds a WordPress admin workspace for teams that manage conversations through the Meta WhatsApp Cloud API.

What it includes

  • Shared WhatsApp inbox inside WordPress Admin.
  • Team assignment with status and priority controls.
  • Internal notes for conversation handoff and context.
  • Tags for conversation organization.
  • Contact management with profile, edit, archive, and restore flows.
  • Media message support for images, documents, and audio.
  • Settings, logs, and operational admin pages.
  • Settings import/export for safe configuration portability.
  • Health dashboard plus queue, webhook, and conversation diagnostics.

Requirements

  • WordPress 6.0 or newer.
  • PHP 8.0 or newer.
  • A Meta WhatsApp Cloud API app, phone number ID, and access token.

Installation

  1. Upload or copy wp-whatsapp-inbox to wp-content/plugins/.
  2. Activate WP WhatsApp Inbox from the WordPress Plugins screen.
  3. Open WhatsApp Inbox > Settings.
  4. Follow the setup checklist shown at the top of the settings page.
  5. Enter your Meta access token, phone number ID, API version, webhook verify token, and app secret if you use signature validation.
  6. Copy the webhook URL shown in settings and configure it in the Meta Developer Dashboard.
  7. Use the settings import/export panel if you need to move safe configuration values between sites.

Initial setup

  1. Connect WhatsApp provider credentials.
  2. Configure the webhook verify token.
  3. Copy the webhook callback URL into Meta.
  4. Save settings.
  5. Test webhook verification.
  6. Test an inbound WhatsApp message.
  7. Test an outbound message from the settings page.
  8. Open WhatsApp Inbox > System Health to review queue, webhook, and database readiness.

Admin areas

  • Inbox: shared conversation workspace with replies, media, assignment, status, priority, notes, tags, and contacts.
  • System Health: health dashboard, queue inspector, webhook inspector, and conversation diagnostics.
  • Settings: connection settings, webhook tools, readiness checks, and test messaging.
  • Settings: connection settings, webhook tools, readiness checks, test messaging, and safe import/export.
  • Logs: operational log viewer for troubleshooting.

Privacy and data notes

  • This plugin stores WhatsApp conversations, contacts, attachments, logs, queue jobs, and webhook events in WordPress database tables created by the plugin.
  • Access tokens and app secrets are stored in WordPress options and are not rendered back into admin HTML.
  • Settings export/import only includes safe configuration values. Conversations, contacts, logs, queue jobs, webhook events, and secrets are excluded.
  • Public webhook endpoints are intentionally available to Meta and should be protected with HTTPS and signature validation in production.
  • Site owners are responsible for configuring retention, access policies, and legal disclosures appropriate to their organization.

More help