Insight Conversations

get_insight_conversations

Returns conversations linked to a specific brand insight. Use after get_brand_insights to see the actual conversations that contributed to an insight.

Parameters

Name	Type	Required	Description	Default
brandInsightId	string	Yes	The insight ID from get_brand_insights	—
limit	number	No	Maximum results (1–30)	10
offset	number	No	Pagination offset	0

Example Prompt

Show me the conversations behind the shipping time concerns insight (ins-001)

Example Response

{
  "brandInsightId": "ins-001",
  "conversations": [
    {
      "conversationId": "conv-111",
      "createdAt": "2025-01-25T10:00:00Z",
      "customer": {
        "name": "Sarah Johnson",
        "phone": "+15551112222"
      },
      "checkoutState": "abandoned",
      "messagePreview": "How long does shipping usually take? I need this by Friday."
    },
    {
      "conversationId": "conv-222",
      "createdAt": "2025-01-24T16:30:00Z",
      "customer": {
        "name": "Mike Chen",
        "phone": "+15553334444"
      },
      "checkoutState": "recovered",
      "messagePreview": "Do you offer express shipping?"
    }
  ],
  "totalCount": 2,
  "limit": 10,
  "offset": 0
}

Notes

• Requires a brandInsightId from get_brand_insights — call that first to get insight IDs
• Use get_conversation_details to read the full message thread for any returned conversation
• This is useful for providing evidence-based recommendations — you can see the actual customer conversations behind every insight