Send Conversion Events

POST https://app.sociable.how/api/webhooks/action-sequence

For tracking conversions generated through the Sociable AI sequences feature. Once you set up conversion tracking, we’ll be able to display your conversion data in analytics and use it to optimize AI responses for conversion.

Please feel free to reach out to our team at contact@sociable.how for assistance or if your case requires a custom solution.

Request Parameters

Parameter	Description	Example
sid	Sociable tracking ID, id of the conversation in which the conversion occurred. Can either be a longer uuid (prefixed by d_) or a custom promo code (prefixed by c_). Please contact contact@sociable.how to use discount code based conversions.	d_5aa2bd7a-7d44-4d6f-ba28-6212278c8af6 or c_YOURCODEHERE
conversion_data(optional)	Object containing conversion details including monetary value and currency. If used, must include value and currency properties.	See example below
conversion_data.value	The monetary value associated with the conversion event (if applicable).	99.99
conversion_data.currency	The currency code for the conversion value. Supported currencies: USD	USD

Sociable tracking IDs (sid) can either be URL-based or discount code based. Discount code based IDs must be setup directly with our internal development team.

URL-based tracking IDs are attached as search parameters to every valid URL sent by your AI persona during a sequence. Once a follower clicks your link, it is your responsibility to manage the sid until it is sent back to Sociable AI.

Sample Flows:

URL-based Conversion:

1. An example user sets up a sequence on Sociable AI that sends a link to their website. The provided link must be fully qualified, including the correct protocol (such as ‘http://’ or ‘https://’) to ensure proper functionality. See the sandbox for an example response (the first two messages are comments, the second is a direct message).
2. The follower messages the user on Instagram and triggers the sequence.
3. During the conversation, the AI persona sends the provided link and an sid is automatically attached as a search parameter to the URL.
4. The follower clicks on the link and is redirected to the user’s website.
5. While the follower is interacting with the website, a conversion event occurs. Examples of conversion events include:
   • Purchase
   • Sign-up
   • Form Submission
6. When the conversion occurs, the user’s server makes a POST request to this endpoint with the sid prefixed with d_.
7. The conversion is now tracked and can be viewed in the Sociable AI dashboard.

Discount Code-based Conversion:

1. An example user sets up a sequence on Sociable AI that provides a discount code for their product or service.
2. The follower messages the user on Instagram and triggers the sequence.
3. During the conversation, the AI persona sends the discount code, which includes an embedded sid.
4. The follower uses the discount code when making a purchase on the user’s website.
5. When the conversion occurs, the user’s server makes a POST request to this endpoint with the sid prefixed with c_.
6. The conversion is now tracked and can be viewed in the Sociable AI dashboard.

Sample Request Body:

{
    "sid": "d_5aa2bd7a-7d44-4d6f-ba28-6212278c8af6",
    "conversion_data": {
        "value": 99.99,
        "currency": "USD"
    }
}

Sample Response Body:

{
    "success": true
}

Please do not hesitate to reach out to contact@sociable.how for support regarding this process.