Brand Insights

get_brand_insights

Returns AI-generated insights from customer conversations. Insights are pre-analyzed summaries of common themes, blockers, and patterns across all conversations.

Parameters

Name	Type	Required	Description	Default
category	string	No	Filter by category: blocker, post_purchase, product	—
tag	string	No	Filter by tag: checkout, comparison, discount, exchanges, price, returns, shipping, specifications	—
limit	number	No	Maximum results (1–50)	20
dayLimit	number	No	Only insights updated within last N days	—

Categories

• blocker — Purchase barriers preventing customers from completing checkout
• post_purchase — Issues customers raise after placing an order
• product — Product-related questions and concerns

Example Prompt

What are the biggest blockers preventing customers from purchasing?

Example Response

{
  "insights": [
    {
      "id": "ins-001",
      "category": "blocker",
      "tag": "shipping",
      "topic": "Shipping time concerns",
      "body": "Multiple customers expressed concern about delivery times, particularly for orders placed late in the week. Several asked whether expedited shipping was available.",
      "updatedAt": "2025-01-27T12:00:00Z"
    },
    {
      "id": "ins-002",
      "category": "blocker",
      "tag": "price",
      "topic": "Price sensitivity on bundles",
      "body": "Customers frequently asked about bundle pricing and whether larger orders qualify for additional discounts beyond the offered coupon.",
      "updatedAt": "2025-01-26T08:30:00Z"
    }
  ],
  "totalCount": 2
}

Notes

• Insights are generated by AI from your actual customer conversations — they surface patterns you might miss
• Use dayLimit to focus on recent trends (e.g., dayLimit: 7 for last week)
• Use get_insight_conversations to see the actual conversations behind any insight