Estimated reading time: 4 minutes Updated: 8/26/2026 Created by: Botmaker Team

[GET] /metrics/



Objective:

This service is used to return session-related metrics within a specified time range.


Parameters:

  • dateISOFrom: ISO date format. Used as the starting point to return records.
  • dateISOTo: ISO date format. Used as the endpoint to return records.


Curl Example:

curl -X GET --header 'Accept: application/json' --header 'dateISOFrom: 2020-01-01T00:00:00.000Z' --header 'dateISOTo: 2020-01-01T23:59:00.000Z' --header 'access-token: <ACCESS TOKEN>' 'https://go.botmaker.com/api/v1.0/metrics'


Response Structure:

  • totalMsgByOp [number]: Total number of messages per operator | 35.
  • totalSessions [number]: Total number of sessions | 10.
  • totalUsers [number]: Total number of users | 7.
  • byChannels [array]: List of channels.
  • totalSessionsHandleByBots [number]: Total number of sessions handled by the bot | 2.
  • totalSessionsHandleByOperators [number]: Total number of sessions handled by operators | 10.
  • totalMsgByBot [number]: Total number of messages by bot | 7.
  • totalMsgByUser [number]: Total number of messages by user | 9.
  • totalTopics [number]: Total number of topics | 3.


Example JSON:

{"totalMsgByOp":0,"totalSessions":0,"totalUsers":0,"byChannels":,"totalSessionsHandleByBots":0,"totalSessionsHandleByOperators":0,"totalMsgByBot":0,"totalMsgByUser":0,"totalTopics":0}



Remember to visit our Help Center for further information.