Skip to main content
POST
Create an inbound assistant
Creates a new inbound dialer. An inbound dialer binds an existing assistant (or IVR assistant) to a dialer phone number, so that incoming calls placed to that number are handled automatically by the selected assistant. Set notification to true to enable notifications for incoming calls handled by this inbound assistant.
To actually receive incoming calls, configure your telephony provider (e.g. Twilio) to send call webhooks to https://api.qcall.ai/inbound. See Twilio’s TwiML request documentation for more details.

Authorizations

x-api-key
string
header
required

Body

application/json

Inbound assistant to add

name
string
required

The name of the inbound assistant

assistant_id
string
required

ID of the assistant (or IVR assistant) that will handle the inbound calls

dialer_id
string
required

ID of the dialer whose phone number receives the inbound calls

notification
boolean
default:false

Whether to enable notifications for incoming calls handled by this inbound assistant

Response

Inbound assistant response

id
string
required

Unique identifier of the inbound assistant

name
string
required

The display name of the inbound assistant

assistant_id
string
required

ID of the assistant that answers the inbound calls

dialer_id
string
required

ID of the dialer that provides the phone number

assistant_name
string

Name of the linked assistant

phone_number
string

Phone number the inbound assistant is attached to

incoming_count
integer<int32>

Number of incoming calls handled by this inbound assistant

notification
boolean

Whether notifications are enabled for incoming calls handled by this inbound assistant