Filters

Filters are hard catalog rules for this turn only — in-stock, a set of retailers, a price range. They use the same SearchFilters shape as the Search API. They do not stick across turns.

const stream = await client.conversations.createTurnStream({
  message: {
    role: "user",
    parts: [{ type: "text", text: "in brown instead" }],
  },
  conversation_id: conversationId,
  filters: { availability: ["InStock"], website_ids: ["nordstrom.com"] },
});

stream = client.conversations.create_turn_stream(
    message={
        "role": "user",
        "parts": [{"type": "text", "text": "in brown instead"}],
    },
    conversation_id=conversation_id,
    filters={"availability": ["InStock"], "website_ids": ["nordstrom.com"]},
)

curl -N -X POST https://api.trychannel3.com/v1/conversations \
  -H "Authorization: Bearer c3_ct_..." \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "role": "user",
      "parts": [{"type": "text", "text": "in brown instead"}]
    },
    "conversation_id": "conv_REPLACE_ME",
    "filters": {
      "availability": ["InStock"],
      "website_ids": ["nordstrom.com"]
    }
  }'

For shopper preferences and app notes that should last the whole conversation, use context. To limit the whole catalog to saved brands, websites, categories, or products, pass config.collection_id — see Collections.

Getting Started

Make a Search

Get Product Data

Conversational Agent

Checkout

Pricing, Reporting, and Commissions

Build

Integrate

FAQ