Connect CallGrid · InboundX docs

Dial our number

In CallGrid, add InboundX as a target that sends calls to this phone number. Every call you send to it reaches us; there's no ping.

Our phone number

BUYER_PHONE_NUMBER

This one is a sample. Copy yours from your setup message or the portal's Setup page.

From CallGrid's documentation Quoted as the platform documents it.

Where to add a number targetDocumented: Buyers → Destinations → New Destination; choose Static destination for fixed routing and the Static Number phone option.
The number fieldNot confirmed: confirm with CallGrid

Buyers › Destinations › New Destination

Name

InboundX

Number

BUYER_PHONE_NUMBER

Illustration: the menu path is from CallGrid's documentation; the screen may look different.

Keep the caller's own number

This is our requirement: the call must reach our number with the caller's own number as the caller ID. We tell calls apart by that number, so your own number, or a hidden one, won't work.

Not confirmed for CallGrid. Where CallGrid sets the caller ID on a call to a number isn't confirmed. Confirm with CallGrid that it passes the caller's own number through.

From CallGrid's documentation Quoted as the platform documents it.

The caller's number on a forwarded callNot confirmed: confirm with CallGrid
Passing the caller ID throughNot confirmed: confirm with CallGrid

Don't convert on call length

This campaign pays when the call qualifies, not after a number of seconds. Turn off any duration conversion on the target that dials our number. The postback in the next step tells CallGrid which calls paid.

Not confirmed for CallGrid. How CallGrid turns off a duration conversion isn't confirmed. Confirm with CallGrid that only the postback marks a call as paid.

From CallGrid's documentation Quoted as the platform documents it.

Turning off the call-length conversionNot confirmed: confirm with CallGrid

Tell your platform which calls paid

This is our requirement: when a call pays, we call your platform's conversion URL with these tokens filled in, so it learns which calls paid.

Your call ID

{CALL_ID}

What the call earned, in US dollars

{PAYOUT}

The caller's number

{PHONE}

It should end up like this

https://your-platform.example/conversion?call={CALL_ID}&phone={PHONE}&payout={PAYOUT}

Required: it's the only way CallGrid learns which calls paid.

Not confirmed for CallGrid. Where this goes in CallGrid's screens isn't documented. What its documentation does say is below; confirm the screen with CallGrid.

From CallGrid's documentation Quoted as the platform documents it.

Conversion endpointDocumented: path: /api/postback/event/{POSTBACK_ID}methods: GET, POSTquery_fields: organizationId, callIdprefer: callId
Conversion amount fieldNot confirmed: confirm with CallGrid
Converting on a postbackCheck in your platform: The destination guide documents Webhook as buyer-confirmed conversion, as an alternative to Duration.
Its conversion URLDocumented: origin: https://api.callgrid.compath: /api/postback/event/{id}method: GETid: Postback IDquery_parameters: organizationId, callIdcallId: Exact call match, preferred over callerId.
A conversion pixel URLNot confirmed: confirm with CallGrid
Pixel placeholdersNot confirmed: confirm with CallGrid

Test my setup

A number has no ping to test. Make one real test call:

Tell your buyer when you're ready, so they can watch the first call arrive.
Send one real call through CallGrid to our number.
Check the call in your portal's call log. When it pays, check the conversion reached your platform.