Documentation

Introduction

Documentation

Latest guides 49 articles
02

Data Posting - Applying Tags to Calls using Call Data Writing

Retreaver users can create data posting links that give publishers the ability to apply tags to an inbound caller using call data writing, these tags can be applied at any time, either before or after calls have been processed.

Read guide
03

Retreaver IP Addresses

List of Retreaver IP addresses for API and firewall rules

Read guide
04

How to Check if Retreaver Is Down?

How to check if Retreaver is down and access our status page.

Read guide
05

RTB Dashboard

RTB Dashboard is where you analyze reservation activity before a call enters Retreaver. It shows the requests coming through the Real-Time Bidding API, including whether each request was reserved, expired, rejected, or could not find an available target.

Read guide
06

Geo Data Handling

Caller location in Retreaver — country, state, city, and zip — is stored as geo tags on the call and drives routing. Those values can come from several places: you can send them explicitly on an RTB inbound request or Data Writing request, Retreaver can i

Read guide
07

Postback Keys

A Postback Key is a secure, scope-limited API token that lets an external system

Read guide
08

Retreaver IQ - Zip Code Solutions

Retreaver IQ enriches inbound calls in real time by retrieving additional caller intelligence using the caller’s phone number through a verified database powered by Audience Acuity.

Read guide
09

Understanding High Ping Volume vs Low Call Volume

Learn why you may experience high RTB ping volume with few live calls. Covering what Reserved and Expired mean, why brokers over-ping, why longer TTL will not help, how Ping Shield limits noise, and how the RTB drilldown spotlights weak publishers.

Read guide
10

Introduction

Start here to learn about Retreaver and how to get started routing and tracking calls.

Read guide
11

Numbers

Set up phone numbers through Retreaver: local or toll-free, dynamic vs static. Then expand routing and tracking with campaigns, publishers, tags, and business hours.

Read guide
12

Webhooks

Webhooks are a core part of how Retreaver connects with 3rd party Call data appending services, affiliate systems, bidding, and other APIs. It allows you to tag Calls and append data at every stage of a Call or RTB helping you route in a way that fits you

Read guide
13

Test Fire Webhooks

Test your buyers webhook using Retreaver's new and improved Test Webhook function.

Read guide
14

Buyer Caps

Learn how to control call volume to Buyers using concurrency, hourly, daily, monthly, and hard caps. Includes cap triggers, RTB reservation counting, and how caps are displayed and configured.

Read guide
15

Troubleshooting RTB Requests

Troubleshooting guide for Retreaver RTB requests covering correct endpoint format, POST method requirements, valid caller numbers, empty field issues, "no target" errors, and buyer profile access.

Read guide
16

Twilio Application Connect

Twilio Application Connect lets you hand off calls from your own Twilio apps directly into Retreaver. This gives you the flexibility of using Twilio's and Retreaver's features in tandem.

Read guide
17

Webhook Output Modifiers

Use output modifiers to automatically adjust payout, revenue, and timer values returned by a webhook before they are applied to the call.

Read guide
18

Time Zones

How to change your time zone when using Retreaver.

Read guide
19

Waiting Room

The Waiting Room gives your callers a chance to connect even when all your buyers are busy. Instead of immediately dropping the call, Retreaver places the caller on hold and quietly re-checks for available handlers every few seconds. The moment someone be

Read guide
20

Auto-Suppression and Auto-Acceptance with Caller Lists

Caller Lists give you precise control over which caller numbers can and cannot be accepted in a campaign and reach specific buyers.

Read guide
21

AI Analyst: Turn Calls Into Insights

AI Analyst automatically transcribes and analyzes your calls inside Retreaver, tagging each conversation with caller intent, call outcome, and key insights. It helps teams quickly understand what happened on every call, improve conversion performance, and

Read guide
22

How to export Calls as CSV and view as Excel spreadsheets

How to export Calls tables as CSV and view them in Excel or Google Sheets

Read guide
23

Forward Tag Lists

Buyers now have a new "Forward Tag" option which are evaluated AFTER the buyer is selected, but just prior to the call being routed. While standard Tags are evaluated BEFORE the buyer is selected.

Read guide
24

Buyer Level Suppression Guide

This guide explains how to block specific caller IDs at the buyer level in Retreaver, allowing you to prevent unwanted callers from being routed to a specific buyer or call handler. It walks through preparing a suppression list, formatting it correctly, a

Read guide
25

How to Route Calls to a SIP Address

This article explains how to route calls in Retreaver using SIP instead of phone numbers, covering both outbound and inbound configurations. It outlines authentication options, setup requirements, and the SIP headers automatically included with SIP-based

Read guide
26

Local and Toll-Free Phone Numbers

Retreaver supports US toll-free numbers and local numbers across most US states and territories.

Read guide
27

Collaborating with Superusers, Publishers, and Call Buyers

Invite users to your company as either superusers or collaborators, with specific roles and permissions such as Publisher or Call Buyer. Retreaver accounts can get access to multiple companies and switch between them.

Read guide
28

How to Port Numbers Into Retreaver

You can port Numbers into Retreaver as well as out of Retreaver for a fee.

Read guide
29

Business Hours

How to set business hours on a Call Buyer to determine which hours they are available and set caps per time frame.

Read guide
30

How to Balance Call Flow with Priority and Weight

Control call routing by prioritizing which agents or buyers are considered first and using weight to distribute calls among equally matched endpoints.

Read guide
31

Number Caps

How to set up granule number caps using the Business Hours feature

Read guide
32

Ringtone Greetings and Prompts

Adding a Ringtone Greeting to a Retreaver Campaign

Read guide
33

How to set up an Offer Carousel

If you are managing multiple offers or campaigns, it might be worthwhile to set up an offer carousel that connects all of your products and services. Callers are prompted and if they are interested in...

Read guide
34

How to View Call Details and read a Call Flow

Unsure how a call was routed or why it skipped a certain endpoint? Want to know what your callers are doing? All this information is available by viewing the Call Flow for your call. The Call Flow pro...

Read guide
35

How to use Tag Values to create Dynamic Prompts

A prompts most basic function is to convey a message to a caller, with the added ability to prompt a caller for additional information that is later stored in tags. We already know that tags are power...

Read guide
36

Route By Bid Winner

Route By Bid Winner lets Retreaver route calls to the highest bidding buyer when static or dynamic conversion criteria are used.

Read guide
37

Alerts Configuration and Terminology

The alerts page is intended to provide you with real time updates surrounding your account activity. You do not need to access this page in order to be alerted of a new event. A red notification icon ...

Read guide
38

Campaign usage and Terminology

Campaigns manage tracked numbers, call buyers and routing rules. Numbers and buyers associated with a campaign will obey the routing rules you created.

Read guide
39

Schedule Exports of Call Data

Retreaver allows you to automatically email call reports on a regular schedule.

Read guide
40

What Does Call Status Mean?

Understand call outcomes in the Retreaver Call Log using Call Status, which shows whether a call is in progress, failed, or completed, with clear reasons like no answer, blocked, busy, system failure, or successfully finished.

Read guide
41

Webhook Configurator

Use webhook configurator with over 100 templates, making integrating and pinging other platforms easier.

Read guide
42

Routing Calls with Campaigns

How to manage call routing paths for campaigns using Route Settings triggers such as "Press 1", assign buyers priority, and other tracking features.

Read guide
43

Overview Dashboard

The Retreaver "Overview" Dashboard will quickly provide you with a brief glance at your account activity, including revenue, calls today, and Call Analytics.

Read guide
44

Terminology

Overview of Retreaver terminology and navigation.

Read guide
45

Real-time Landing Page Tracking

Set up real-time landing page tracking with Retreaver: create a campaign and number pool, enable visitor tracking, use number replacement and the Retreaver JS script, then wire form data into tags with updateTags() and a debounce so every visitor and form

Read guide
46

What is the Retreaver Store?

The Retreaver store gives you the option to further configure the Retreaver platform.

Read guide
47

Creating Retarget Lists using Active Campaign

Active Campaign is a Customer-relationship management web-app that helps organize and track email campaigns using large contact lists. Create automated outreach emails, track any meetings or important...

Read guide
48

Duplicate Caller Handling

Duplicate Caller Handling uses call de-duplication to route calls and RTB bids to buyers who haven't converted the caller, with guidance on enabling the feature and avoiding dropped calls.

Read guide
49

How to Track Calls as Goals in Google Analytics

Learn how to track call events in Google Analytics by configuring Retreaver webhooks, setting up Goals for call started/answered/converted events, and importing conversions into Google Ads for full ad-to-call attribution.

Read guide
50

Real-Time-Bidding API

The Retreaver Real-Time-Bidding (RTB) API lets lead generators ping campaigns for a transfer number, reserve a buyer for the call, and get dynamic payouts. This guide walks through creating RTB links, publisher posting, confirmations and caps, troubleshoo

Read guide