POST

Calltrack.Stats

Return Call Center summary stats from recordings (same KPIs as dashboard/calltrack). Supports an optional month filter. Today metrics use the server calendar date and are counted inside the selected month window when month is sent.

Permissions

  • On a company subdomain (e.g. https://{user_domain}.bull36.com) the user must match that Host — Login and protected APIs reject another company with success=0, error user_not_in_company. On a main brand host (bull36.com, biz1.co.il, mastrocrm.com, …) the company domain gate is skipped.
  • Owner and member admin see the full organization team scope. Regular team members see only their own calls. Optional team_member_id must be inside that scope.

Action

  • Runs the Calltrack.Stats function and returns JSON.

Push Service

No push is sent because this function only reads data or returns helper information.

Automation

No automation is run for this function.

Special Instructions

  • On a company subdomain (e.g. https://{user_domain}.bull36.com) the user must match that Host — Login and protected APIs reject another company with success=0, error user_not_in_company. On a main brand host (bull36.com, biz1.co.il, mastrocrm.com, …) the company domain gate is skipped.
  • Pass month as YYYY-MM (example: 2026-10) to get total_call_per_month for that month.
  • Omit month to get all-time totals (same as opening calltrack without a month filter).
  • today_calls / today_incoming / today_outgoing / today_total are always for calendar today within the filtered set.
  • Recordings.List / Recordings.Count stay customer-scoped and are unchanged.

Required Parameters

No body parameters are required for this function.

Optional Parameters

NameTypeSampleWhat it gives
month
post
string2026-10Month filter YYYY-MM (or YYYY-MM-DD). Aliases: month_filter, filter_month.
team_member_id
post
int47Optional: limit stats to one team member user_detail.id. Aliases: team_id, user_id.

Authentication

Send the bearer token returned by Login in the request header. The user must be from the same company domain as this Host — a token from another company is rejected (user_not_in_company).

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Calltrack.Stats",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "month": "2026-10"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Calltrack.Stats",
    "url_domain": "https:\/\/{domain}\/app\/Calltrack.Stats"
}

Endpoint

POST /app/Calltrack.Stats
POST https://{user}.bull36.com/app/Calltrack.Stats
POST https://{domain}/app/Calltrack.Stats

Sample Output

{
    "success": 1,
    "today_calls": 0,
    "today_incoming": 0,
    "today_outgoing": 0,
    "today_total": 0,
    "total_calls": 31,
    "total_call_per_month": 31
}

JavaScript Example

const token = 'YOUR TOKEN';
const res = await fetch('/app/Calltrack.Stats', {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ month: '2026-10' })
});
const data = await res.json();
console.log(data);

Error Example

{
    "success": "0",
    "error": "bearer_token_required",
    "message": "Authorization bearer token is required. Send header: Authorization: Bearer YOUR TOKEN"
}