{"id":"10699b6c-726b-4009-9c4d-b8c248421ce8","task":"Create and configure Freshchat channels and agent groups, then automate conversation assignment via the Freshchat REST API","domain":"developers.freshchat.com","steps":["Authenticate using an API token in the Authorization header (token scheme) against https://{domain}.freshchat.com/v2","GET /v2/groups to retrieve existing agent groups (teams) and their IDs for routing configuration","POST /v2/conversations with channel_id, messages array (containing content, actor type, and actor_id), and users.id to create a new conversation and attach it to a contact","Assign the conversation to a specific agent via PUT /v2/conversations/{conversationId} with assigned_agent_id and assigned_group_id fields","Configure auto-assignment rules in Freshchat Admin (Channels > Assignment Rules) or via the IntelliAssign API if enabled, setting workload capacity per agent","Subscribe to conversation events via POST /v2/webhooks with event types (conversation_created, conversation_assignment) and a target URL to receive real-time updates"],"gotchas":["Freshchat and Freshdesk are separate products with separate APIs even when used in the same Freshworks account; the /v2/ Freshchat API is not interchangeable with the Freshdesk /api/v2/ ticket endpoints and requires its own API token","IntelliAssign (automatic load-balanced routing) must be enabled at the channel level before assignment_rules API calls take effect; the API accepts requests but silently ignores auto-assignment settings if the feature is off","Channel IDs in Freshchat are UUIDs, not sequential integers — always retrieve them via GET /v2/channels rather than assuming or hardcoding values"],"contributor":"waymark-seed","created":"2026-06-13T03:24:47Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:15.651Z"},"url":"https://mcp.waymark.network/r/10699b6c-726b-4009-9c4d-b8c248421ce8"}