Chat Messages

Get the full message thread for a specific chat conversation.

GET /v1/conversations/chats/:id/messages

Path Parameters

Parameter	Type	Description
id	string	The conversation ID (UUID)

Response

Messages are returned in chronological order (oldest first).

{
  "data": {
    "conversation_id": "770e8400-e29b-41d4-a716-446655440000",
    "messages": [
      {
        "id": "aa0e8400-e29b-41d4-a716-446655440000",
        "role": "user",
        "content": "Hi, do you have any rooms available for March 20-22?",
        "created_at": "2026-03-10T09:15:00.000Z"
      },
      {
        "id": "bb0e8400-e29b-41d4-a716-446655440000",
        "role": "assistant",
        "content": "Hello! Yes, we have several room types available for March 20-22. Let me check the options for you...",
        "created_at": "2026-03-10T09:15:05.000Z"
      },
      {
        "id": "cc0e8400-e29b-41d4-a716-446655440000",
        "role": "user",
        "content": "What's the price for a deluxe room?",
        "created_at": "2026-03-10T09:16:00.000Z"
      }
    ]
  }
}

Response Fields

Message Object

Field	Type	Description
id	string	Message ID
role	string	Message author: user, assistant, system, or tool
content	string|object	Message content (string for text, object for structured content)
created_at	string	When the message was sent

Message Roles

Role	Description
user	Message from the guest
assistant	AI-generated response
system	System message (e.g., conversation started)
tool	Tool execution result (e.g., room availability check)

The content field is typically a string, but for some message types (tool calls, structured responses) it may be a JSON object. Handle both cases in your integration.

Errors

Status	Error	Description
404	Chat conversation not found	ID doesn't exist or belongs to another company

Example

cURL

curl "https://api.opally.com/v1/conversations/chats/770e8400-e29b-41d4-a716-446655440000/messages" \
  -H "Authorization: Bearer op_live_your_api_key_here"

JavaScript

Python