Channels

The Channels page (/channels) lets you connect Nexora agents to the outside world. A channel is a bridge between an external event source — a Telegram message, an incoming webhook, or a cron schedule — and a specific agent in your workspace.

Page Overview

The page opens with a “Channels” heading and the subtitle “Connect agents to Telegram and other external platforms”. A “New Channel” button sits in the top-right corner.

Empty State

When no channels have been created, the page displays:

• A broadcast icon
• “No channels yet” heading
• “Create one to connect an agent to Telegram or other platforms” body text
• A “Create first channel” button that opens the New Channel modal

Channel Types

Nexora supports three channel types, each suited to a different integration pattern.

Webhook

A webhook channel exposes an HTTP endpoint that accepts POST requests. When a request arrives, the payload is forwarded to the assigned agent, which processes it and returns a response.

Common uses:

• Receive GitHub or GitLab push events and trigger a code review agent
• Accept CI/CD pipeline notifications and route them to the Infrastructure Manager
• Integrate with any third-party service that supports outbound webhooks

Schedule

A schedule channel triggers an agent on a cron schedule without any external input. The agent runs at the configured interval, executes its task, and optionally posts results to a connected destination.

Common uses:

• Daily standup summary generated by the Scrum Master agent every morning
• Weekly project status report from the Project Manager agent
• Nightly health check run by the Infrastructure Manager

External Chat

An External Chat channel connects an agent to a real-time messaging platform. Currently supported: Telegram. When a user sends a message to the configured bot, it is routed to the assigned Nexora agent and the response is sent back through the platform.

Common uses:

• Customer support bot that answers product questions via Telegram
• Personal assistant bot that accepts tasks from your phone
• Team notification bot that accepts commands and updates the kanban board

Creating a Channel

Click “New Channel” (top right) or “Create first channel” (empty state) to open the creation modal.

Modal Fields

Title: “New Channel — Connect an agent to an external platform”

Action buttons: Cancel · Create

Setting Up a Telegram Channel

This is the most common External Chat configuration. The setup takes three steps.

Step 1 — Add Your Telegram Bot Token

1. Open a chat with @BotFather  on Telegram
2. Send /newbot and follow the prompts to create a bot
3. Copy the API token BotFather provides (format: 123456789:ABC-DEF...)
4. In Nexora, go to Settings → Integrations
5. Find the Telegram section and paste your bot token
6. Save — Nexora will verify the token with the Telegram API

Step 2 — Create the Channel

1. Navigate to Channels (/channels)
2. Click “New Channel”
3. Enter a name (e.g. Customer Support Bot)
4. Select External Chat as the channel type
5. Choose your Telegram integration from the External account dropdown
6. Select the agent you want to handle messages (e.g. Project Manager or any Assistant agent)
7. Click Create

Step 3 — Test the Connection

1. Open Telegram and search for your bot by its username
2. Send a message
3. The agent in Nexora receives the message, processes it, and replies through the bot

Channel Use Case Reference

The table below maps common real-world scenarios to the appropriate channel type and agent.

Managing Existing Channels

Once channels are created, they appear in the channels list. Each card shows:

• Channel name and description
• Channel type badge (Webhook / Schedule / External Chat)
• Assigned agent name
• Status indicator (active / inactive)
• Options to edit or delete the channel

To pause a channel without deleting it, toggle the active state from the channel card or detail view.

Prerequisites Checklist

Before creating your first channel, verify:

• At least one agent exists in your workspace (/agents)
• For External Chat channels: the integration token is added in Settings → Integrations
• For Schedule channels: you know the cron expression for your desired schedule
• For Webhook channels: you have the external service’s outbound webhook URL configuration available