Skip to main content
WhatsApp is one of the most widely used messaging channels in the world, and Maestra lets you send WhatsApp campaigns to your customers through the Wazzup24 provider. This guide walks you through the full setup — from creating a Wazzup24 account to launching your first bulk or automated WhatsApp campaign.

​
Overview

To send WhatsApp campaigns via Wazzup24 you need to:
  1. Create and configure a Wazzup24 account.
  2. Connect Wazzup24 to Maestra.
  3. Create and get message templates approved in Wazzup24.
  4. Build and send a campaign in Maestra.
Each of these steps is described in detail below.
WhatsApp messages can only be delivered to customers who have a mobile phone number populated in their profile. Make sure your customer data includes valid mobile phone numbers before launching a campaign.

​
Step 1. Set up a Wazzup24 account

  1. Register an account at Wazzup24.
  2. Connect a WhatsApp number to your Wazzup24 account. This number will be used as the sender for all your campaigns.
  3. In Wazzup24, open the CRM Integration section and generate an API key. You’ll use this key to connect Wazzup24 to Maestra.

​
Step 2. Connect Wazzup24 to Maestra

  1. In Maestra, go to Settings → Campaigns → Connections.
  2. Add a new WhatsApp connection.
  3. Paste the API key you generated in Wazzup24.
  4. Configure the endpoint that will receive delivery and read statuses by sending the required PATCH request to Wazzup24. This tells Wazzup24 where to push status updates so Maestra can record them in campaign analytics.
  5. Enable the Notifications and Messengers module in your Maestra workspace.
Once the connection is active, Maestra will automatically create a sender that corresponds to the WhatsApp number connected in Wazzup24.

​
Step 3. Create message templates in Wazzup24

WhatsApp requires that any message sent outside an active 24-hour conversation window use a pre-approved template. Templates are created and submitted for approval inside Wazzup24, not in Maestra.
  1. In Wazzup24, create a new template with the text, variables, and (optionally) buttons you want to use.
  2. Submit the template for approval. WhatsApp typically reviews templates within a few hours to a day.
  3. Wait until the template’s status becomes Active. Only templates with Active status can be used in Maestra campaigns.
After your template is approved, collect the two identifiers you’ll need in Maestra:
  • Channel ID — found in the browser address bar when you’re viewing the channel in Wazzup24.
  • Template ID — shown in the template’s code in Wazzup24.

​
Step 4. Create a WhatsApp campaign in Maestra

  1. Go to the Campaigns section in Maestra.
  2. Choose the type of campaign you want to send:
    • Bulk campaign — a one-off send to a selected audience.
    • Automated campaign — a campaign that runs as part of a flow or scenario.
  3. Select WhatsApp as the channel.
  4. Configure the message:
    • Sender — the WhatsApp sender is created automatically when you connect Wazzup24.
    • Channel ID — paste the channel identifier from Wazzup24.
    • Buttons (optional) — if your template includes buttons, fill in the button text and payload values.
  5. Choose one of the three message types described below.

​
Message types

You can send three types of messages on WhatsApp via Wazzup24:
Uses a pre-approved Wazzup24 template. This is the only message type you can send to customers outside the 24-hour conversation window.
  • Select the approved template by its Template ID.
  • Fill in variable values. You can use customer attributes, order data, product data, or any other field available in Maestra to personalize the message.
  • If your template includes buttons, provide the button text and payload values.
A free-form text message. WhatsApp only allows free-form text messages to be sent to a customer within 24 hours of their last inbound message. Outside that window, you must use a template.Use this type for replies and follow-ups inside an active conversation — for example, an automated reply to a customer who has just messaged you on WhatsApp.
Sends an image attachment.
  • Supported formats: .jpeg, .jpg, .png.
  • Maximum file size: 5 MB.
As with text messages, file messages can only be sent inside an active 24-hour conversation window.

​
Bulk vs. automated campaigns

  • Bulk campaigns require you to pick a recipient segment and schedule a send time. Once scheduled, the campaign will dispatch to all customers in the segment who have a valid mobile phone number.
  • Automated campaigns are triggered as steps inside a flow or scenario. They send to whoever enters that step, using the configuration you set up on the WhatsApp block.
Maestra cannot track clicks on links that are hard-coded into a WhatsApp template body, because the link text is set inside Wazzup24 and bypasses Maestra’s URL handling. To track clicks, use Maestra’s built-in URL shortener for any link you insert into a template variable. Links inserted as variables go through Maestra and will show up in your click analytics.

​
Analytics

After a campaign is sent, Maestra records the following statuses for each recipient:
  • Sends
  • Opens (reads)
  • Clicks (for links handled by Maestra’s URL shortener)
  • Failed and undelivered messages
You can use these metrics in campaign reports, segmentation, and follow-up flows — for example, to retarget customers who didn’t open a WhatsApp campaign with a different channel.

​
Requirements and limitations

  • Customers must have a mobile phone number on their profile to receive WhatsApp messages.
  • Templates must be created and approved in Wazzup24, and must be in Active status before they can be used in Maestra.
  • Free-form text and file messages can only be sent within an active 24-hour conversation window.
  • File attachments are limited to .jpeg, .jpg, and .png images up to 5 MB.
  • Clicks on links hard-coded into template text cannot be tracked — use Maestra’s URL shortener on variable links instead.

​
Troubleshooting

Make sure the template’s status in Wazzup24 is Active. Templates that are pending review, rejected, or disabled won’t be available in Maestra.
Check that:
  • The Wazzup24 connection in Maestra is active and the API key is valid.
  • The PATCH request for receiving statuses was executed successfully.
  • Recipients have a valid mobile phone number on their profile.
  • You’re using a template (not a free-form text or file message) for customers outside the 24-hour conversation window.
Verify that the status webhook endpoint is correctly configured on the Wazzup24 side via the PATCH request. Without it, Maestra won’t receive delivery and read updates from Wazzup24.