Get the Most Popular Channels

Retrieves the top 5 popular channels in your workspace by the number of messages sent.

It requires view-engagement-dashboard permission.

URL	Requires Auth	HTTP Method
api/v1/engagement-dashboard/messages/top-five-popular-channels	yes	GET

Query Parameter

Argument	Example	Required	Description
start	2023-05-20T00:00:00.000Z	Required	The start date.
end	2023-10-05T14:48:00.000Z	Required	The end date.

Example Call

curl --location 'http://localhost:3000/api/v1/engagement-dashboard/messages/top-five-popular-channels?start=2023-05-20T00%3A00%3A00.000Z&end=2023-05-30T00%3A00%3A00.000Z' \
--header 'x-auth-token: HF0U3GBQHzC0pL_f_XXFHEfgXR8041XGldg2m_z8JQ0' \
--header 'x-user-id: rbAXPnMktTFbNpwtJ'

Example Result

Success

{
    "channels": [
        {
            "messages": 727,
            "t": "d",
            "usernames": [
                "google-calendar.bot",
                "pavithra.sudhakar"
            ]
        },
        {
            "messages": 26,
            "t": "d",
            "usernames": [
                "funke.olasupo",
                "google-calendar.bot"
            ]
        },
        {
            "messages": 2,
            "t": "d",
            "usernames": [
                "funke.olasupo",
                "rocket.cat"
            ]
        },
        {
            "messages": 1,
            "t": "d",
            "usernames": [
                "faria.masood",
                "rocket.cat"
            ]
        },
        {
            "messages": 1,
            "t": "d",
            "usernames": [
                "janaina.coelho",
                "rocket.cat"
            ]
        }
    ],
    "success": true
}

tdenotes the type of room where the messages are sent.

• d represents Private Chats

• c represents Public Channels

• p represents Private Channels

Error

Any of the following errors can occur on the endpoint.

• Authorization: Requires an authentication token for the request to be made.

• No Permission: This occurs when the authenticated user doesn't have the view-engagement-dashboard permission.

• Invalid Date: This occurs when the start or end date does not follow the accepted format ( 2023-10-05T14:48:00.000Z).

Authorization

{
    "status": "error",
    "message": "You must be logged in to do this."
}

No Permission

{
    "success": false,
    "error": "User does not have the permissions required for this action [error-unauthorized]"
}

Invalid Date

{
    "success": false,
    "error": "Match error: Failed Match.Where validation in field start"
}

Change Log

Version	Description
3.1.0	Added