TROPTIONS · Operator

Telegram — NeedAI Ada

Primary bot @NeedAI_Ada_bot — mobile command surface for baas-api, agent orchestrator, and USDC relay stubs. Revenue replies are PROJECTION — not realized bank revenue.

Open Telegram Command Center Overview

Connect tonight — checklist

Primary bot: NeedAI Ada (@NeedAI_Ada_bot) — token in host .env as TELEGRAM_BOT_TOKEN only (never commit)
Start baas-api on :8097 (not :4029 dashboard)
pm2 start ecosystem.config.js --only telegram-bot --update-env
In Telegram: /start then /pools — expect PIPELINE/PROJECTION labeled replies
Set NEXT_PUBLIC_TELEGRAM_BOT_USERNAME=NeedAI_Ada_bot at build for Open Telegram CTA

Status: PIPELINE until TELEGRAM_BOT_TOKEN is on the host and pm2 shows telegram-bot online.

BotFather setup

Open @BotFather in Telegram.
Use existing bot @NeedAI_Ada_bot (NeedAI Ada) or /newbot for a new bot.
Copy the token into host .env as TELEGRAM_BOT_TOKEN — never commit to git.
Optional: set NEXT_PUBLIC_TELEGRAM_BOT_USERNAME when building this site for the Open Telegram button.
Start stack: see Command Center activation steps.

Environment variables

Templates: config/multi-gateway.env.template, services/telegram-bot/.env.template

Variable	Required	Where	Source
TELEGRAM_BOT_TOKEN	Yes	Host .env only — never commit	@BotFather → /newbot
PORT	No	Default 8443	ecosystem.config.js
BAAS_API_URL	No	Default http://127.0.0.1:8097	fiat-rails/baas-api
AGENT_ORCHESTRATOR_URL	No	Default http://127.0.0.1:4100	agents/orchestrator
USDC_RELAY_URL	No	Default http://127.0.0.1:4040	services/usdc-base-relay
NEXT_PUBLIC_TELEGRAM_BOT_USERNAME	No	Investor site build only (public deep link)	NeedAI Ada — NeedAI_Ada_bot (no @ in env)

TELEGRAM_BOT_TOKEN is documented on this page only for operator setup. It must not appear in the repository or GitHub Pages build output.

Commands

Implementation: services/telegram-bot/bot.js (port 8443)

Command	Action	Label	Upstream
/start	Welcome + command list	PIPELINE	—
/trade [SYMBOL]	Dry-run agent trade cycle via orchestrator :4100	PROJECTION	agents/orchestrator
/revenue	Billing revenue stub from baas-api :8097	PROJECTION	fiat-rails/baas-api
/pools	Batch pool job status	PIPELINE	fiat-rails/baas-api
/agent [id]	Register agent stub on BaaS	PIPELINE	fiat-rails/baas-api
/deposit [amt]	USDC relay deposit stub :4040	PIPELINE	services/usdc-base-relay
/withdraw [amt]	USDC relay withdraw stub	PIPELINE	services/usdc-base-relay
/setprice SYM PRICE	BaaS global price stub (admin)	PIPELINE	fiat-rails/baas-api

Capability overview: What you can do NOW lists PROVEN crypto steps vs PIPELINE fiat (partner MSB + BIC + nostro).

Site ↔ Telegram: Command Center links here and to t.me bot. Deep link HTML: telegram-deep-link.html (redirect when username is configured at deploy).