Learn about the Referral object used by the Automation Framework and Bot v3 API
Some channels enable users to enter conversations from sources like ads, QR or other scannable codes, or plain links. The referral object captures these points of entry and passes them along.
Here's an example of a referral object:
{
"ref": "abc123-something-something-referral-data-from-a-llink",
"type": "OPEN_THREAD",
"source": "SHORTLINK"
}
Brands can configure the payloads and data associated with these referral sources, and the Automation Framework can deliver the data to bots. This is presently only passed for Facebook Messenger referrals.
Here's a breakdown of the fields associated with referral objects:
Field | Description |
---|---|
ref | The identifier or payload associated with the specific referral method. For example, the value of the ref query parameter of a Facebook Messenger shortlink. |
source | The referral source. For example, |
type | The type of referral. Presently, only |
adId | Facebook Ads identifier. Only present for |
refererUri | For Facebook Customer Chat Plugin use-cases, the site URI from which messages were sent. |