IssueCauseResolutionSteps
Chatbot client doesn't load


Product is disabled​
(/v1/product/<PRODUCT>/config has property enabled set to false)

Enable Chatbot

  1. Set the products.<PRODUCT>.enabled value to true in the <ENV>/overrides.json file for the applicable product and environment (disables both chatbot and livechat)
  2. Redeploy chatbot server

Chatbot refers to invalid client version
(/v1/product/<PRODUCT>/loader redirects to a file that 404s)

Change client version
  1. Set the products.<PRODUCT>.client.useVersion value to a deployed version (normally a top-level directory in the public Cloud Storage bucket) in the <ENV>/overrides.json file for the applicable product and environment
  2. Redeploy chatbot server
Chatbot is not respondingInvalid JSON Web Token (JWT)
(403 responses, test pages only)
Start new Session
  1. In the UI, click the three vertical dots next to chatbot text input
  2. Select "End Chat"
  3. Re-open chatbot

Chatbot doesn't respond to title searches

Dialogflow webhook timeoutTroubleshoot Bifrost
  1. View logs to confirm /v1/product/<PRODUCT>/webhook/dialogflow is timing out
    1. Response times over 5,000ms violate Dialogflow webhook requirements
  2. Troubleshoot Bifrost
Dialogflow webhook failureTroubleshoot webhook
  1. View logs to confirm /v1/product/<PRODUCT>/webhook/dialogflow is failing
    1. A response code other than 200 violates Dialogflow webhook requirements
  2. Look for logged exceptions
  3. Analyze failure mode
Chatbot experience not consistent among usersOutdated images runningRedeploy Chatbot
  1. Determine currently deployed version
  2. Redeploy chatbot server
  3. Wait for 5 minutes before testing again