Skip to main content

How to Set Up a Seller Ring Tree and Ring Tree Target

Amanda Cross
Updated

To begin selling calls on the Ringba Exchange, you need to set up a ring tree with ring tree targets inside the Ringba platform in order to pass data and receive bids dynamically from a buyer.

In this guide, we show you an example setup that lets you send a request to the buyer before sending the call and, depending on the buyer's response, forward the call to them.

Note: If you are not using Ringba to sell calls on the Ringba Exchange, please reach out to the Ringba X team for one-on-one support to ensure you are selling calls into the Exchange correctly.

Let’s get into it:

Step 1) Create a Buyer for Ringba X

First, go to the Ringba Platform and create a buyer for Ringba X. 
Tip: Find step-by-step instructions in the Buyers article in the Ringba user knowledge base.

Step 2) Create a Ring Tree Target

Next, you create a ring tree target.
Tip: Find step-by-step instructions in the Ring Tree Target Setup Guide in the Ringba user knowledge base.

  1. For the name, we recommend using a naming convention that includes the category and traffic source for the calls being sold.
  2. In the Buyer field, select the Ringba X buyer you created in Step 1.
  3. Toggle on the Dynamic Number switch. This switch lets the ring tree target receive the destination phone number during the ping/post.
  4. Set Connection Timeout to 10.
  5. In the Time Zone field, select Pacific Standard Time.
  6. In the Request Settings section, click the Advanced tab and configure the options as follows:
    • For URL, use the bid URL from the seller offer and append URL parameters in the following format: 
      {Bid URL from seller offer}?trafficsource={traffic source value mentioned in seller offer bid URL details}&cid=[tag:InboundNumber:Number-NoPlus]&thirdparty={yes|no}&sipOK=yes&creative={CreativeIDfromRingbaX}
      Note: Adding the sipOK=yes parameter lets calls be forwarded to the SIP address returned in the ping response.
    • If you are setting up this ring tree target for the Medicare or Overflow Medicare category, you must also include the creative={Creative ID from Ringba X} parameter in the request. The value of the parameter is the ID of the creative you uploaded to your Ringba X account. If you are setting up the ring tree target for a different category, you can leave this parameter off.
      Tip: The Creative ID is a string that begins with CR. 
    • Next, set the HTTP Method to Get.
  7. Under Dynamic Bid Parsing, set the Parsing Type to JPath and the Parsing Expression to the following, then click the Add Parsing Step button. 
    bidAmount
  8. Go to the Call Acceptance Parsing section and set the Parsing Type to JavaScript. For Parsing Expression, type in this expression, then click the Add Parsing Step button. 
    return JSON.parse(input).bidAmount > 0;
  9. In the Dynamic Number/SIP Parsing section, set the Parsing Type to JPath. For the Parsing Expression, enter the following, then click the Add Parsing Step button. 
    sipAddress
  10. Submit the form to create the ring tree target.

Step 3) Create a Ring Tree

The last step is to create a ring tree for the ring tree target we just created. 
Tip: Find step-by-step instructions in the Ring Tree Setup Guide in the Ringba user knowledge base.

  • For Name, use the same name that you created for the ring tree target, but add RT at the end.
  • Set Minimum revenue to 0 and Failure Revenue to 0.
  • Set Convert On to Call Length, set Start call length On to Connect, and set Conversion call length value to Dynamic.
  • Next, set the Dial Timeout to 10s and ping timeout to 3000ms.
  • Add the ring tree target you created in the previous step.
  • Click Create and your final step is to add the Ring Tree into the respective Ringba campaign you are driving calls to.

If you have any questions or require a more advanced setup, please reach out to the Ringba X Support team. We’re standing by to ensure you are set up for success on the Ringba Exchange.

Related articles