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

How do you setup identity or age verification so that only certain locations need to get verified?

Answer: Use Location-Based Identity Verification. This is enabled via the locationRestrictions.requiresVerification attribute in your application configuration to define which countries and regions require verification. Summary Token of Trust now supports location-based verification requirements through the locationRestrictions configuration. This feature allows you to specify which geographic locations (countries and regions)

By darrin