Telegram Support Handler

ACTION

Sends draft response previews to admin via Telegram with Accept/Edit/Reject inline buttons. Handles callback queries from Telegram. Stores pending responses persistently in a JSON file. Removes inline keyboard buttons after callback click to prevent double-clicks. Notifies Events pipeline on callback via internal chat API.

Download

Sydney0 installs0 starsPublished 5/24/2026 · 3mo ago

Endpoints

· 5

POST/handle-callbackHandles an admin callback decision (accept/edit/reject) for a pending draft, answers the Telegram callback query, and notifies the Events pipeline

Input Schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "Decision action: accept, edit, or reject"
    },
    "chatId": {
      "type": "string",
      "description": "Telegram chat ID"
    },
    "emailId": {
      "type": "string",
      "description": "UUID of the email"
    },
    "required": [
      "action",
      "emailId"
    ],
    "messageId": {
      "type": "number",
      "description": "Telegram message ID"
    },
    "callbackQueryId": {
      "type": "string",
      "description": "Telegram callback query ID to dismiss loading"
    }
  }
}

GET/pending-response/:emailIdRetrieves the pending draft response for a given emailId from the in-memory store

GET/Dashboard UI showing email history summary cards and a detailed table of all processed emails

GET/email/:emailIdDetail page for a single email history entry, shows all metadata, original email body, and draft response

POST/send-draftSends a draft support email response to the admin via Telegram, optionally with inline accept/edit/reject buttons

Input Schema

{
  "type": "object",
  "required": [
    "emailFrom",
    "emailSubject",
    "draftResponse",
    "emailId"
  ],
  "properties": {
    "chatId": {
      "type": "string",
      "description": "Optional Telegram chat ID, falls back to ADMIN_CHAT_ID env var"
    },
    "aiNotes": {
      "type": "string",
      "description": "Optional notes from the AI — extra context or info the AI wants the admin to know when reviewing the draft"
    },
    "emailId": {
      "type": "string",
      "description": "UUID of the original email"
    },
    "emailBody": {
      "type": "string",
      "description": "Original customer email body text"
    },
    "emailFrom": {
      "type": "string",
      "description": "Sender email address"
    },
    "emailSubject": {
      "type": "string",
      "description": "Email subject line"
    },
    "draftResponse": {
      "type": "string",
      "description": "The drafted response text"
    },
    "includeButtons": {
      "type": "boolean",
      "description": "Whether to include inline Accept/Edit/Reject buttons (defaults to true)"
    }
  }
}

Required Secrets

· 4

TELEGRAM_BOT_TOKENADMIN_CHAT_IDDASHBOARD_USERNAMEDASHBOARD_PASSWORD

✦

Similar ACTION Pieces

facebook-ads-manager

Facebook Ads API manager with OAuth — list campaigns, get insights, ad account info, and ads with creative details. Login to any Facebook/Instagram account.

Shared Terminal

Full-featured web terminal with Node.js, Python, Deno, git, and build tools — running in a Podman container with Ubuntu 24.04

Coolify Logs Watcher

Polls Coolify API for application logs, stores in SQLite, exposes search endpoints for support email triage. Monitors free-copier-py, free-copier-express, and free-copier-next runtime logs. Used by the Events pipeline (Sydney) to find relevant errors when drafting support responses.