Integrate WhatsApp with WooCommerce

Step by step

1. 1

   Connect a number on ZapZap API

   In the ZapZap API dashboard, create an instance and scan the QR Code with the WhatsApp of the number that will send the store notifications. Save the instanceId, x-api-key and x-api-secret, which will be used in the HTTP calls.

2. 2

   Enable webhooks in WooCommerce

   In the WordPress dashboard, go to WooCommerce > Settings > Advanced > Webhooks and click Add webhook. Give it a name such as WhatsApp Notification and leave the status as Active.

3. 3

   Configure the topic and the delivery URL

   Under Topic, choose Order created and Order updated (create one webhook for each). In the Delivery URL field, enter the address of your backend that will receive the order payload, for example https://your-server.com/woo/order. Set a Secret to validate the X-WC-Webhook-Signature signature.

4. 4

   Handle the payload and send the message

   In your backend, read the order JSON sent by WooCommerce (billing.phone, status, line_items) and build the notification text according to the status. Then make a request to ZapZap API sending the message to the customer's number through your instance.

5. 5

   Test with a real order

   Place a test order in the store, approve the payment and change the status to completed. Check that the confirmation, payment and shipping messages arrived. Use the welcome credit (subject to the current campaign) to validate the whole flow before scaling.

// ILLUSTRATIVE: check the real endpoints at https://api.zapzapapi.com/llms.txt
// Backend that receives the WooCommerce webhook and notifies the customer on WhatsApp

app.post('/woo/order', async (req, res) => {
  const order = req.body; // WooCommerce payload
  const phone = order.billing.phone.replace(/\D/g, '');

  const texts = {
    'pending':    `We received your order #${order.number}. Awaiting payment.`,
    'processing': `Payment approved for order #${order.number}. We are already picking your items.`,
    'completed':  `Your order #${order.number} has been shipped. Thank you for your purchase!`
  };

  const text = texts[order.status];
  if (!text) return res.sendStatus(200);

  const instanceId = 'YOUR_INSTANCE';

  await fetch(`https://api.zapzapapi.com/api/v1/${instanceId}/send/text`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': process.env.ZAPZAP_API_KEY,
      'x-api-secret': process.env.ZAPZAP_API_SECRET
    },
    body: JSON.stringify({ number: `55${phone}`, text })
  });

  res.sendStatus(200);
});