Phone Assignment

Introduction

Control which phone numbers are used to make calls with the phone_assignment_mode setting. This affects which number appears on the lead's caller ID and can impact answer rates.

Phone Assignment Modes

Mode	Description	Use Case
`all`	Use any available phone number	Maximum flexibility, fastest call routing
`local`	Prefer phone numbers from the same country as the lead	Better call quality, local presence
`foreign`	Use phone numbers from different countries	International calling scenarios

When to Use Each Mode

All Mode

Use all when you want maximum availability and don't have specific requirements about which number appears on caller ID.

Example:

{
  "call": {
    "phone_assignment_mode": "all"
  }
}

Local Mode

Use local when you want calls to appear as local numbers to improve answer rates. This is especially useful for:

Building trust with local customers
Improving call answer rates
Compliance with local regulations
Better call quality (local-to-local routing)

Example:

{
  "call": {
    "phone_assignment_mode": "local"
  }
}

A lead in the United States will receive calls from a US phone number, while a lead in the United Kingdom will receive calls from a UK phone number.

Foreign Mode

Use foreign when you want calls to be made to leads from a phone number that is outside of their country.

Example:

{
  "call": {
    "phone_assignment_mode": "foreign"
  }
}

What If a Local or Foreign Number Isn't Available?

When you set phone_assignment_mode to local or foreign, Kejue will try to use a phone number that matches your selected mode for the lead’s country:

If no local or foreign number exists for that country: Kejue will automatically fall back to an all number so the call can still go through. This means the lead might see a number from another country, but the call will not be blocked.
If a suitable local or foreign number does exist but is currently busy: Kejue will wait until that specific number is free before making the call. This ensures the highest chance that the lead will see a number from the expected location on their caller ID.

This approach maximizes local or foreign number usage when possible, while still guaranteeing that calls are placed even if an exact match isn’t available.

{
  "call": {
    "phone_assignment_mode": "local",
    "call_start_hour": 9,
    "call_end_hour": 17
  }
}

Campaign with Local Assignment

{
  "schedule": {
    "phone_assignment_mode": "local",
    "call_start_hour": 9,
    "call_end_hour": 18
  }
}

All leads in the campaign will receive calls from phone numbers in their respective countries.

Calls - Learn about creating individual calls
Campaigns - Learn about batch campaigns
Call Scheduling - Control when calls are made

API Reference

Create Call - Full API documentation
Create Campaign - Campaign phone assignment options

Introduction