Connect Ringba · InboundX docs

Dial our number

In Ringba, 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 Ringba's documentation Quoted as the platform documents it.

Where to add a number targetDocumented: Targets → Manage Targets → Create Target
The number fieldDocumented: type: Numbernumber_field: Number

Targets › Manage Targets › Create Target

Name

InboundX

Number

BUYER_PHONE_NUMBER

Illustration: the menu path is from Ringba'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 Ringba. Where this goes in Ringba's screens isn't documented. What its documentation does say is below; confirm the screen with Ringba.

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

The caller's number on a forwarded callNot confirmed: confirm with Ringba
Passing the caller ID throughDocumented: Open the call-flow dial node configuration → Caller ID. The override accepts only numbers in the Ringba account.

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 Ringba which calls paid.

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

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

Turning off the call-length conversionDocumented: Convert On = Postback/Webhook waits for a third-party webhook to mark conversion; select it instead of Call length.

Tell your platform which calls paid

When a call pays, we call a URL on your platform with these tokens filled in. Here's where to find that URL:

In Ringba, open Integrations, then Webhooks, and copy the webhook URL. Put {CALL_ID} where it says [callUUID] and {PAYOUT} where it says [conversionAmount].

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 Ringba learns which calls paid.

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

Where conversions are set upDocumented: Integrations → Webhooks → Create Webhook: Call Token, Revenue Token, Fire Conversions; configure Convert On for postback/webhook.
Conversion URL templateDocumented: https://webhook.ringba.com/hook/{WEBHOOK_ID}?call_id={CALL_ID}&call_revenue={PAYOUT}&sale_successful=yes
Conversion caveatsDocumented: One conversion per inbound call ID; postback window is one month. Later adjustments require the documented manual path.
Converting on a postbackDocumented: On the static target in the campaign Routing Plan, choose Postback/Webhook in Convert On. Create the incoming conversion webhook under Integrations → Webhooks → Create Webhook.

Integrations › Webhooks › Create Webhook

Name

InboundX

Conversion URL

https://your-platform.example/conversion?call=…

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

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 Ringba to our number.
Check the call in your portal's call log. When it pays, check the conversion reached your platform.