Retrieves the message history for a specific conversation. Messages include:

• Text content and attachments
• Sender information (contact, teammate, or bot)
• Timestamps and read status

Results are paginated using cursor-based pagination. By default, messages are returned
in newest_first order, but you can use oldest_first to start from the beginning
of the conversation.

Response field values

type - Type of message or event:

• message: Regular message from contact or agent
• note: Internal note (visible only to teammates)
• close: Conversation was closed
• assignment: Conversation was assigned
• reply_close: Reply that also closed the conversation
• reply_assignment: Reply that also reassigned the conversation
• assignment_open: Assignment that reopened the conversation
• change_tag: Priority tag was changed
• video_call_missed: Video call was not answered
• video_call_started: Video call was initiated
• message_with_choices: Message with clickable options
• chatflow_enter: Contact entered a chatflow
• chatflow_escalation: Chatflow escalated to human agent
• csat: Customer satisfaction survey
• profiling: Contact profiling question
• chatflow_api: Chatflow API action
• snoozed: Conversation was snoozed
• channel_handoff_requested: Channel switch requested
• channel_handoff_completed: Channel switch completed

channel - Channel used for this message:

• in_app: Live chat widget
• email: Email
• facebook: Facebook Messenger
• whatsapp: WhatsApp

channel_delivery.email.status - Email delivery status:

• sending: Email is being sent
• sent: Email has been sent

channel_delivery.whatsapp.status - WhatsApp delivery status:

• failed: Delivery failed
• sending: Message is being sent
• sent: Message has been sent

channel_delivery.whatsapp.error_details.code - WhatsApp error code (when status is failed):

• user_whatsapp_not_found: User WhatsApp number not found
• app_whatsapp_number_not_found: App WhatsApp number not found
• app_whatsapp_number_stopped: App WhatsApp number stopped
• template_not_found: WhatsApp template not found
• customer_service_window_expired: Customer service window expired (24h limit)
• send_failed_unknown: Send failed for unknown reason
• meta_api_error: Meta API error (check meta_code for details)

chatflow.escalation_reason - Reason for AI escalation (when type is chatflow_escalation):

• low_confidence: AI had low confidence in the response
• missing_information: Missing information to answer
• human_requested: Contact explicitly requested human support
• exception: An exception occurred
• loop_detected: Conversation loop detected
• unknown: Unknown reason
• outside_mission: Question outside AI mission scope
• user_exited: Contact exited the chatflow
• node_deleted: Chatflow node was deleted
• interactions_depleted: Maximum interactions reached
• content_security_policy: Content security policy violation
• ai_disabled: AI assistant is disabled
• ai_conversations_credit_exhausted: AI conversations credit exhausted
• too_bothering: AI detected it was being too persistent
• message_not_sent: Message could not be sent