❗️
Our Click-to-Call (C2C) support API work asynchronously, returning an immediate confirmation like "Call originated successfully" upon initiation.
To track the call lifecycle—such as when the agent answers or the call ends—use webhooks that send real-time event updates to your configured endpoint.
For more details, please visit:
https://docs.acefone.co.uk/docs/web-hooks#/

Sample Request

curl --request POST \
     --url https://api-account-uk.acefone.com/v1/click_to_call_support \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

📘 Important!

Before we begin, note that the * sign denotes the mandatory variables in each table.

Request Variables (Body Params)

The following parameter is required to Initiate click to call support.

Variable Name	Description	Data Type
customer_number*	Customer’s number.	string
api_key*	API Key associated with the user.	string
caller_id	Uses the DID number to initiate the call, if it is pre-configured and valid under your account.	string
async*	Make multiple calls simultaneously, i.e don't wait for agent to pick up the call before sending back the response. 1: asynchronous request,	Integer
custom_identifier	Custom parameter that can be send while making a Click To Call request. This parameter will be returned in webhook. Note: This is a sample custom identifier, you can send your own custom parameters while making a request to Acefone. Note: The parameter name is flexible and can be modified based on the specific use case.	String
call_timeout	With the help of this request variable you can limit the time of the call. Call will auto disconnect after provided seconds have been reached in call duration.	Integer

Response Variables

The response returned is as following:

Variable Name	Description	Data Type
Success	The request success status, the possible values are: True (default) for success. False for failure.	Boolean
Message	The message corresponding to the success status. For example, in 400 Response where the "success" variable pops as True, the message displayed is shown here.	String