Elencare i dettagli delle chiamate
/v1/accounts/{accountId}/campaigns/{campaignId}/reports/callDetailsRestituisce i dettagli delle chiamate effettuate da una campagna, con filtri e ordinamento opzionali.
Parametri di percorso
ID del tuo account SIP Caller. Consulta ID dell'account.
ID della campagna.
Parametri di query
Condizioni che i record devono soddisfare, ad esempio {"name":"sales"}. Consulta i Campi di filtro più avanti, e Filtro per la sintassi.
Campo e direzione utilizzati per ordinare i record, ad esempio ["startedAtLocal","DESC"]. Il valore predefinito è ["startedAtLocal","ASC"]. Consulta Ordinamento.
Posizioni, a partire da zero, del primo e dell'ultimo record da restituire, entrambi inclusi, ad esempio [0,99]. Il valore predefinito è [0,9]. Consulta Paginazione.
Campi di filtro
Campi utilizzabili nel parametro di query filter. Consulta Filtro per la sintassi generale.
Chiamate verso numeri che contengono il testo.
{"number":"555100"}Chiamate la cui variabile contiene il testo (senza distinzione tra maiuscole e minuscole). La chiave è $ seguito dalla posizione della variabile, a partire da 1.
{"varValues":{"$1":"robertson"}}Chiamate il cui numero composto contiene il testo.
{"calledNumber":"9555100"}Chiamate effettuate con il prefisso indicato.
{"numberPrefix":"9"}_gt_gte_lt_lteChiamate per numero di tentativo.
{"attempt":1}_gt_gte_lt_lteChiamate per data e ora di aggiunta del numero.
{"addedAtLocal_gte":"2026-10-01T00:00:00"}_gt_gte_lt_lteChiamate per data e ora di inizio.
{"startedAtLocal_gte":"2026-10-01T00:00:00","startedAtLocal_lt":"2026-10-02T00:00:00"}_gt_gte_lt_lteChiamate per data e ora di risposta.
{"answeredAtLocal_gte":"2026-10-01T00:00:00"}_gt_gte_lt_lteChiamate per data e ora di fine.
{"endedAtLocal_lt":"2026-10-02T00:00:00"}Chiamate con il risultato dello squillo indicato.
AnswerNoAnswerBusyCallError{"ringResult":"Answer"}Chiamate con il codice di risposta SIP indicato.
{"sipResponseCode":486}Chiamate con il tipo di risposta indicato.
HumanMachineVoicemailMessageUnknown{"answerType":"Human"}Chiamate con il tipo di terminazione indicato.
CallflowCompleteInteractionCompleteHangUpExecutionError{"endType":["CallflowComplete","InteractionComplete"]}Chiamate la cui ultima azione corrisponde.
{"lastAction":{"$t":"TransferCall"}}Chiamate in cui è stato lasciato, o meno, un messaggio in segreteria.
{"voicemailLeft":true}Chiamate i cui dettagli dell'errore contengono il testo.
{"errorDetails":"timeout"}Chiamate con i risultati di interazione indicati. Ogni chiave è l'ID dell'azione di input DTMF o dell'obiettivo dell'agente IA, e ogni valore è il risultato atteso.
{"inputResults":{"a6d5b2e5-6b3f-49d8-aaa3-bc7b4c693f05":"1"}}Chiamate la cui conversazione contiene il testo.
{"transcriptions":"call me back"}Chiamate gestite dalla coda indicata.
{"queueId":"800"}Chiamate gestite dall'agente indicato.
{"agentId":"101"}Chiamate con il risultato del trasferimento indicato.
ConnectedNotConnectedConnectionUnknown{"transferResult":"NotConnected"}_gt_gte_lt_lteChiamate per data e ora in cui il numero esterno ha risposto alla chiamata trasferita.
{"transferConnectedAtLocal_gte":"2026-10-01T00:00:00"}_gt_gte_lt_lteChiamate per data e ora in cui è terminata la chiamata tra l'agente e il numero esterno.
{"agentReleasedAtLocal_gte":"2026-10-01T00:00:00"}_gt_gte_lt_lteChiamate per durata di impostazione. Lo stesso vale per connectedDuration, totalDuration, transferDuration, agentSetupDuration, agentConnectedDuration e agentTotalDuration.
{"connectedDuration_gte":"00:01:00"}Chiamate con l'esito indicato.
SuccessFailureWithRetryPendingFailureWithNoRetryLeft{"outcome":"Success"}Campi di ordinamento
Campi utilizzabili nel parametro di query sort, in ordine crescente (ASC) o decrescente (DESC). Consulta Ordinamento per la sintassi generale. Se sort viene omesso, i risultati sono ordinati per startedAtLocal in ordine crescente.
startedAtLocalnumberaddedAtLocalattemptringResultsipResponseCodeansweredAtLocalanswerTypeendedAtLocalendTypesetupDurationconnectedDurationtotalDurationtransferDurationtransferConnectedAtLocalagentReleasedAtLocalagentSetupDurationagentConnectedDurationagentTotalDurationoutcomeRestituisce
Restituisce un array di oggetti dettagli della chiamata per la pagina richiesta. Le intestazioni X-Total-Count e Content-Range contengono il numero totale di record che corrispondono al filtro, ad esempio Content-Range: callDetails 0-9/57. Consulta Paginazione.
/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/reports/callDetails
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/campaigns/CAMPAIGN_ID/reports/callDetails' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"startedAtLocal_gte":"2026-10-01T00:00:00","ringResult":"Answer"}' \
--data-urlencode 'sort=["startedAtLocal","ASC"]' \
--data-urlencode 'range=[0,99]'Risposta
200 OK
[
{
"id": "01928322-32a3-7000-bf0d-bf1af7eda4c5",
"numberId": 1048165,
"number": "+18035551004",
"varValues": [
"Stefan Robertson",
"$99.00"
],
"addedAtLocal": "2026-10-01T10:05:23.452",
"attempt": 1,
"numberPrefix": "",
"calledNumber": "+18035551004",
"queueId": "800",
"agentId": "101",
"startedAtLocal": "2026-10-01T11:48:29.479",
"ringResult": "Answer",
"sipResponseCode": 200,
"sipResponseDescrip": "OK",
"answeredAtLocal": "2026-10-01T11:48:33.735",
"answerType": "Human",
"endedAtLocal": "2026-10-01T11:48:50.819",
"endType": "CallflowComplete",
"lastAction": {
"$t": "DtmfInput"
},
"voicemailLeft": false,
"errorDetails": null,
"inputResults": [
{
"inputActionId": "a6d5b2e5-6b3f-49d8-aaa3-bc7b4c693f05",
"inputValue": "1"
}
],
"transcriptions": null,
"setupDuration": "00:00:04.256",
"connectedDuration": "00:00:17.084",
"totalDuration": "00:00:21.340",
"transferDuration": null,
"transferResult": null,
"transferConnectedAtLocal": null,
"agentReleasedAtLocal": null,
"agentSetupDuration": null,
"agentConnectedDuration": null,
"agentTotalDuration": null,
"outcome": "Success"
}
]
