Skip to content
TROPIKALTROPIKAL Docs

Telegram Channel

Telegram can be used as a fast owner channel for TROPIKAL. It helps owners and operators review job handoffs, check safe website summaries, and approve prepared changes while keeping sensitive work inside TROPIKAL’s governed job, persona, and Knowledge & Capabilities model.

Telegram is not a place to paste passwords, API keys, customer exports, booking records, or private provider details.

Two Telegram paths

TROPIKAL supports Telegram in two product shapes:

Path Use it when
Owner channel Owners want review notifications, handoffs, and connected website owner chat from Telegram.
Job channel A specific job should start from messages sent to a configured Telegram bot or chat.

Use the owner channel for operator control. Use a job channel only when Telegram is part of the job input, such as an internal request queue or a team handoff inbox.

What you can do

With Telegram connected, an owner can:

  • receive concise job review and handoff updates when enabled;
  • open TROPIKAL from a notification when more detail is needed;
  • choose a connected website and ask safe owner-chat questions;
  • review prepared Website changes before they are published or deleted;
  • approve or cancel confirmable actions with Telegram buttons.

The current owner experience is designed for quick operator decisions, not large data exports. For detailed review, use the TROPIKAL dashboard.

Connect your account

  1. Open the TROPIKAL Telegram bot from your workspace instructions.
  2. Send /login.
  3. Open the secure TROPIKAL ID link.
  4. Sign in with the owner account you use for TROPIKAL.
  5. Return to Telegram after the account is linked.

The bot should confirm that Telegram is connected to your TROPIKAL account. If the link expires, send /login again.

If your workspace uses the first-party owner bot, the workspace instructions may direct you to @tropikal_ai_bot. Only use the bot or setup link shown by your TROPIKAL workspace.

Add Telegram to a job

To let Telegram start a job:

  1. Open the job in TROPIKAL.
  2. Open the Trigger node.
  3. Choose Channel.
  4. Click Telegram in Public Channels.
  5. Add the Telegram bot connection and allowed chat settings shown in the inspector.
  6. Save the job and send a test message from the allowed Telegram chat.

Treat Telegram bot tokens like passwords. Add them only in the secure setup screen, never in a chat message, job prompt, persona, or knowledge source.

After setup, test the job with a normal message, an out-of-scope message, and a message that should trigger the next action. Adjust the job, persona, or Knowledge & Capabilities before inviting more users.

Use website owner chat

Website owner chat lets you work with one connected website at a time.

  1. Send /chat.
  2. Choose the connected website.
  3. Ask a normal question, such as:
    • “What content can I manage here?”
    • “List the latest three posts.”
    • “Summarize draft pages from this week.”
  4. Use /done when you are finished.

Read-only questions should return concise summaries. If the selected website does not expose the requested content through Connected Data, sync the website or check the Website Tools setup in the dashboard.

Request changes safely

When you ask for a website change, be specific about the object and the change.

Goal Example message
Update a post “Set post 147 live and publish it on May 24.”
Create a draft “Create a draft research post about summer booking trends.”
Clean up content “Find old draft posts first. Do not delete anything yet.”
Publish reviewed content “Publish the reviewed post titled Spring Services.”

For write, publish, archive, delete, or other externally visible actions, TROPIKAL prepares the action and shows Confirm and Cancel buttons. The action does not run just because the chat text says “confirm.” Use the buttons shown with the pending action.

If required details are missing, Telegram should ask a specific question, such as which post to update or what title to use.

Job notifications

Telegram can act as an owner notification channel for job events when it is enabled for your workspace. Typical notifications include:

  • owner review requested;
  • job run failed;
  • owner handoff needed;
  • important Website action awaiting review.

Notifications are short by design. They should tell you what needs attention and where to continue. Sensitive details stay in the TROPIKAL dashboard.

Commands

Command Purpose
/start Check the bot and see suggested next actions.
/login Connect Telegram to your TROPIKAL account.
/logout Disconnect Telegram from your TROPIKAL account.
/chat Choose a connected website and start owner chat.
/done Leave website owner-chat mode.
/tools See a safe list of available capabilities.
/personas See safe persona summaries.
/workflows See safe job summaries.
/runs See safe recent run summaries.
/notifications Check Telegram notification status.
/help Show command help.

Safety expectations

  • Do not paste passwords, access tokens, provider keys, payment details, or raw customer exports into Telegram.
  • Use read-only questions before asking for changes.
  • Review the summary before tapping Confirm.
  • Use the dashboard for detailed records, customer history, booking details, and job setup.
  • Disconnect Telegram with /logout if a device is lost or an owner should no longer receive updates there.

Troubleshooting

Symptom First check
Login link expired Send /login again and open the new link.
/chat shows no websites Confirm the website is connected and synced in TROPIKAL.
A website action asks for more detail Reply with the missing title, slug, ID, date, or field requested.
Confirm buttons are missing Ask again with the exact Website action. Do not type “confirm” as a workaround.
A write action fails Check the connected website permissions and retry from the dashboard if more context is needed.
Notifications are missing Check /notifications and confirm Telegram is still connected to the right owner account.