Type d’événement :
CallEndedEnvoyé chaque fois qu’un appel effectué par une campagne se termine, quel que soit son résultat. La charge utile contient les détails de l’appel : le numéro appelé et ses valeurs de variables, les résultats de sonnerie et de réponse, les durées, les résultats des interactions avec le destinataire (comme les saisies DTMF ou les objectifs de l’agent IA), les détails du transfert, et le résultat final (outcome) de l’appel, y compris lorsqu’une nouvelle tentative est prévue.
C’est l’événement à utiliser pour mettre à jour vos propres systèmes, comme un CRM, avec le résultat de chaque appel.
Valeurs possibles des énumérations utilisées dans la charge utile :
Résultat de sonnerie
AnswerBusyNoAnswerCallErrorType de réponse
HumanMachineVoicemailMessageUnknownType de fin
HangUpCallflowCompleteExecutionErrorType de dernière action
TransferCallTextPromptWavPromptDtmfInputDropCallRésultat du transfert
ConnectedNotConnectedLocuteur de la transcription (A : agent IA, B : contact)
ABType d'agent IA
AiAgentAmdAgentRésultat final
SuccessFailureWithNoRetryLeftFailureWithRetryPending"transcription" n'est renseigné que lorsque l'appel a utilisé un agent IA avec les transcriptions activées ; sinon, il vaut null. Il contient une entrée par message, dans l'ordre : "at" est le moment où le message a commencé, en millisecondes depuis le début de l'appel ; "by" indique qui l'a dit, A pour l'agent IA ou B pour le contact ; et "text" est ce qui a été dit.
"aiModelsUsage" n'est renseigné que lorsque l'appel a utilisé un fournisseur d'IA (un agent conversationnel IA ou un agent de détection de messagerie vocale par IA) ; sinon, il vaut null. Son "transcriptionModel" vaut null lorsque les transcriptions étaient désactivées pour l'appel, ou lorsque le fournisseur d'IA n'a pas de modèle de transcription distinct.
"mcpServersUsage" n'est renseigné que lorsque l'agent IA a invoqué au moins un outil d'un serveur MCP pendant l'appel ; sinon, il vaut null. Il contient une entrée par serveur MCP, avec le nombre d'invocations réussies et échouées de chacun de ses outils.
Charge utile CallEnded (v2) · Campagnes en mode Numéroteur Puissant et Numéroteur Prédictif
{
"id": "01928322-860c-77f9-9c3b-7f8abe3b6afd",
"object": "event",
"apiVersion": 2,
"createdAt": "2024-10-12T23:48:50.824",
"type": "CallEnded",
"data": {
"customer": {
"id": "0192830c-58a0-7be2-8e3d-dc8997d0a631",
"name": "SIP Caller (Demo account)"
},
"campaign": {
"id": "0192831a-fbbe-735f-b385-a3252781817d",
"name": "Campaign 1",
"varNames": [
"Customer Name",
"Due Balance"
]
},
"callDetails": {
"callId": "01928322-32a3-7000-bf0d-bf1af7eda4c5",
"numberId": 1048165,
"prefix": "",
"number": "18035551004",
"calledNumber": "18035551004",
"varValues": [
"Stefan Robertson",
"$99.00 "
],
"attempt": 1,
"addedAt": "2024-10-12T10:05:23.452",
"phoneSystem": {
"id": "01928310-2d96-7a70-bdfc-4bcd24c22c95",
"name": "My Phone System",
"extension": {
"id": "07bcd1de-1e5d-47b5-99bf-b846c7a12f09",
"name": "SIP Caller Extension"
}
},
"queueId": "800",
"agentId": "101",
"timeZoneId": "America/Argentina/Buenos_Aires",
"startedAt": "2024-10-12T23:48:29.479",
"ringResult": "Answer",
"sipResponse": {
"code": 200,
"descrip": "OK"
},
"answeredAt": "2024-10-12T23:48:33.735",
"answerType": "Human",
"answerMessage": null,
"voicemailLeft": false,
"callflow": {
"id": "01928316-cfd7-75c7-bb6d-9128e205c53f",
"name": "Survey"
},
"endedAt": "2024-10-12T23:48:50.819",
"endType": "CallflowComplete",
"lastAction": {
"id": "535248e9-c9a2-4a15-8c1c-9d175f82ac21",
"type": "TextPrompt"
},
"duration": {
"setup": "00:00:04.256",
"connected": "00:00:17.084",
"total": "00:00:21.34"
},
"interactionResults": [
{
"id": "a6d5b2e5-6b3f-49d8-aaa3-bc7b4c693f05",
"type": "DtmfInput",
"label": "Question 1",
"value": "1"
},
{
"id": "af5fd8d6-2ed4-4546-bb50-1b4214b71f7a",
"type": "DtmfInput",
"label": "Question 2",
"value": "2"
}
],
"transcription": [
{
"at": 4512,
"by": "A",
"text": "Hello, am I speaking with Stefan Robertson?"
},
{
"at": 7983,
"by": "B",
"text": "Yes, speaking."
}
],
"aiModelsUsage": {
"agentType": "AiAgent",
"aiProvider": {
"id": "01a0b12c-58ef-754e-82a6-56e0b7d009e4",
"name": "OpenAI Provider"
},
"liveAudioModel": {
"tokens": {
"input": {
"text": 50854,
"audio": 2408
},
"output": {
"text": 193,
"audio": 521
},
"reasoning": 0,
"cachedInput": {
"text": 38912,
"audio": 1280
}
},
"modelId": "gpt-realtime",
"seconds": 47.217
},
"transcriptionModel": {
"tokens": {
"input": 1206,
"output": 87
},
"modelId": "gpt-4o-mini-transcribe",
"seconds": 31.842
}
},
"mcpServersUsage": [
{
"tools": [
{
"name": "search_crm_objects",
"failed": 0,
"succeeded": 2
},
{
"name": "update_crm_object",
"failed": 1,
"succeeded": 1
}
],
"mcpServerId": "01a0cee1-f1c1-7eda-b64e-8642ea47031a",
"mcpServerName": "Hubspot"
}
],
"outcome": "Success",
"retryAt": null
}
}
}Charge utile CallEnded (v2) · Campagnes en mode Numéroteur Progressif
{
"id": "01928322-860c-77f9-9c3b-7f8abe3b6afd",
"object": "event",
"apiVersion": 2,
"createdAt": "2024-10-12T23:48:50.824",
"type": "CallEnded",
"data": {
"customer": {
"id": "0192830c-58a0-7be2-8e3d-dc8997d0a631",
"name": "SIP Caller (Demo account)"
},
"campaign": {
"id": "0192831a-fbbe-735f-b385-a3252781817d",
"name": "Campaign 1",
"varNames": [
"Customer Name",
"Due Balance"
]
},
"callDetails": {
"callId": "01928322-32a3-7000-bf0d-bf1af7eda4c5",
"numberId": 1048165,
"prefix": "",
"number": "18035551004",
"calledNumber": "18035551004",
"varValues": [
"Stefan Robertson",
"$99.00 "
],
"attempt": 1,
"addedAt": "2024-10-12T10:05:23.452",
"phoneSystem": {
"id": "01928310-2d96-7a70-bdfc-4bcd24c22c95",
"name": "My Phone System",
"extension": {
"id": "07bcd1de-1e5d-47b5-99bf-b846c7a12f09",
"name": "SIP Caller Extension"
}
},
"queueId": "800",
"agentId": "101",
"timeZoneId": "America/Argentina/Buenos_Aires",
"startedAt": "2024-10-12T23:48:29.479",
"ringResult": "Answer",
"sipResponse": {
"code": 200,
"descrip": "OK"
},
"answeredAt": "2024-10-12T23:48:33.735",
"answerType": "Human",
"answerMessage": null,
"voicemailLeft": false,
"callflow": {
"id": "01928316-cfd7-75c7-bb6d-9128e205c53f",
"name": "Survey"
},
"endedAt": "2024-10-12T23:48:50.819",
"endType": "CallflowComplete",
"lastAction": {
"id": "535248e9-c9a2-4a15-8c1c-9d175f82ac21",
"type": "TextPrompt"
},
"duration": {
"setup": "00:00:04.256",
"connected": "00:00:17.084",
"total": "00:00:21.34"
},
"interactionResults": [
{
"id": "a6d5b2e5-6b3f-49d8-aaa3-bc7b4c693f05",
"type": "DtmfInput",
"label": "Question 1",
"value": "1"
},
{
"id": "af5fd8d6-2ed4-4546-bb50-1b4214b71f7a",
"type": "DtmfInput",
"label": "Question 2",
"value": "2"
}
],
"transfer": {
"duration": "00:00:51.877",
"result": "NotConnected",
"connectedAt": null
},
"agent": {
"releasedAt": "2025-09-17T21:00:25.94",
"duration": {
"setup": "00:00:58.716",
"connected": "00:00:00",
"total": "00:00:58.716"
}
},
"outcome": "Success",
"retryAt": null
}
}
}