This article describes how to set up a Ring Tree and defines important terms. This feature is available to Admin users.

This article contains the following sections:

• What is a Ring Tree?
• Manage Ring Trees screen
• How to Set Up a Ring Tree
• What's Next?

What is a Ring Tree?

Ring Trees are Ringba's implementation of the industry's common Ping-Post call buying scheme: a request is made to one or several dynamic call buyers to obtain potential targets for an inbound call. If you add multiple Ring Tree Targets to a single Ring Tree, the system pings all the targets at the same time to retrieve information and evaluate it against criteria you set up. The Ring Tree features provide you with several selection criteria to filter targets based on their bid amount and their call requirements, like duration or acceptance criteria. You can use these tools to maximize the revenue from an incoming call.

Many users get help from Ringba Support to set up their Ring Tree Targets. See How do I get help with Ringba? for information on contacting Ringba Support.

Manage Ring Trees screen

When you navigate to Ring Trees > Manage Ring Trees, you see a table with a row for each Ring Tree already in your account. The Actions column in this table contains useful buttons you can use to manage your Ring Trees.

From this screen you can:

• Edit: Click to open the Ring Tree so you can manage the details. Clicking this button performs the same action as clicking the Ring Tree name.
• Disable Tree: Click to temporarily stop calls from going to this Ring Tree. If the Ring Tree is already disabled, this becomes an Enable Tree button.
• Delete Ring Tree: Click to delete this Ring Tree. If you click this icon, a confirmation window appears showing the list of Campaigns, Ring Tree Targets, and Routing Plans associated with this Ring Tree for you to review before you delete.
• View Activities: Click to see a history of activity for this tree, including the timestamp and the user.

How to Set Up a Ring Tree

Use the following steps to set up a Ring Tree:

Note: Call providers often require a particular configuration. The following example is just one possible setup. Almost every dynamic buyer will have its own unique requirements; however, you can use the following example to get an idea of how to implement a Ring Tree.

1. Click Ring Trees from the left navigation panel and then click Manage Ring Trees.
   

2. Click the Create Ring Tree button to display a form.

3. Complete the fields on this screen. The rest of this procedure describes each section of fields. You can also use the tool tips in the application to learn about each field.

4. Click the Create Ring Tree button.

   Please note: For a Ring Tree to operate correctly, it must contain at least one Ring Tree Target.

General Information section

The first section of fields is where you specify general information about the Ring Tree. You must enter the RTT’s name, time zone, and hours of operation.

The Hours of Operation switch is set to Always Open by default, but if you toggle it, tools appear for setting specific hours. In the Basic mode, you can choose an open and close time that applies for all days of the week. In the Advanced mode, you can choose different open and close times by day, add breaks, and even turn entire days off.

Revenue Settings section

Use the fields in this section to set the default revenue settings for all the Ring Tree Targets in this Ring Tree. These fields specify when and how much you are paid for the call.

If you choose a Static revenue type, a new field appears where you end the Static Revenue Amount.

If you choose convert on Call Length, fields appear for you to configure when to start counting the call length, whether to use a Static or Dynamic call length value, and what call length you require.

These settings will apply unless you override them on a particular Ring Tree Target.

Error Settings section

Use the fields in this section to specify default settings for how long to wait before considering a dial or a ping to be timed out. You also choose whether to send a call even if the ping fails.

Tip: We recommend setting Dial Timeout to 10 seconds and Ping Timeout to 2000 milliseconds, as you see on the fields.

These settings will apply unless you override them on a particular Ring Tree Target.

Add Ring Tree Targets section

Use this section to add Ring Tree Targets to your Ring Tree. Your Ring Tree must have at least one Ring Tree Target to work.

What's Next

Once you have defined the Ring Tree, you can include it in a campaign. To do this, you must create a Routing Plan that includes a Ring Tree.
Tip: Make sure to select the Trees tab to find your Ring Tree on your Routing Plan.

If you are using an IVR, you must include the Routing Plan containing the Ring Tree in your IVR.

Note: For security reasons, some buyers ask which IP Ringba's Ring Tree request comes from. If they ask you which IP they should whitelist, please check this link Pixels, Ring trees and Custom Scoring IP whitelist.