Who This Is For / When to Use
This article is for users who want to automate workflows based on incoming Google or Facebook reviews, such as routing 5-star reviews, handling spam, or sending review data to external systems.
Important Behavior Notes
The Review Received trigger is contactless.
Reviews are not linked to any contact by default.
Actions relying on contact data require a Find Contact step later in the workflow.
Step 1: Create or Open a Workflow
Navigate to Automations > Workflows.
Click Create New Workflow, or open an existing workflow.
In the workflow builder, click Add New Trigger.
Step 2: Select the Review Received Trigger
From the trigger list, select Review Received.
Enter a trigger name (for example, Review Received).
Step 3: Configure Review Filters
Use filters to control which reviews enroll into the workflow.
Available Filters
Is Review Spam
Choose Spam or Not Spam to include or exclude spam reviews.Review Rating
Filter by star rating (1–5). Example: trigger only when rating equals 5.Review Source
Select Google or Facebook to segment workflows by platform.
Step 4: Add Condition Logic
Use Condition actions to branch workflows based on review attributes.
Common examples:
5-star and not spam
Not 5-star and not spam
Spam reviews
Each branch can run different actions.
Step 5: Send Review Data Using a Webhook (Optional)
Use a Custom Webhook action to send review details to external systems.
You can pass dynamic review fields such as:
Reviewer name
Review rating
Review source
Step 6: Configure the Custom Webhook Action
Set the method (POST is most common).
Enter the destination URL.
Choose application/json as the content type.
Use custom values to map review fields in the request body.
Step 7: Save and Test the Workflow
Click Save.
Use Test Workflow to simulate a review.
Confirm the correct branch and actions are executed.
Common Issues and Fixes
Workflow does not trigger
Ensure the review matches the selected filters.Actions fail due to missing contact data
Add a Find Contact step before contact-based actions.Webhook receives no data
Confirm custom values are correctly mapped in the request body.
FAQ
Are reviews linked to contacts?
No. The Review Received trigger is contactless by default.
Can I separate Google and Facebook reviews?
Yes. Use the Review Source filter or condition branches.
Can I automate actions for only 5-star reviews?
Yes. Use a Review Rating equals 5 filter or condition branch.
Can review data be sent outside Kyrios?
Yes. Use a Custom Webhook action to send review data externally.