Home > API Center > API interface guide
An AI-driven, multi-model collaborative end-to-end intelligent dialogue system delivers a lifelike voice outbound calling experience.

Obtain the values of API Key, API Secret, and appId.
You need to log on to the client to obtain the bitmap, as shown in the following figure.

Use Api Key + Api Secret + Timestamp to generate a MD5-32-bit string (case-insensitive) as the signature.
Example:
API Key: bDqJFiq9
API Secret: 7bz1lzh9
Current system Timestamp (seconds): 1630468800
MD5(bDqJFiq97bz1lzh91630468800): 05d7a50893e22a5c4bb3216ae3396c7c
According to requirements, you can refer to the feature function, call AI Agent group call task Interface for passing related parameters
| Function | Parameters | Parameter Value | Remarks |
|---|---|---|---|
| hang up SMS | none | none | The task dimension does not support hang up SMS; this function needs to be configured at the voice agent. Please explain the requirements to the business personnel in advance. |
| Timing call function | sendTime | Timed call time (null for immediate call) | |
| Task recalll: You can choose to recall all, recall failed, or recall by intent | recallFlow | Whether to enable recall: Set this field when recall is needed; leave it empty to disable recall | Recall related details need to be configured in the request. |
curl --location --request POST 'https://api.laaffic.com/voice/group/call/send/agent'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: a2d04f937f87aac9928d596bd033c8bf'
--header 'Timestamp: 1775014268'
--header 'Api-Key: SQLHdsQFe0Gk8ckwJZqcwxfUYRm0Qu0o'
--data-raw '{
"appId": "Jgd8oFei",//AI Agent Application ID
"taskName": "test",//Task Name
"displayNum": "123456",//Display Number
"maxCalls": 300, //Maximum call duration 300s
"maxRingingTime": 60, //Maximum ringing duration 60s
"agentId": 110, //Agent ID
"enableRecording": 1, //Enable recording
"sendTime": "2026-04-01 00:00:00", //Set scheduled sending time
"calloutRate": 1, //Set outbound call rate to 1
"numberInfoList": [
{
"calleeNumber": "919777654321", //Callee number
"text1":"David", //Callee Info(The borrower is a required parameter in debt collection scenarios, and can also be inserted as a variable into hang-up SMS.)
"text2":"5000", //Callee Info(The amount due is a mandatory parameter in debt collection scenarios, and it can also be inserted as a variable into hang-up SMS.)
"text3":"2026-04-10" //Callee Info(Repayment date is a mandatory parameter in debt collection scenarios, and it can also be inserted as a variable into hang-up SMS.)
},
{
"calleeNumber": "919777654321", //Callee number
"text1":"Oliver", //Callee Info(The borrower is a required parameter in debt collection scenarios, and can also be inserted as a variable into hang-up SMS.)
"text2":"1000", //Callee Info(The amount due is a mandatory parameter in debt collection scenarios, and it can also be inserted as a variable into hang-up SMS.)
"text3":"2026-04-10" //Callee Info(Repayment date is a mandatory parameter in debt collection scenarios, and it can also be inserted as a variable into hang-up SMS.)
}
],
"recallFlow": {
"recallType": 3, //Recall by intent
"recallInterval": 1, //Recall interval set to 1 minute
"recallNum": 2, //Recall 2 times
"nodeList": [
{
"agentId": "110"
},
{
"agentId": "110"
}
],
"recallIntent": [
"99999" //Recall intention set to called but not connected
]
}
}'
Note: The numberInfoList contains all called numbers and called information. calleeNumber represents the called number, and text1/text2/text3 represent the called information. It can be used as an interface parameter in financial collection scenarios and financial collection-emergency contact relay scenarios, or it can be inserted as a variable into the content of the hang-up SMS.
When the user configures an http push address on the account setting-voice application management page, the platform will actively push the voice and status report of the http-api to the user to configure the address
You can log in to the client settings, the specific location is shown in the figure.

The following are several common error code causes and handling methods, which can be seen globally Global Status Code
| Status | Reason | Description |
|---|---|---|
| -1 | Authentication error | Check the parameter values of API Key, API Secret, and appId. |
| -18 | Port program unusual | Check whether the request body is in json format. |
| -22 | The length of the nodeList parameter is incorrect | The number of redial attempts (recallNum) does not match the number of nodes in nodeList. Please adjust them to be consistent. |
| -67 | The AI agent industry's intent does not match the callback intent | Check the recallIntent parameter value. |
Questions about integration? Contact our technical support
LAAFFIC API dedicated TG technical support channel, real-time response to your needs