https://wiki.dolibarr.org/index.php?action=history&feed=atom&title=Module_WhatsApp_IAModule WhatsApp IA - Revision history2026-11-14T19:47:50ZRevision history for this page on the wikiMediaWiki 1.39.17https://wiki.dolibarr.org/index.php?title=Module_WhatsApp_IA&diff=69009&oldid=prevWeglob: New page: Module WhatsApp IA (Weglob module documentation)2026-11-12T16:15:50Z<p>New page: Module WhatsApp IA (Weglob module documentation)</p>
<p><b>New page</b></p><div><!-- BEGIN origin interlang links --><br />
<!-- You can edit this section but do NOT remove these comments<br />
Links below will be automatically replicated on translated pages by PolyglotBot --><br />
[[fr:Module_WhatsApp_IA_(FR)]]<br />
<!-- END interlang links --><br />
<br />
{{TemplateDocUser}}<br />
{{TemplateModuleInfo<br />
|modulename=WhatsAppIA<br />
|editor=Weglob<br />
|web=https://weglob.com<br />
|webbuy=https://www.dolistore.com<br />
|status=stable<br />
|prerequisites=Dolibarr 19.0+, PHP 7.4+, a Meta WhatsApp Business Cloud API number, HTTPS<br />
|minversion=19.0<br />
|note=Module ID 517300<br />
}}<br />
<br />
= Module WhatsApp IA =<br />
<br />
{| class="wikitable"<br />
! Name !! Value<br />
|-<br />
| Publisher || Weglob<br />
|-<br />
| Status || Stable<br />
|-<br />
| Version || 1.0.0<br />
|-<br />
| Module ID || 517300<br />
|-<br />
| Dolibarr compatibility || 19.0 and later<br />
|-<br />
| License || GPL v3 or later<br />
|-<br />
| Languages || English, French<br />
|}<br />
<br />
== Description ==<br />
'''WhatsApp IA''' connects Dolibarr to the official '''Meta WhatsApp Business Cloud API'''. Your team handles WhatsApp conversations directly inside Dolibarr, and an optional AI agent answers customers using your real ERP data (invoices, orders, products, stock).<br />
<br />
Messages are linked to third parties, so every exchange stays in the history of the customer or supplier.<br />
<br />
== Features ==<br />
* '''Shared inbox''' in Dolibarr: list of conversations, unread counters, reply from the browser.<br />
* '''Automatic link to third parties''' from the phone number.<br />
* '''Send documents''': send an invoice, proposal or order PDF in the chat from the Dolibarr card.<br />
* '''AI agent''' (optional): answers questions such as "what is my balance?", "where is my order?", using read-only tools on Dolibarr data.<br />
* '''Handoff to a human''': when the AI is not sure, it hands the conversation over and creates a task for the team.<br />
* '''Supplier invoices by WhatsApp''': a supplier or employee sends a photo or PDF, the module creates a draft supplier invoice.<br />
* '''AI log''': question, tools used, answer, outcome and estimated cost for each AI run.<br />
* '''WhatsApp usernames''' supported (contacts without a visible phone number).<br />
* Multi-company compatible (one WhatsApp number per entity).<br />
<br />
== Screenshots ==<br />
<gallery widths=400 heights=250><br />
File:WhatsAppIA_inbox.png|Inbox with the AI agent<br />
File:WhatsAppIA_send_invoice.png|Send an invoice PDF in the chat<br />
File:WhatsAppIA_supplier_invoice.png|Supplier invoice received by WhatsApp<br />
File:WhatsAppIA_ai_log.png|AI log<br />
</gallery><br />
<br />
== Prerequisites ==<br />
* Dolibarr 19.0 or later, PHP 7.4 or later.<br />
* Dolibarr reachable over '''HTTPS''' (required by Meta for the webhook).<br />
* A Meta Business account with a WhatsApp Business number on the Cloud API.<br />
* For the AI agent: an API key from a supported AI provider.<br />
<br />
== Installation ==<br />
# Buy and download the zip ''module_whatsappia-x.y.z.zip'' from DoliStore.<br />
# Go to ''Home > Setup > Modules/Applications > Deploy/install external module'' and upload the zip.<br />
# Or unzip it manually into ''htdocs/custom/'' so you get ''htdocs/custom/whatsappia''.<br />
<br />
== Configuration ==<br />
# Go to ''Home > Setup > Modules/Applications'' and enable '''WhatsApp IA'''.<br />
# Open the module setup page.<br />
# In Meta Business Suite, create a '''system user''' with full control on the WhatsApp Business Account (WABA) and generate a permanent token.<br />
# Paste the token, the Phone number ID and the WABA ID in the setup page.<br />
# Copy the webhook URL and verify token shown in the setup page into your Meta app (field ''messages'').<br />
# Optional: enable the AI agent, choose the provider and paste your key.<br />
# Give the rights ''Read WhatsApp conversations'' and ''Reply to WhatsApp conversations'' to the users concerned.<br />
<br />
The scheduled job ''WhatsAppIAProcessQueue'' processes the AI queue. Make sure Dolibarr cron jobs are running.<br />
<br />
== Permissions ==<br />
* Read WhatsApp conversations<br />
* Reply to WhatsApp conversations<br />
<br />
== FAQ ==<br />
;The webhook returns 404<br />
:Check that the ''custom'' directory is declared in ''conf.php'' (''$dolibarr_main_url_root_alt'' and ''$dolibarr_main_document_root_alt'').<br />
<br />
;Meta error #10 (permission)<br />
:The system user needs full control on the WABA, not only a partial permission.<br />
<br />
;Meta error #131047<br />
:The 24 hour customer service window is closed. Only an approved template message can be sent.<br />
<br />
;A contact appears as "MA.123..." instead of a phone number<br />
:The customer uses a WhatsApp username. The module stores the WhatsApp user ID and shows the username when Meta provides it.<br />
<br />
;Is my data sent to the AI provider?<br />
:Only when the AI agent is enabled: the customer message and the data returned by the read-only tools needed to answer. You can leave the AI off and use the module as a simple shared inbox.<br />
<br />
== Support ==<br />
* Email: contact@weglob.com<br />
* Website: [https://weglob.com weglob.com]<br />
* LinkedIn: [https://www.linkedin.com/in/mohamed-aggoubi/ Mohamed Aggoubi]<br />
<br />
[[Category:Complementary modules]]<br />
[[Category:DocUserEN]]</div>Weglob