# Agent Calls Summary Report

## <span style="color: rgb(2, 106, 73);">**API: agent\_calls\_report**</span>

### **Description**

This endpoint provides detailed information of agent. Shows a breakdown of call metrics for each agent, including average talk time, total calls, and call types (manual, inbound, dialer).

## 🔗 **URL**

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

<p class="callout info align-left">**Note:** Replace `DOMAIN` with the specific domain you want to query.</p>

### **📝 Required Parameters**

<table border="1" id="bkmrk-parameter-value-desc" style="border-collapse: collapse; width: 100%; height: 149.934px;"><colgroup><col style="width: 23.0008%;"></col><col style="width: 27.9976%;"></col><col style="width: 48.9896%;"></col></colgroup><thead><tr style="height: 29.7167px;"><td style="height: 29.7167px;">**Parameter**</td><td style="height: 29.7167px;">**Value**</td><td style="height: 29.7167px;">**Description**</td></tr></thead><tbody><tr style="height: 29.7167px;"><td style="height: 29.7167px;">goAction</td><td style="height: 29.7167px;">**agent\_calls\_report**</td><td style="height: 29.7167px;">Action to perform</td></tr><tr style="height: 29.7167px;"><td style="height: 29.7167px;">goUser</td><td style="height: 29.7167px;">MyUser</td><td style="height: 29.7167px;">API authorized user.</td></tr><tr style="height: 29.7167px;"><td style="height: 29.7167px;">goPass</td><td style="height: 29.7167px;">MyPass</td><td style="height: 29.7167px;">Authorized user's password.</td></tr><tr style="height: 31.0667px;"><td style="height: 31.0667px;">responsetype</td><td style="height: 31.0667px;">json/xml</td><td style="height: 31.0667px;">Format of the response (`json` recommended).</td></tr></tbody></table>

### **Optional Parameters**

<table border="1" id="bkmrk-parameter-value-desc-1" style="border-collapse: collapse; width: 100%; height: 183.7px;"><colgroup><col style="width: 23.0008%;"></col><col style="width: 28.0062%;"></col><col style="width: 48.9811%;"></col></colgroup><thead><tr style="height: 29.7167px;"><td style="height: 29.7167px;">**Parameter**</td><td style="height: 29.7167px;">**Value**</td><td style="height: 29.7167px;">**Description**</td></tr></thead><tbody><tr style="height: 29.7167px;"><td style="height: 29.7167px;">user</td><td style="height: 29.7167px;">\['example.user1', 'example.user2'\]</td><td style="height: 29.7167px;">A list of specific users to include in the report.</td></tr><tr style="height: 31.0667px;"><td style="height: 31.0667px;">tenant</td><td style="height: 31.0667px;">\['AAA', 'BBB'\]</td><td style="height: 31.0667px;"><span class="_fadeIn_m1hgl_8">A </span><span class="_fadeIn_m1hgl_8">list </span><span class="_fadeIn_m1hgl_8">of </span><span class="_fadeIn_m1hgl_8">tenants </span><span class="_fadeIn_m1hgl_8">to </span><span class="_fadeIn_m1hgl_8">filter </span><span class="_fadeIn_m1hgl_8">the </span><span class="_fadeIn_m1hgl_8">results. (Three characters only)</span></td></tr><tr style="height: 31.0667px;"><td style="height: 31.0667px;">profile</td><td style="height: 31.0667px;">\['SERVERS', 'COLLECTIONS'\]</td><td style="height: 31.0667px;"><span class="_fadeIn_m1hgl_8">A </span><span class="_fadeIn_m1hgl_8">list </span><span class="_fadeIn_m1hgl_8">of </span><span class="_fadeIn_m1hgl_8">profiles </span><span class="_fadeIn_m1hgl_8">to </span><span class="_fadeIn_m1hgl_8">filter </span><span class="_fadeIn_m1hgl_8">the </span><span class="_fadeIn_m1hgl_8">results.</span></td></tr><tr style="height: 31.0667px;"><td style="height: 31.0667px;">fromDate</td><td style="height: 31.0667px;">`YYYY-MM-DD`</td><td style="height: 31.0667px;"><span class="_fadeIn_m1hgl_8">The </span><span class="_fadeIn_m1hgl_8">start </span><span class="_fadeIn_m1hgl_8">date </span><span class="_fadeIn_m1hgl_8">for </span><span class="_fadeIn_m1hgl_8">the </span><span class="_fadeIn_m1hgl_8">report. </span><span style="color: rgb(22, 145, 121);"><span class="_fadeIn_m1hgl_8">If </span><span class="_fadeIn_m1hgl_8">no </span><span class="_fadeIn_m1hgl_8">date </span><span class="_fadeIn_m1hgl_8">range </span><span class="_fadeIn_m1hgl_8">is </span><span class="_fadeIn_m1hgl_8">provided, </span><span class="_fadeIn_m1hgl_8">the </span><span class="_fadeIn_m1hgl_8">endpoint </span><span class="_fadeIn_m1hgl_8">defaults </span><span class="_fadeIn_m1hgl_8">to </span><span class="_fadeIn_m1hgl_8">returning </span><span class="_fadeIn_m1hgl_8">records </span><span class="_fadeIn_m1hgl_8">from </span><span class="_fadeIn_m1hgl_8">the </span><span class="_fadeIn_m1hgl_8">last </span><span class="_fadeIn_m1hgl_8">24 </span><span class="_fadeIn_m1hgl_8">hours.</span></span></td></tr><tr style="height: 31.0667px;"><td style="height: 31.0667px;">toDate</td><td style="height: 31.0667px;">`YYYY-MM-DD`</td><td style="height: 31.0667px;">The end date for the report.</td></tr></tbody></table>

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

### **Request Examples:**

#### **GET:**

```bash
curl -X GET "https://DOMAIN.croco-dial.net/goAPIv2/goReports/goAPI.php?goAction=agent_calls_report&goUser=MyUser&goPass=MyPass&responsetype=json&profile[]=SERVERS&tenant[]=GAL&fromDate=2025-05-12&toDate=2025-05-14"

```

#### **POST (Form Data)**

If you prefer to send the data as form parameters:

```bash
curl -X POST "https://DOMAIN.croco-dial.net/goAPIv2/goReports/goAPI.php" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "goAction=agent_calls_report" \
  --data-urlencode "goUser=MyUser" \
  --data-urlencode "goPass=MyPass" \
  --data-urlencode "responsetype=json" \
  --data-urlencode "profile[]=SERVERS" \
  --data-urlencode "tenant[]=GAL" \
  --data-urlencode "fromDate=2025-05-12" \
  --data-urlencode "toDate=2025-05-14"
```

####  **Example Response**

```json
{
    "result": "success",
    "data": {
        "agent_report": {
            "headers": [
              ...
            ],
            "rows": [
                {
                    "user": "User.Example1",
                    "profile": "Collections",
                    "portfolio": "GAL",
                    "avg_talk": "43",
                    "total_calls": "577",
                    "manual": "9",
                    "inbound": "12",
                    "dialer": "0"
                },
                {
                    "user": "User.Example2",
                    "profile": "Servers",
                    "portfolio": "CSC",
                    "avg_talk": "67",
                    "total_calls": "245",
                    "manual": "24",
                    "inbound": "22",
                    "dialer": "0"
                },
                {
                    "user": "User.Example3",
                    "profile": "VIP",
                    "portfolio": "ADMIN",
                    "avg_talk": "46",
                    "total_calls": "887",
                    "manual": "235",
                    "inbound": "41",
                    "dialer": "0"
                },
              ...
            ]
        },
        "frequency_report": {
            "headers": [],
            "rows": []
        }
    }
}
              
```

### <span class="_fadeIn_m1hgl_8">📌 </span>**<span class="_fadeIn_m1hgl_8">Response </span><span class="_fadeIn_m1hgl_8">Fields</span>**

<table border="1" id="bkmrk-field-description-us" style="width: 77.619%; border-collapse: collapse; border-color: rgb(206, 212, 217); height: 270.672px;"><thead><tr style="height: 29.7969px;"><th style="width: 25.8437%; height: 29.7969px;">**Field**</th><th style="width: 74.3099%; height: 29.7969px;">**Description**</th></tr></thead><tbody><tr style="height: 30.1094px;"><td style="width: 25.8437%; height: 30.1094px;">**user**</td><td style="width: 74.3099%; height: 30.1094px;">Username of the agent.</td></tr><tr style="height: 30.1094px;"><td style="width: 25.8437%; height: 30.1094px;">**profile**</td><td style="width: 74.3099%; height: 30.1094px;">Profile assigned to the agent (e.g., Servers, Loan, VIP).</td></tr><tr style="height: 30.1094px;"><td style="width: 25.8437%; height: 30.1094px;">**portfolio**</td><td style="width: 74.3099%; height: 30.1094px;">The portfolio associated with the agent (e.g., CSC, GAL).</td></tr><tr style="height: 30.1094px;"><td style="width: 25.8437%; height: 30.1094px;">**avg\_talk**</td><td style="width: 74.3099%; height: 30.1094px;">Average handle time of the agent in seconds.</td></tr><tr style="height: 30.1094px;"><td style="width: 25.8437%; height: 30.1094px;">**total\_calls**</td><td style="width: 74.3099%; height: 30.1094px;">Total number of calls handled.</td></tr><tr style="height: 30.1094px;"><td style="width: 25.8437%; height: 30.1094px;">**manual**</td><td style="width: 74.3099%; height: 30.1094px;">Number of manual calls made.</td></tr><tr style="height: 30.1094px;"><td style="width: 25.8437%; height: 30.1094px;">**inbound**</td><td style="width: 74.3099%; height: 30.1094px;">Number of inbound calls received.</td></tr><tr style="height: 30.1094px;"><td style="width: 25.8437%; height: 30.1094px;">**dialer**</td><td style="width: 74.3099%; height: 30.1094px;">Number of dialer calls made.</td></tr></tbody></table>