get
https://api.customerly.io/v2/conversations/
Retrieves detailed information about a specific conversation, including:
- Conversation metadata (status, assignee, tags, timestamps)
- Associated contact information
- AI assistant interaction status (if Aura is enabled)
Returns 404 if the conversation doesn't exist, or 403 if you don't have permission
to access it (e.g., it's assigned to another teammate in a restricted inbox).
Response field values
tag - Priority tag assigned to the conversation:
none: No tag assignedin_progress: Being actively worked onwaiting: Waiting for customer response or external actionpriority: High priority, requires immediate attention
origin_channel - Channel where the conversation started:
in_app: Live chat widget on your website/appemail: Email integrationfacebook: Facebook Messengerwhatsapp: WhatsApp Business
initiated_by - Who started the conversation:
contact: Contact initiated the conversationaccount: Teammate started the conversationcampaign: Triggered by a marketing campaignworkflow: Triggered by an automation workflow
handling_type - How the conversation is being handled:
none: No handler assigned yetfull_human: Handled entirely by human agentsfull_ai: Handled entirely by Aura AI assistantmixed_human_ai: Combination of AI and human handling
assigner.type - Type of assignment:
account: Assigned to a specific teammateteam: Assigned to a team inbox
last_message.sender_type - Type of sender for the last message:
account: Message sent by a teammatecontact: Message sent by the contact
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
401Authentication required
403Permission denied
404Conversation not found
422The request is not valid