Get tool call insights

Retrieve how each of your tools performed over a date range: how many conversations called it, how long it took to respond, and how often it succeeded, failed, or timed out. Only tools you supplied are reported. Figures are rolled up once a day, so the most recent day may still be incomplete.

get

Authorizations

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Query parameters

start_datestringRequired

First day to include, as YYYY-MM-DD in the business time zone. The boundary is inclusive.

end_datestringRequired

Last day to include, as YYYY-MM-DD in the business time zone. The boundary is inclusive. start_date and end_date may span at most 30 days, counting both the first and last day.

tool_namestringOptional

Return only this tool, named as you registered it. Omit to get every tool that was called in the range.

Header parameters

X-API-Versionstring · enumOptional

Meta Business Agent API version

Possible values:

Responses

200

The tool call insights for the requested range

application/json

The tool call insights for the requested range

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

429

Too many requests

application/json

500

Server error

application/json

get/insights/tool_calls

GET /insights/tool_calls?start_date=text&end_date=text HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "avg_latency_ms": 412.3,
      "error_rate": 0.03,
      "success_rate": 0.97,
      "thread_count": 310,
      "timeout_rate": 0.01,
      "tool_name": "get_order_status"
    }
  ]
}