{% extends "admin/base.html" %} {% block title %}Connect a chat bot — cmdop admin{% endblock %} {% block content %} {# Plan 61/2b W3 — chat-bot connection wizard. OSS-flavoured: the deploy step generates `docker compose --profile up -d` and tells the user to run it on their own machine. The relay does not spawn adapter containers. Steps: 1. Pick a channel (skipped when ?channel= is set) 2. Create bot on platform (docs + token paste) 3. Set bot username + confirm 4. Run adapter on user's server (docker compose snippet) 5. Test (poll /api/admin/bots/test) 6. Done #} {% from 'admin/components/ui.html' import page_header, card, tooltip %}
{{ page_header( 'Connect a chat bot', 'Hook Telegram, Discord, or Slack into Jarvis for this fleet.', eyebrow='Wizards', help_anchor='bots' ) }} {# Stepper. #}
{# Step 1 — pick a channel. #}

Pick a channel

Each channel is one container on your machine. You can connect more than one.

{# Step 2 — register bot on platform + paste token. #}

Register the bot on

{# Step 3 — confirm details. #}

Confirm

Channel
Bot username
Token

We'll register this channel as pending and stay here until the adapter posts a heartbeat.

{# Step 4 — run adapter on user's server. #}

Run the adapter on your server

This step happens on your machine, not in this browser. Copy the snippet below, paste it into a terminal on the host that will run the bot.


      
    

The container will hit POST /api/bot/heartbeat every 30s. As soon as we see the first heartbeat the wizard advances.

{# Step 5 — test (polls). #}

Testing the adapter

{# Step 6 — done. #}

Connected

Your bot is alive. Open the chat, send a message, watch Jarvis reply.

{% endblock %}