Skip to Content
Catalog / COM · Communication / AlShayebCo WhatsApp Connector
AlShayebCo WhatsApp Connector
ac_whatsapp_connector

AlShayebCo WhatsApp Connector

WhatsApp for Odoo: templates, media, two-way chat and automatic notifications — no enterprise license required

v19.0.2.0.0 AlShayeb Partners Communication Application

Adds models wa.account (multi-provider BSP config with provider/state machine and webhook token), wa.template + wa.template.variable (field-bound or free-text variables, Cloud-API component builder, remote sync), and wa.message (direction + status state machine, idempotent _send). A WhatsApp tools layer (tools/wa_api.py) abstracts Meta/360dialog/generic Cloud API vs Whapi.Cloud send and request paths. discuss channel is inherited for one channel per account+number with message_post override turning agent replies into outbound sends; contact, sales order, and journal entry gain a Send-WhatsApp action opening the wa.composer wizard. A public /ac_whatsapp/webhook controller handles the Meta verify handshake, Meta/360dialog entry/changes payloads, and flat Whapi payloads (secret-header auth). Does not depend on Odoo enterprise whatsapp.

Overview

Businesses want to reach customers on WhatsApp without paying for Odoo's enterprise WhatsApp module or being locked to a single gateway. This self-owned connector lets you wire up Meta Cloud API, 360dialog, a generic Cloud-API provider, or Whapi.Cloud (a real connected number with free-text messaging), then send approved templates or plain text and hold full two-way conversations inside the Discuss inbox. Incoming replies and delivery/read receipts arrive automatically through a webhook, and template variables can be auto-filled from any Odoo record so quotes and invoices go out personalised in one click.

Workflow

Wa Message

In Queue
Sent
Delivered
Read
Received
Failed

Wa Account

Not Connected
Connected

Wa Template

Draft
Pending
Approved
Rejected

Key Features

  • Connect WhatsApp through Meta Cloud API, 360dialog, a generic Cloud-API gateway, or Whapi.Cloud, each with one-click Test Connection.
  • Build templates the Odoo way: {{n}} placeholders create their own variables, bind each to a field, free text, the user, a portal link or an internal record link, with a live WhatsApp preview (bold/italic markup, RTL for Arabic).
  • Hold two-way conversations in the Discuss inbox: inbound replies and agent answers flow through one channel per contact and number.
  • Reliable delivery: messages are queued and sent by a cron with retry, a clear failure reason, and a live status timeline of Queued, Sent, Delivered, Read or Failed.
  • Attach the real document: give a template a Report and the rendered PDF is sent with the message. Send images, documents and voice notes both ways.
  • Sync the approved template catalogue straight from Meta or 360dialog so only sendable templates appear to agents.
  • Send WhatsApp from any record — add "Send WhatsApp" to the Action menu of any model (contacts, sales orders, invoices, tickets, tasks) in one click, with no extra apps required.
  • Route inbound webhooks safely: Meta signatures are verified with your App Secret (X-Hub-Signature-256), other gateways with a per-account secret header, and unauthenticated or unmatched requests are rejected outright. Optional raw API debug logging.
  • Automatic notifications: switch on per-event messages (order confirmed, invoice posted, delivery validated, payment registered, ticket or task done) in the customer's language, sent safely outside the business transaction.
  • WhatsApp-Web gateways (Whapi.Cloud, WaSenderAPI) drive a real connected number for free-text messaging with no template approval, including encrypted media.

Technical Details

Technical Name ac_whatsapp_connector
Version 19.0.2.0.0
License LGPL-3
Domain COM · Communication

Menu Structure

WhatsApp
Messages
Configuration
Accounts
Templates

Security

Two privilege levels: a WhatsApp User can read accounts and templates and send, receive, and converse on messages, while a WhatsApp Administrator additionally configures accounts, manages templates, and sees sensitive credentials (API token, base URL, webhook token, which are hidden from regular users). Global multi-company record rules scope accounts and messages to the user's companies.

WhatsApp / User WhatsApp / Administrator

Dependencies

mail phone_validation base_automation

External Dependencies

requests