Home > API Center > API interface guide

 

Quick Start - AI Agent Group Call

AI Agent

An AI-driven, multi-model collaborative end-to-end intelligent dialogue system delivers a lifelike voice outbound calling experience.

AI Agent Group Call Integration Process

 

Pre-preparation

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.

 

Sign signature rule

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

 

API docking process

 

01Create AI Agent group call task

According to requirements, you can refer to the feature function, call AI Agent group call task Interface for passing related parameters

Features

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.

 

02Status Report Push

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.

 

Reference Information

Quick Check of Common Error Codes

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.

Was this page helpful?

Questions about integration? Contact our technical support

LAAFFIC API dedicated TG technical support channel, real-time response to your needs

Contact via Telegram

Telegram
WhatsApp
Chat with us!
Need help?
Click here and start chatting with us!