Instructions for using SendApp WhatsApp notifications for PrestaShop

1. Installing the module

Installing the module

Download the SendApp WhatsApp Notifications module ZIP file from
official page or from the PrestaShop Addons Marketplace. Access your
PrestaShop administration and go to Modules → Module Manager → Upload
a form. Drag the ZIP into the upload area, wait for it to load
and click Install. Once finished, you will see the module in the list: click
Configure to access the setup panel.

During installation the module automatically creates the tables of the
necessary databases (message queue, sending history, subscribers, queue
product-view) and two custom order states for the flow
customer confirmation.

2. Choose the SendApp platform

Choosing the SendApp platform

New in version 2.0 is the ability to choose the backend
SendApp with which the module will communicate. In the Setup panel you will find the
“SendApp platform” radio button with two options:

– SendApp Agent (Cloud, single bearer token) – for those who have a
account on app.sendapp.ai and a WhatsApp number
Meta-approved business. Single-token authentication.

– SendApp Agent (app.sendapp.ai, API key + token) – for those who use the
SendApp Agent platform. Authentication via API pair
key + token found in the Developer Tools section.

The module memorizes the choice and automatically routes each call
API (fetch template, sync, send single message, broadcast) to
the correct endpoint for the selected platform.

3. Generate API credentials

Generating credentials

Next to each option in the “SendApp platform” radio you will find a link
direct to the token generation page on the chosen platform:

– If you selected SendApp Agent, click on “Generate token”. Yes
opens the page https://app.sendapp.ai/developer-tools/access-tokens in a new tab.
Log in to your account, click Generate API key, copy the token with
the clipboard icon and paste it into the “SendApp Agent” field
Access Token” of the module.

– If you selected SendApp Agent, click on “Generate API key + token”.
The page https://app.sendapp.ai/api opens in a new tab where
You'll find both the API key and the token. Copy and paste them into the two
respective form fields.

Also fill in the “Admin's mobile phone” field with the number (or
comma-separated numbers) on which you want to receive notifications
administration. Save: the form immediately verifies the credentials and
displays a green “Connected” badge with the number of approved templates
uploaded from the cloud.

4. Configure WhatsApp templates for each event

Configure notification messages

In the “WhatsApp Templates and Notifications” panel you will find an entry for
each store event: new order, new customer, product
out of stock, abandoned cart, birthday, order status change, etc.
For each one you can:

– Select a Meta-approved template from the drop-down menu.
– Map dynamic template variables (e.g. {{1}} = name
customer, {{2}} = order total) to PrestaShop placeholders
available for that event.
– Attach a media URL if your template has an IMAGE/VIDEO/DOCUMENT header.
– Specify a free fallback text used only if the template does not
is available (requires 24h open session with the client).

As you click on the fields, a live preview appears on the right.
smartphones with real-time variable substitution: the
Filled variables are highlighted in green, those still empty in
yellow. If you haven't created templates on Meta yet, click the
“Create new template on SendApp Agent” button at the bottom of the panel:
the SendApp dashboard opens in the template section, where you can
create them and wait for approval.

5. CRON Automations: Carts, Birthday, Product View

Scheduled Jobs (CRON)

In the “Scheduled Jobs (CRON)” panel you can configure automations
module timeframes:

– Abandoned Carts: The module sends a WhatsApp message to
customers who left products in the cart between time
minimum and maximum time configured (default 3 min – 5 hours).
– Birthday greetings: once a day CRON sends birthday greetings
to all customers who have a birthday with a possible code
discount inserted in the template.
– Product view: the module stores the products viewed by the
logged in customers and, after a configurable cooldown, sends a
WhatsApp reminder with the product link and a possible incentive.
– Delayed message queue: if you enable “Delayed sending” the messages
are queued and batch processed by the sendNext CRON.

The panel displays ready-to-use CRON URLs, pre-populated with the
secret token generated upon installation. Just add it to your crontab.
of the server with the desired frequency (example: every 6 hours for the
abandoned carts, once a day on your birthday).

6. Click-to-Chat widget on the front office

Click-to-Chat Widget

The module includes a floating chat widget for the front office
of your store, configurable from the “Click-to-Chat widget” panel:

– Position: bottom-right or bottom-left
– Company logo: automatically use PrestaShop logo or
set a custom URL
– Popup title and subtitle
– Operator List: a pipe-delimited text area where you enter name,
role, phone, avatar, online status and pre-populated message
for everyone

When the visitor clicks the green FAB with WhatsApp icon it opens
a popup with branded header and card of each operator (avatar
circular, name, role, status badge “I'm online” or “I'll be back soon”).
Clicking on an operator opens WhatsApp web/app with the message
pre-filled. The widget has a pulse animation to attract attention,
It closes with the ESC key or external click, it is responsive and accessible.

7. Send WhatsApp from the order page in admin

“Send WhatsApp message to customer” card”

By opening any order in admin you will find a new shipping card
WhatsApp with two modes:

– Approved template: choose a template, see live preview and
fill in the variables by clicking the suggested chips with the data
of the order (customer name, order ID, total, courier, products).
– Free text: write a direct message, valid only if the
customer interacted in the last 24 hours (Meta limit).

The recipient's number is pre-filled from the phone_mobile field of the
client. A client+server validation prevents silent sending: if
If the template or body is missing, a red banner with the specific motif appears,
otherwise a green confirmation banner “Message forwarded”.

8. WhatsApp-style live preview

Live Preview

To the right of the configuration panel is a smartphone mockup
with WhatsApp header showing in real time how the messages will appear
messages on the customer's phone. Clicking any template field
in the panels (settings, templates, single send, bulk send) the bubble
of the message updates instantly with replacement of the
variables and media headers. If you select a template with headers
IMAGE shows the real image (with object-fit cover for
maintain the proportions); with VIDEO or DOCUMENT headers the following appear
corresponding tiles. The preview is screwed into a sticky panel on the
right and follows the page scroll.

9. Marketing - Mass broadcast sending

WhatsApp marketing campaigns

From the “Marketing – Bulk Message” panel you can send a message
broadcast to a list of numbers. Choose a template, map the
variables, optionally attach a media URL and click Submit.

Below the form you will find a button for each customer group of the
shop: by clicking it, the recipients' text area is pre-filled
with all the customer numbers in that group (deduplicated). If you have
high volumes activate the “Delayed sending” mode in the CRON panel
to queue messages and respect Meta rate limits.