Debugging ToT Bot Deployment

Vince Andrei Isip

— 1 min read

KB: Restoring TotGPT’s Trello Epic/Deliverable Helper (Concise)

1. Overview

This guide describes the minimal steps required to restore TotGPT’s Trello Epic/Deliverable Helper.
It focuses only on:

  1. Ensuring all required environment variables exist
  2. Doing regression testing between test and production
  3. Checking the ToT bot app’s /bot/config URL path to see which environment variables are required or missing

2. Steps

A. Ensure Required Environment Keys Exist

Use this table to confirm that all environment variables are present in the deployment environment.
If any are missing, the Trello Helper will fail to load or behave incorrectly.

Environment Variable Description
TRELLO_API_KEY Trello authentication key
TRELLO_API_TOKEN Trello authentication token
NODE_ENV Runtime environment (test or production)
TRELLO_BOARD_ID Trello board used by TotGPT
TRELLO_BASE_DIR Directory path of stored Trello data
HELPSCOUT_API_KEY HelpScout API key
HELPSCOUT_PASSWORD HelpScout app password
HELPSCOUT_APP_SECRET HelpScout OAuth secret
HELPSCOUT_APP_ID HelpScout Application ID
HOLIDAYS Comma-separated list of holiday dates
GOOGLE_SERVICE_ACCOUNT_KEY_FILE Google credentials JSON path
OPENAI_API_KEY Required for TotGPT + GPT Assistants
FREESCOUT_PUBLIC_URL Freescout public instance URL
FREESCOUT_API_URL Freescout API base endpoint
FREESCOUT_API_KEY Freescout API key
GHOST_BASE_URL Ghost Admin base URL
GHOST_DOMAIN Public Ghost domain
GHOST_BASE_DIR Local Ghost sync directory
GHOST_ADMIN_KEY Ghost Admin API key
GHOST_CONTENT_API_KEY Ghost Content API key
GPT_CONFIG_SPREADSHEET_ID Spreadsheet ID for GPT configuration
MYGPT_TOKEN_HEADER Security token header for internal endpoints

B. Regression Testing (Test vs Production)

Perform the same checks in both environments:

1. Trello Helper Output

Prompt:

Create an epic and deliverables for migrating Zapier flows to Cloudflare.

Expected:
A structured breakdown including epic → deliverables → milestones → definition of done → risks.

2. KB Article Lookup

Prompt:

Show me the KB article for setting up TotGPT’s Trello Helper.

Expected:
This KB article or the related TotGPT setup documentation.

3. Compare Results

Both environments should return:

  • Identical structure
  • Consistent formatting
  • Same helper behavior

Differences indicate missing or mismatched environment variables.

C. Check Required/Missing Environment Variables via /bot/config (URL Path)

In the ToT bot application, navigate to the URL:

/bot/config

This page shows:

  • Which environment variables the bot expects
  • Which variables are currently loaded
  • Which variables are missing or incorrectly configured

Use this to confirm that the environment fully matches the required keys listed above.

Read more