Posting Bids from Retreaver to CallGrid using RTB

This guide will walk you through setting up RTB integration in your Retreaver campaign to post bid requests to CallGrid.

Prerequisites#

Before starting, ensure you have:

• An active Retreaver campaign
• CallGrid RTB URL provided by your buyer
• Administrative access to your Retreaver account

Setup Instructions#

Step 1: Set Up Call Buyer in Retreaver#

1. In your Retreaver campaign, click "Add Buyer"
2. In the Number field, enter exactly: [number] (including the square brackets)
3. Configure other buyer settings as needed (payout, filters, etc.)
4. Click "Create Call Buyer" to save the profile
5. Copy the System Buyer ID that gets assigned to this buyer
   
   

Step 2: Update Buyer Number Format#

#

1. Edit the buyer you just created
2. Change the number field from [number] to: [callgrid_{SystemBuyerID}_number]
3. Replace {SystemBuyerID} with the actual System Buyer ID you copied
4. Save the buyer changes

Step 3: Configure Retreaver Webhook#

#

1. In your Retreaver campaign, scroll to the Webhook section
2. Click "Add Webhook"
3. Set Webhook trigger to "Pass-through Ping"
4. Name the webhook for your reference
5. Click the Webhook Configurator Toggle to enable advanced settings

Step 4: Configure Webhook URLs#

#

Fill in the webhook configurator fields with the URLs provided by your CallGrid buyer:

Ping URL: (Provided by your CallGrid buyer) Post URL: (Provided by your CallGrid buyer)

HTTP Method: POST Timeout: 5000ms (or as preferred)

Click "Create Webhook" to save the configuration.

Step 5: Configure Conversion Criteria#

#

1. Edit your campaign and scroll to the Conversion Criteria section
2. Tag the CallGrid buyer to the conversion criteria using the wizard
3. Configure the following fields:

Seconds Tag: duration Revenue Tag: payout

4. If you're brokering calls, set your payout value and specify your revenue share percentage

Testing Your Integration#

Test Call Process#

1. Use Retreaver's webhook testing tools to verify the ping/post URLs respond correctly
2. Check that your CallGrid buyer's URLs are properly configured
3. Verify that the buyer's number format includes the correct System Buyer ID: [callgrid_{SystemBuyerID}_number]

Expected Response Format#

When testing, you should receive responses containing:

• Status: reserved (for successful bids)
• Inbound Number: Phone number for call routing
• Payout: Revenue amount for the call
• Duration: Minimum call duration required

Troubleshooting#

Common Issues#

Webhook Not Responding

• Verify the ping/post URLs provided by your CallGrid buyer are correct
• Check that the webhook URLs are properly formatted
• Ensure the webhook timeout settings allow sufficient response time

Buyer Not Bidding

• Confirm the buyer's number format: [callgrid_{SystemBuyerID}_number]
• Verify the System Buyer ID matches exactly
• Check that the buyer meets campaign filters and availability requirements

Conversion Tracking Issues

• Ensure the "duration" and "payout" tags are properly configured
• Verify the conversion criteria is tagged to the correct buyer
• Check that the revenue sharing percentage is set correctly

Advanced Configuration#

Multiple Buyer Setup#

You can create multiple CallGrid buyers within the same Retreaver campaign:

1. Repeat Steps 1-2 for each additional buyer
2. Each buyer will have its own unique System Buyer ID
3. Use the same webhook configuration for all buyers
4. Configure different payout rates or filters per buyer as needed

Support#

For assistance with this integration:

• Verify all Retreaver configuration steps are completed correctly
• Ensure you have the correct CallGrid RTB URLs from your buyer
• Contact your CallGrid buyer for URL-specific issues