List agents

Agents of the account with role, group and current status.

GET https://cotlet.dev/api/v1/freshchat/agents

read

Returns the agents you can assign conversations to, each with the agent_id other tools take, the role, the groups they belong to and the status they set in Freshchat. Freshchat's default statuses are "Active on IntelliAssign" and "Unavailable", and an Admin can add custom ones. Use group_id to list one team.

Parameters

Parameters: list_agents
NameTypeDescription
group_id string string Only agents of this group, from list_groups.

Request

cURL
curl https://cotlet.dev/api/v1/freshchat/agents \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("freshchat", "list_agents")
Node.js
const result = await cotlet.call('freshchat', 'list_agents');
CLI
cotlet call freshchat list_agents

Example response

JSON

{
  "agents": [
    {
      "agent_id": "2f8a1c3e-9b47-4d60-a5e2-7c1d0b9f3a45",
      "name": "Dana Reed",
      "role": "Agent",
      "groups": [
        "Support"
      ],
      "status": "Active on IntelliAssign"
    },
    {
      "agent_id": "9d4b6e21-0a3c-47f8-b1e5-3a6c8d2f1b70",
      "name": "Marcus Hale",
      "role": "Admin",
      "groups": [
        "Billing"
      ],
      "status": "In a Meeting"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.