Configuration

To set up a new postback, select Postbacks -> Settings in the top menu, and then click the configure a new postback button on the page that opens.

The configuration form is available at https://bolead.top/postbacks/configure.

Configuration form

To configure a postback, you need to fill out the form fields. Fields marked with an asterisk are mandatory.

Field Description Example
Name Name of a postback configuration My CRM
URL A valid URL where the data needs to be sent. https://example.com
Method Sending method. Available methods are POST and GET. POST
Headers Any headers that need to be included in the request. If you add headers, you must fill in both the header name and its value. X-Token: LFDSO651JY
Body The request body in JSON format. The body is available for filling out if POST is selected as the sending method. {“id”: “{{id}}”, “status”: “{{status}}”}

Example of a filled out form

  • Name: My CRM
  • URL: https://mycrm.com/lead/{{id}}/status
  • Method: POST
  • Headers:
    • X-Token LFDSO651JY
    • X-Partner-Id {{webmasterSubId}}
  • Body: {"status": "{{status}}", "rate": "{{rateAmount}}"}

Placeholders

For the fields URL, Body, and each Header value, you can add placeholders that will be replaced with real data from the corresponding lead at the time of sending. The list of placeholders is displayed on the right side of the field as you type into it. To insert the necessary placeholder at the current cursor position, click on its name in the list.

Placeholder list

Name Description
{{id}} Lead ID
{{offerId}} Offer ID
{{countryCode}} 2-letter country code
{{webmasterId}} Your partner ID
{{status}} Lead status. For the list of all possible values see below
{{subStatus}} Rejection reason. This value is filled only when status equals to rejected
{{statusUpdatedAt}} Status update date and time
{{rateAmount}} Rate amount
{{name}} Client name
{{phone}} Client phone number
{{email}} Client email
{{webmasterSubId}} Internal identifier of your partner
{{sub1}} Sub-labels
{{sub2}} –
{{sub3}} –
{{sub4}} –
{{sub5}} –
{{utmSource}} UTM labels
{{utmMedium}} –
{{utmCampaign}} –
{{utmContent}} –
{{utmTerm}} –

Possible values for the {{status}} placeholder

Value Description
pending Lead is accepted and being processed by call center
approved The client approved the order. Leads in this status are eligible for compensation
rejected The client declined the order
trash The lead contains invalid data (most commonly a phone number) or is a duplicate