Get conversation insights

Retrieve how many conversations the AI agent handled over a date range, and how many are currently handed to the business awaiting a reply. Counts are per conversation, not per message. These are the same figures the business sees in their own agent summaries.

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 90 days, counting both the first and last day.

Header parameters

X-API-Versionstring · enumOptional

Meta Business Agent API version

Possible values:

Responses

200

The conversation insights for the requested range

application/json

The conversation 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/conversations

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

{
  "data": [
    {
      "ai_handoffs": {
        "count": 42
      },
      "ai_threads": {
        "count": 42
      }
    }
  ]
}