Inbound Call Summary Statistics

API: inbound_summary_stats

Description

This endpoint provides a summarized report of inbound call activity for a given date range, optionally filtered by tenant. It returns daily metrics including total calls, queued calls, abandoned calls (split by those that waited more than 20 seconds), handled calls, and average hold and handle times.

🔗 URL

https://DOMAIN.croco-dial.net/goAPIv2/goReports/goAPI.php

Note: Replace DOMAIN with the specific domain you want to query.

📝 Required Parameters

Parameter	Value	Description
goAction	inbound_summary_stats	Action to perform. Name of endpoint
goUser	MyUser	API authorized user.
goPass	MyPass	Authorized user's password.
responsetype	json/xml	Format of the response (`json` recommended).

Optional Parameters

Parameter	Value	Description
fromDate	`YYYY-MM-DD`	The start date for the report.
toDate	`YYYY-MM-DD`	The end date for the report.
tenant	["AAA", "BBB"]	Array of tenant identifiers to restrict data.

Note: This endpoint uses body parameters for authentication instead of tokens or headers.

Request Examples:

GET:

curl -X GET "https://DOMAIN.croco-dial.net/goAPIv2/goReports/goAPI.php?goAction=inbound_summary_stats&goUser=MyUser&goPass=MyPass&responsetype=json&fromDate=2025-05-25&toDate=2025-05-30"

POST (Form Data)

If you prefer to send the data as form parameters:

curl -X POST "https://DOMAIN.croco-dial.net/goAPIv2/goReports/goAPI.php" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "goAction=inbound_summary_stats" \
  --data-urlencode "goUser=MyUser" \
  --data-urlencode "goPass=MyPass" \
  --data-urlencode "responsetype=json" \
  --data-urlencode "tenant[]=TTY" \
  --data-urlencode "fromDate=2025-05-20" \
  --data-urlencode "toDate=2025-05-30"

Example Response

{
    "result": "success",
    "data": {
        "rows": [
            {
                "calldate": "2025-05-28",
                "total_calls": "693",
                "queued_calls": "424",
                "abandon1": "38",
                "abandon2": "61",
                "handled_calls": "372",
                "avg_hold_time": "67.78",
                "avg_handle_time": "469.33"
            },
            {
                "calldate": "2025-05-29",
                "total_calls": "716",
                "queued_calls": "507",
                "abandon1": "42",
                "abandon2": "57",
                "handled_calls": "448",
                "avg_hold_time": "38.84",
                "avg_handle_time": "544.30"
            },
            {
                "calldate": "2025-05-30",
                "total_calls": "308",
                "queued_calls": "204",
                "abandon1": "54",
                "abandon2": "24",
                "handled_calls": "130",
                "avg_hold_time": "147.03",
                "avg_handle_time": "423.23"
            },
        ],
        "headers": [
           ...
        ]
    }
}

📌 Response Fields

Field	Description
`calldate`	The date of the call activity (`YYYY-MM-DD`).
`total_calls`	Total inbound calls received.
`queued_calls`	Calls that entered the queue.
`abandon1`	Calls abandoned after waiting more than 20 seconds.
`abandon2`	All abandoned calls, including those under 20 seconds.
`handled_calls`	Calls successfully answered by an agent.
`avg_hold_time`	Average hold time (in seconds).
`avg_handle_time`	Average handle time (in seconds).