Skip to main content

Generator setup with Retreaver

Updated over a year ago

Part I: Setting up TrueCall

1. First you will log in to your TrueCall account and select the “campaigns” tab on the left hand side of your screen.

Then in the upper right hand corner you will select "Add Campaign"

You will create your campaign by naming it.

You will then whitelist the domains that you will be using for this campaign.

2. From here you will select Retreaver as your call tracking platform.

You will now configure your Dynamic Number Insertion (DNI) settings. We have recommended settings setup, you will need to enter the number of visits per hour your lander revives, and then mark this as completed.

3. The next step is to connect this campaign to TrueAds, this step is optional. To connect to TrueAds, you will first link your Facebook Ad account by clicking "add account". Once your account is connected you will be able to select it similar to the example accounts below.

Part II: Setting Up Number Pools

Note: If you are already set up with Number Pools and the Retreaver.js script on your website, you can skip ahead in this article

1. In Retreaver go to Campaigns > Create a new campaign

2. Create 1 number which will serve as the number Retreaver will dynamically replace

3. Create a number pool.

Use our number pool settings calculator to configure your number pool settings based on the amount of traffic you average per hour. Having inadequate numbers in your number pool may cause TrueCall IDs to fail.
Just because a TrueCall ID fails, it does not mean your call will be blocked, it just means that the End User may not accept the call, but you could still route the call elsewhere.


4. Go to Retreaver JS Settings > Number Replacement

Take the 1 number you created ( not the number pool) and add formatted variations of the number like so:

5. Go to Retreaver JS Settings > Parameter Mappers
Add the tag key “tc_id” and URL parameter “tc_id

6. Go to Retreaver JS Settings > Code

7. Copy paste the Retreaver JS Code to the Head of your Website.

Part III: Installing the TrueCall Script


1. You will be given two choices for how you install the TrueCall script on your landing pages. There is a default option and an advanced option. (For advance options please follow this link: https://help.truecall.com/en/articles/9797327-truecall-advanced-generator-setup)

After selecting the default option you will enter the phone number from your landing page that will be replaced by the DNI.

2. You will then choose whether to tag the TrueCall ID using URL parameters, this is our default setting and the less advanced setup. The other option is to use JS tagging which is a slightly more involved process. (Please click this link for JS Tagging setup: https://help.truecall.com/en/articles/9797332-truecall-generator-setup-js-tagging)

3. Add the TrueCall script to the head of your website before any other script. After you deploy these changes, you can test your script by entering the website page URL​.

Part IV: Adding your webhook to Retreaver

1.From Build your payload copy the webhook URL


2. In Retreaver go to Campaign > Edit
Add a webhook that fires on “When a call comes in” and paste the TrueCall webhook URL


3. Click “Update Campaign” button



How to send the TCID to the End User

1. Receive from the End User the endpoint to which you will send the TCID to be verified. The End User must provide this to you

2. In Retreaver go to Campaign > Edit > Webhooks > Add
Set up the webhook to fire “When a buyer is selected


Copy paste the endpoint the End User provides with the correct tokens for example:

https://example.com?callerid=[caller_number]&tc_id=[TC_ID]&did=[called_number]

Did this answer your question?