Distribution Channel Metadata

Overview

Distribution Channels define where and how your AI assistants are deployed. Each channel type has specific metadata and configuration options that control its behavior and integration.

Metadata Structure

When creating or updating a distribution channel (assistant), include the distributionChannel object in the metadata field:

{
  "name": "My Assistant",
  "metadata": {
    "distributionChannel": {
      "type": "Chat",
      "config": {
        // Channel-specific configuration
      }
    },
    // Other metadata fields...
  }
}

Channel Types

Chat

Integration with B-Bot Chat App

{
  "type": "Chat",
  "config": {
    "type": "chat-integration",
    "public": true
  }
}

Additional Metadata Fields:

profileImage: URL to assistant profile picture
abilities: Array of ability objects/strings
templates: Array of template objects/strings
description: Assistant description shown in chat

Embed

Embeddable widget for websites and apps

{
  "type": "Embed",
  "config": {
    "type": "embed-widget",
    "public": true
  }
}

Additional Metadata Fields:

profileImage: URL to assistant profile picture
bubbleIcon: URL to custom chat bubble icon (optional, uses default if not set)
headerIcon: Lucide icon name for embed header
abilities: Array of ability objects/strings
templates: Array of template objects/strings
description: Assistant description shown in embed

API

Direct integration via REST API endpoints

{
  "type": "API",
  "config": {
    "type": "api-integration"
  }
}

No additional configuration required. Assistant will be available via standard LangGraph API endpoints.

Tasks

Internal task distribution system

{
  "type": "Tasks",
  "config": {
    "type": "task-distribution"
  }
}

Additional Behavior:

When created, the assistant ID is automatically linked to the expert’s task_assistant_id field
Used for automated task routing and execution within the B-Bot ecosystem

Template

Share as public expert template for others to install

{
  "type": "Template",
  "category": "Sales & Marketing",
  "featured": false,
  "config": {
    "type": "template",
    "category": "Sales & Marketing",
    "featured": false,
    "public": true,
    "usage_count": 0
  }
}

Required Fields:

category: Template category (see categories below)
featured: Request featured status (requires admin approval)
usage_count: Number of times template has been installed (auto-managed)

Available Categories:

Sales & Marketing
Customer Support
Development
Finance & Accounting
HR & Recruitment
Content Creation
Project Management
Data Analysis
Education
Other

Template Behavior:

App credentials are removed when template is shared
Users must connect their own app credentials when installing
Knowledge containers are copied to the installing user’s expert

Coming Soon

The following channel types are planned for future releases: Twilio - SMS and messaging integration

{
  "type": "Twilio",
  "config": {
    "accountSid": "",
    "phoneNumber": ""
  }
}

N8n - Workflow automation integration

{
  "type": "N8n",
  "config": {
    "webhookUrl": "",
    "active": false
  }
}

Zapier - App integration platform

{
  "type": "Zapier",
  "config": {
    "webhookUrl": "",
    "triggerEvent": "message"
  }
}

Complete Example

Here’s a complete example of creating a Chat distribution channel with all metadata:

{
  "name": "Customer Support Assistant",
  "description": "Helps customers with product questions",
  "graph_id": "bbot",
  "metadata": {
    "distributionChannel": {
      "type": "Chat",
      "config": {
        "type": "chat-integration",
        "public": true
      }
    },
    "profileImage": "https://example.com/profile.jpg",
    "abilities": [
      { "text": "Answer product questions" },
      { "text": "Process returns" }
    ],
    "templates": [
      { "text": "Help me understand [feature]" },
      { "text": "I need to return [item]" }
    ],
    "description": "Customer Support Assistant"
  },
  "config": {
    "graph_id": "bbot",
    "temperature": 0.7,
    "top_p": 0.95,
    "query_model": "openai/gpt-4",
    "response_model": "openai/gpt-4"
  }
}

Filtering by Distribution Channel

When fetching distribution channels via the public endpoints, the API automatically filters assistants based on their distributionChannel.type metadata: Included Types: Chat, Embed, Template Assistants without a distributionChannel metadata field will not be included in public endpoints. This ensures legacy assistants don’t automatically appear in public-facing applications.

Best Practices

Always specify a distribution channel type when creating new assistants intended for public use
Use meaningful categories for Template channels to help users discover your expert
Include profile images and descriptions for Chat and Embed channels to provide better user experience
Test embed customizations (bubbleIcon, headerIcon) before deploying to production
Request featured status carefully - only for high-quality, well-tested templates

API User Memories

Distribution Channels

Knowledge Domains

Experts (Agencies & Partners Only)

Threads

Thread Runs

Stateless Runs

Store

A2A

MCP

System

Distribution Channel Metadata

Overview

Metadata Structure

Channel Types

Chat

Embed

API

Tasks

Template

Coming Soon

Complete Example

Filtering by Distribution Channel

Best Practices

​Overview

​Metadata Structure

​Channel Types

​Chat

​Embed

​API

​Tasks

​Template

​Coming Soon

​Complete Example

​Filtering by Distribution Channel

​Best Practices

Overview

Metadata Structure

Channel Types

Chat

Embed

API

Tasks

Template

Coming Soon

Complete Example

Filtering by Distribution Channel

Best Practices