​
What is a behavior-based trigger?

A behavior-based trigger is a special moment in your product lifecycle that can be leveraged to encourage users to share the product with their networks. These triggers can be associated with completing a specific action, such as inviting team members or reaching an “aha moment”—a moment of delight where users experience significant value or satisfaction while interacting with your product. These moments typically prompt users to feel compelled to share their experience and effectively boost the conversion rate from users to referrers.

​
How does it work?

When a behavior-based trigger occurs in your product, you can report it to Cello as a MilestoneReached event using our Generic Event API. This event will immediately trigger an in-app announcement to the user. Together with Cello, you can define an announcement that will be triggered inside your product. The announcement should encourage the user at this moment to share the product.
To learn more about how to use the Generic Event API, including authentication, go to Generic Event API guide.
Example use case
  • A specific user viewed five presentations
  • You can report that moment to Cello as a MilestoneReached event when the trigger occurs
  • The user will immediately receive an announcement that will encourage them to share
Behavior-based trigger example

​
Example Request

To attribute that event and notify the right product user, attach the productUserId to the POST requests. Specify the name of the moment as trigger. 
POST https://api.cello.so/events

{
	"eventName": "MilestoneReached",
	"payload": {
		"productUserId": "product-user-id"
	},
	"context": {
		"event": {
				"trigger": "five-presentations-viewed"
			}
	}
}
NameTypeDescriptionRequired
eventNamestringName of the event. MilestoneReached for special momentRequired
productUserIdstringA reference to the ID of the user within your system.Required
triggerstringName of the special “aha” momentRequired

​
Testing Behavior-based trigger and announcement position

While choosing the announcement selector and its position, you will want to see how it looks and make necessary adjustments. You can trigger an announcement by sending a MilestoneReached event using our Generic Event API. Below is a simple Python script to trigger such an event. 
import requests

# Authentication endpoint
auth_url = "https://api.sandbox.cello.so/token"

# Your credentials (replace these placeholders with your credentials for Cello API you can get from Cello Portal: https://portal.cello.so/integrations/accesskeys)
accessKeyId = "YOUR_ACCESS_KEY_ID"
secretAccessKey = "YOUR_SECRET_ACCESS_KEY"

# Attempt to authenticate and get an API token
auth_response = requests.post(auth_url, json={"accessKeyId": accessKeyId, "secretAccessKey": secretAccessKey})

# Check if authentication was successful
if auth_response.status_code == 201:
    api_token = auth_response.json().get("accessToken")
    print("Successfully obtained API token.")
else:
    print(f"Failed to authenticate. Status code: {auth_response.status_code}, Response: {auth_response.text}")
    exit()

# The URL for the events endpoint
url = "https://api.sandbox.cello.so/events"

# Event payload
data = {
	"eventName": "MilestoneReached",
	"payload": {
		"productUserId": "YOUR_USER_ID" # userId that you use to boot the widget
	},
	"context": {
		"event": {
				"trigger": "five-presentations-viewed"
			}
	}
}

# Set the headers including the authorization token
headers = {
    "Authorization": f"Bearer {api_token}",
    "Content-Type": "application/json"
}

# Make the POST request to the endpoint with the data and headers
response = requests.post(url, json=data, headers=headers)

# Check if the request was successful
if response.status_code == 200:
    print("Message sent successfully!")
else:
    print(f"Failed to send message. Status code: {response.status_code}, Response: {response.text}")