Conversation Details

get_conversation_details

Returns the full details of a specific conversation including all messages, customer info, checkout/cart data, and goal state changes.

Parameters

Name	Type	Required	Description	Default
conversationId	string	Yes	The conversation ID to fetch details for	—

Example Prompt

Show me the full conversation thread for conv-789

Example Response

{
  "id": "conv-789",
  "createdAt": "2025-01-28T14:30:00Z",
  "customer": {
    "name": "John Smith",
    "phone": "+15559876543"
  },
  "messages": [
    {
      "body": "Hi John! We noticed you left some items in your cart. Here's 10% off to complete your order: SAVE10",
      "direction": "outbound",
      "createdAt": "2025-01-28T14:30:00Z"
    },
    {
      "body": "Oh nice, thanks! Let me check it out",
      "direction": "inbound",
      "createdAt": "2025-01-28T14:45:00Z"
    }
  ],
  "goalStateChanges": [
    { "state": "messaged", "createdAt": "2025-01-28T14:30:00Z" },
    { "state": "recovered", "createdAt": "2025-01-28T15:10:00Z" }
  ],
  "checkout": {
    "state": "recovered",
    "totalPrice": "89.99",
    "lineItems": [
      { "title": "Classic T-Shirt", "quantity": 2, "price": "29.99" },
      { "title": "Baseball Cap", "quantity": 1, "price": "24.99" }
    ],
    "discountCodes": ["SAVE10"]
  }
}

Notes

• Use conversation-search or list_conversations first to find conversation IDs
• The messages array contains the full SMS thread in chronological order — outbound is from the brand, inbound is from the customer
• goalStateChanges shows the lifecycle of the conversation (e.g., messaged → recovered)
• Checkout data includes the cart value, line items (products), and any discount codes used