Integrating Rivo with Cavalry allows your AI Agent to access loyalty information, assist customers with rewards and memberships, and issue store credit through Rivo when permitted by your policies.
Before You Begin
To connect Rivo, you will need:
An active Rivo Plus plan
A Rivo API key
Access to your Cavalry Merchant Admin
To locate your API key in Rivo, navigate to Developer Toolkit → API Keys.
Connect Rivo
Log in to the Cavalry Merchant Admin.
Navigate to Channels & Integrations → Loyalty.
Select Rivo.
Enter your Rivo API key.
Save the integration.
Once connected, you can configure store credit and select which Rivo actions your AI Agent is allowed to perform.
Configure Rivo for Store Credit - Optional
If you would like Cavalry to issue store credit through Rivo, navigate to your Shopify integration settings and select Rivo as your store-credit provider.
You can choose how store credit is granted:
Rivo Credits — Credit is issued at a 1:1 value with dollars. This is the default option.
Loyalty Points — Credit is converted into loyalty points using the points-per-dollar rate you configure.
When your policies allow store credit as a resolution, Cavalry can issue the appropriate credit through Rivo for supported scenarios such as claims, returns, and cancellations.
The amount and availability of store credit remain subject to the policies you have configured in Cavalry.
Configure Direct API Actions
Under the Rivo integration's Direct API Actions, you can individually enable the actions your AI Agent is permitted to perform.
Depending on the actions you enable, the AI Agent can:
Look up a shopper's loyalty profile, including points, credits, VIP status, birthday, and referral link
Adjust loyalty points
View available rewards and redeem rewards
View points events and redemption history
View earning rules and VIP tiers
Retrieve referral and advocate statistics
View or cancel a shopper's membership
Each action can be enabled separately, allowing you to control exactly what information and functionality is available to the AI Agent.
Customer Verification
Customer-specific actions require a verified email address and are limited to the authenticated shopper.
The AI Agent cannot use these actions to access or modify another customer's loyalty account.
Current Limitations
Keep the following limitations in mind:
Inbound Rivo webhooks are not currently supported.
Birthday updates use the MM-DD format, such as
05-21for May 21.
Need Help?
If you need assistance setting up or configuring your Rivo integration, contact support@cavalry.ai.