How the Click-to-WhatsApp Ads Trigger Works
The trigger activates when an eligible contact sends an inbound WhatsApp message after interacting with a supported Meta entry point. When the message reaches Kyrios:
The inbound WhatsApp message is received.
Kyrios identifies the interaction as coming from a supported Click-to-WhatsApp source.
The contact enters any workflow configured with the Click-to-WhatsApp Ads trigger.
The workflow continues through the actions and conditions you configured.
The workflow does not require a team member to manually monitor the conversation before the automation begins.
Supported WhatsApp Entry Points
The Click-to-WhatsApp Ads trigger is intended for messages that originate from:
A Click-to-WhatsApp ad.
A Facebook Page WhatsApp call-to-action button.
The contact must send a WhatsApp message after interacting with the entry point for the workflow trigger to activate.
How to Add the Click-to-WhatsApp Ads Trigger
Open the workflow you want to configure.
In the workflow Builder, click Add New Trigger.
Search for WhatsApp.
Select Click To WhatsApp Ads from the available workflow triggers.
5. Review the trigger settings.
6. Add filters if the workflow should run only for specific ads, posts, URLs, headlines, or source types.
7. Click Save Trigger.
The workflow can then continue into any actions or conditions required for your automation.
How to Filter the Trigger by Ad or Post
Filters control which Click-to-WhatsApp interactions are allowed to activate the workflow. After selecting Click-to-WhatsApp Ads, use the Filters section to define the interactions the workflow should accept. Available filter options described for this trigger include:
Ad ID
Post ID
Ad/Post URL
Headline
Source Type
For example, you can configure a filter for Ad / Post ID and apply a matching condition so that only contacts from a particular promotion enter the workflow.
Use filters when different campaigns require different automation paths. If no campaign-specific restriction is required, do not add unnecessary filters.
How to Use the Trigger With Workflow Actions
After configuring the trigger, add the actions that should run when an eligible WhatsApp message is received. Common workflow actions can include:
Sending a WhatsApp message.
Adding or removing a tag.
Assigning the contact to a user.
Creating or updating an opportunity.
Moving an opportunity to a pipeline stage.
Sending an internal notification.
Sending data through a webhook.
Updating contact information.
The Click-to-WhatsApp Ads trigger controls when the contact enters the workflow. The actions placed after the trigger control what Kyrios does next.
Using Conditions After the Trigger
You can place an If/Else condition after the trigger when different WhatsApp sources should follow different workflow paths. For example, a condition can evaluate information associated with the incoming interaction and route contacts into separate branches. This is useful when one workflow handles multiple campaigns but each campaign requires different messaging or follow-up.
What Is a Free Entry Point Conversation?
A free entry point conversation can open when both of the following conditions are met:
A customer using Android or iOS messages the business through an eligible Click-to-WhatsApp ad or Facebook Page call-to-action.
2. The business responds within 24 hours of the customer's message.
According to the behavior described for this feature, the free entry point conversation begins when the business's response is delivered and remains open for 72 hours. During that 72-hour period, eligible messages can be sent without additional conversation charges. The 72-hour free entry point period and the 24-hour customer service window are separate timing rules.
What Happens If You Respond Within 24 Hours?
When the business responds within 24 hours of the customer's initial message:
A free entry point conversation can open.
The 72-hour free entry point period begins when the response is delivered.
Template messages can be sent during the free entry point period without additional conversation charges.
Non-template messages can be sent while the 24-hour customer service window remains open.
If the customer sends another message, a new 24-hour customer service window can begin.
What Happens If You Respond After 24 Hours?
If the business does not respond within 24 hours of the customer's initial message, a free entry point conversation is not opened. To contact the customer after the customer service window has closed, an approved WhatsApp template must be used. The conversation category associated with that template determines the applicable WhatsApp conversation type.
How the 24-Hour and 72-Hour Windows Work Together
The 24-hour customer service window and the 72-hour free entry point conversation are separate. For example:
A customer sends a WhatsApp message from an eligible ad at 10:00 AM.
The business responds at 10:00 PM that day.
The free entry point conversation begins at 10:00 PM and lasts for 72 hours.
The original customer service window remains open until 10:00 AM the next day.
Template messages can continue during the eligible 72-hour free entry point period.
Non-template messages require an open customer service window.
A new inbound message from the customer can open another 24-hour customer service window.
Common Issues and Fixes
The workflow does not trigger after a WhatsApp message
Confirm that the contact entered the conversation through a supported Click-to-WhatsApp ad or Facebook Page WhatsApp call-to-action and then sent a message.
Also confirm that the workflow is published and the Click To WhatsApp Ads trigger has been saved.
The workflow works for some ads but not others
Review the filters configured on the trigger. An Ad ID, Post ID, URL, Headline, or Source Type filter can prevent interactions from other campaigns from entering the workflow. Remove or update the filter if the workflow should accept additional campaigns.
No contacts are entering the workflow after adding a filter
Confirm that the filter value matches the value associated with the incoming ad or post. An incorrect or overly restrictive filter can prevent the trigger from matching the interaction.
The contact entered the workflow but the expected action did not run
The trigger only controls workflow enrollment. Review the actions, conditions, and branches after the trigger and use the workflow Execution Logs to identify where processing stopped.
A non-template WhatsApp message cannot be sent
Non-template WhatsApp messages require an open customer service window.
The 72-hour free entry point period does not independently extend the 24-hour customer service window for non-template messages.
FAQ
What is the Click-to-WhatsApp Ads workflow trigger?
The Click-to-WhatsApp Ads workflow trigger starts a workflow when a contact sends a WhatsApp message after interacting with an eligible Click-to-WhatsApp ad or Facebook Page WhatsApp call-to-action.
How do I configure the Click-to-WhatsApp Ads workflow trigger?
Open the workflow Builder, click Add New Trigger, search for WhatsApp, and select Click To WhatsApp Ads. Add any required Ad ID, Post ID, URL, Headline, or Source Type filters, then click Save Trigger.
Do I need to add filters to the Click-to-WhatsApp Ads trigger?
No. Filters are only needed when the workflow should activate for specific ads, posts, URLs, headlines, or source types. Without campaign-specific filters, the trigger can be used more broadly for eligible Click-to-WhatsApp interactions.
Can I use one workflow for multiple Click-to-WhatsApp campaigns?
Yes. A workflow can accept multiple eligible interactions, and you can use filters or workflow conditions to separate contacts into different paths based on campaign information.
What is a free entry point conversation?
A free entry point conversation can open when a customer messages the business through an eligible Click-to-WhatsApp entry point and the business responds within 24 hours. The free entry point conversation begins when the business response is delivered and lasts for 72 hours.
How are messages charged during a free entry point conversation?
Based on the WhatsApp behavior described for this feature, eligible messages sent during the 72-hour free entry point conversation do not incur additional conversation charges. The 24-hour customer service window still determines when non-template messages can be sent.
What happens if I do not respond within 24 hours?
If the business does not respond within 24 hours, the free entry point conversation does not open. After the customer service window closes, an approved WhatsApp template must be used to message the customer.
Can I send both template and non-template messages?
Yes, but different timing rules apply. Template messages can be used during the eligible 72-hour free entry point period. Non-template messages require an open 24-hour customer service window.
Does the 72-hour free entry point period extend the 24-hour customer service window?
No. The 72-hour free entry point period and the 24-hour customer service window operate independently. A new inbound message from the customer can open another 24-hour customer service window.


