Zeplo Template Configuration in QCall AI
Once your Zeplo credentials are configured (see Zeplo Setup Guide), you can use WhatsApp templates in your QCall AI assistants to send automated messages.
How Templates Work
Zeplo templates are WhatsApp Business API message templates that contain placeholders like {{1}}, {{2}}, etc. When QCall AI sends a message, these placeholders are filled with real values extracted from the call conversation.
A typical template structure:
| Section | Example | Placeholders |
|---|
| Header | Order #{"{{1}}"} Update | {"{{1}}"} = order number |
| Body | Hi {"{{1}}"}, your order has been shipped! Tracking: {"{{2}}"}. Delivery: {"{{3}}"}. | {"{{1}}"} = name, {"{{2}}"} = tracking, {"{{3}}"} = date |
| Button | URL button → Track Order → https://track.com/{"{{1}}"} | {"{{1}}"} = tracking ID |
Create an Assistant with Zeplo
To use Zeplo WhatsApp messaging in your AI assistant, you need to add a Send Message action and configure the Zeplo card. Below are all the steps and required fields.
Step 1: Create or Edit an Assistant
- Navigate to Assistants from the left sidebar menu.
- Click Create Assistant to create a new one, or click an existing assistant to edit it.
- Fill in the basic assistant details (name, prompt, voice, etc.).
- Scroll down to the Actions section.
Step 2: Add a Send Message Action
- Click Add Action and select Send Message.
- A drawer opens with three messaging options:
- SMS — Send an SMS message
- Zeplo (WhatsApp) — Send a WhatsApp message via Zeplo
- You must enable at least one option to proceed.
If you see a “Configure Zeplo” link instead of the template selector, it means your Zeplo credentials are not yet set up. Click the link to go to the Zeplo configuration page, or follow the Zeplo Setup Guide. Step 3: Enable Zeplo (WhatsApp)
Check the Zeplo (WhatsApp) checkbox. This reveals the full Zeplo configuration card with the following required and optional fields:
Required Fields (Zeplo Card)
| Field | Required | Description |
|---|
| Zeplo (WhatsApp) checkbox | Yes | Must be checked to enable Zeplo messaging |
| Zeplo Template | Yes | Select an approved WhatsApp template from the dropdown. Templates are fetched from your connected Zeplo account. Only APPROVED templates are shown. |
| Parameter Hints | Yes (if template has placeholders) | A hint for each {"{{N}}"} placeholder describing what value the AI should extract. Every hint must be filled. |
| Condition Text | Yes | Describes when the WhatsApp message should be sent. This tells the AI the right moment to trigger the message. |
Optional Fields
| Field | Default | Description |
|---|
| Send Zeplo after the call ends | Unchecked | Message is sent when the call concludes naturally |
| Send Zeplo if call is not answered | Unchecked | Message is sent when the recipient doesn’t pick up |
Step 4: Fill in Parameter Hints
After selecting a template, QCall AI automatically parses all placeholders and displays Parameter Hints input fields. These hints tell the AI what each placeholder represents so it can extract the correct value from the conversation.
For example, if your template body is:
Hi {"{{1}}"}, your order {"{{2}}"} has been shipped!
- Body hint:
Customer's full name
- Body hint:
Order number or ID
Parameters are grouped by section:
| Section | Description |
|---|
| Header parameters | Placeholders in the message header |
| Body parameters | Placeholders in the main message body |
| Button (URL) parameters | Placeholders in URL button destinations |
All parameter hints must be filled in. Leaving a hint empty will cause a validation error and the message will not be sent. This prevents Meta API error #132000.
Step 5: Add a Condition Text
The Condition Text field describes when the WhatsApp message should be sent. This text helps the AI decide the right moment to trigger the message.
Examples:
"Send order confirmation after the customer places an order""Send appointment reminder with the scheduled date""Send OTP code for verification"
Two checkboxes control when the message is sent. Both can be enabled simultaneously:
| Option | Description |
|---|
| Send Zeplo after the call ends | Message is sent when the call concludes naturally |
| Send Zeplo if call is not answered | Message is sent when the recipient doesn’t pick up |
Step 7: Test the Template
Before deploying, test your template configuration:
- Click the Test Zeplo button (visible when Zeplo is configured).
- In the test modal:
- Enter a phone number (with country code)
- Select a template
- Fill in the parameter values for each placeholder
- Click Send Test.
- Check if the WhatsApp message was delivered successfully.
Authentication (OTP) Templates
Authentication templates have special handling. Meta requires the same OTP value to appear in both the body and button parameters. QCall AI handles this automatically:
- When you select an Authentication category template, you’ll see a warning banner.
- You only need to provide one hint for the OTP value.
- QCall AI will automatically replicate the OTP to all body and button placeholders at send time.
The test modal also simplifies OTP testing — enter the code once, and it’s applied to all slots.
Template Categories
| Category | Description | Use Case |
|---|
| Marketing | Promotional content | Discounts, offers, announcements |
| Utility | Transactional updates | Order status, account updates, alerts |
| Authentication | Security verification | OTP codes, login verification |
Data Saved per Send Message Action
When you save a Send Message action with Zeplo enabled, the following data structure is stored:
| Key | Type | Description |
|---|
zeplo.is_zeplo | boolean | Whether Zeplo messaging is enabled |
zeplo.description | string | The condition text describing when to send |
zeplo.content.templateName | string | Name of the selected WhatsApp template |
zeplo.content.language | string | Template language (e.g. en_US) |
zeplo.content.category | string | Template category: MARKETING, UTILITY, or AUTHENTICATION |
zeplo.content.parameter_hints | string[] | Array of hint strings, aligned 1-to-1 with parameter_slots |
zeplo.content.parameter_slots | object[] | Array of slot objects describing each placeholder’s position |
zeplo.content.components | array | Always [] — built at send time from parameter values |
zeplo.end_call_sms | boolean | Send after call ends |
zeplo.end_call_sms_not_answered | boolean | Send if call not answered |
Parameter Slot Object
Each entry in parameter_slots has this structure:
| Key | Type | Description |
|---|
section | string | "header", "body", or "button" |
index | number | For header/body: the {"{{N}}"} number (1-based). For button: the button’s position (0-based) |
sub_index | number | For button only: the {"{{N}}"} number inside the button URL |
label | string | Human-readable label, e.g. Body {"{{1}}"} or Button 0 (Track Order) {"{{1}}"} |
Tracking Zeplo Message Status
After sending messages through QCall AI campaigns, you can track the Zeplo delivery status in multiple places:
- Campaign Details — Shows
is_zeplo_sent status per contact
- Call Logs — Displays whether a WhatsApp message was sent for each call
- Call Playground — Shows Zeplo status in the history view
Troubleshooting
| Issue | Solution |
|---|
| Templates not loading | Verify Zeplo credentials are correct and the channel is connected |
| ”Configure Zeplo” link shown | Go to Integrations → Zeplo and enter your API Key, Secret, and Channel ID |
| Meta error #132000 | Ensure all parameter hints are filled in the send message action |
| Test message not delivered | Check that the phone number includes the country code and the template is APPROVED |
| OTP not working for auth templates | Verify the template category is set to “AUTHENTICATION” in Zeplo |
API Endpoints Used
QCall AI uses the following backend endpoints to communicate with Zeplo:
| Endpoint | Method | Description |
|---|
/zeplo/zeplo-config | GET | Fetch current Zeplo configuration |
/zeplo/zeplo-config | POST | Create new Zeplo configuration |
/zeplo/zeplo-update | PUT | Update existing configuration |
/zeplo/zeplo-delete | DELETE | Remove Zeplo configuration |
/zeplo/template-list | GET | Fetch approved WhatsApp templates |
/zeplo/test-zeplo-config | POST | Send a test message |
