userType: external

gitBranch: claude/zealous-liskov

slug: jaunty-zooming-globe

type: user

role: user

content:
Research the GoHighLevel (GHL) API for configuring webchat/chat widgets. I need to know:

1. What API endpoints exist for managing chat widgets in GHL?
2. How to configure the webchat widget's prompt messages, colors, and behavior via API
3. How to set up automated responses or bot flows for the webchat

The GHL API base is: https://services.leadconnectorhq.com
API version header: Version: 2021-07-28
Auth: Bearer token

Search the web for "GoHighLevel API chat widget configuration" and "GHL webchat API endpoint" to find documentation.

Also search for "GoHighLevel webchat widget customization API 2025 2026" to find the latest docs.

Return all findings - endpoints, parameters, and any relevant documentation URLs.


type: message

role: assistant

type: text

text: I'll research the GoHighLevel API for webchat/chat widget configuration. Let me search for the latest documentation.

service_tier: standard

type: assistant


WebSearch

query: GoHighLevel API chat widget configuration endpoints 2025 2026


query: GHL webchat API widget customization prompt colors behavior


query: GoHighLevel API webchat automated responses bot flows


type: progress

hookEvent: PostToolUse


content:
Web search results for query: "GHL webchat API widget customization prompt colors behavior"

Links: [{"title":"Web Chat Widget - Advanced Configurations + Public API/Events : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/48001191051-web-chat-widget-advanced-configurations-public-api-events"},{"title":"Overview of Chat Widget Customizations : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000002960-overview-of-chat-widget-customizations"},{"title":"GHL Chat Widget","url":"https://hlassistly.com/blog-how-to-add-customize-the-go-high-level-chat-widget-for-your-website"},{"title":"How to Use the All-in-One Chat Widget in HighLevel : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000004779-how-to-use-the-all-in-one-chat-widget"},{"title":"Getting Started with HighLevel Chat Widget (Web Chat & Live Chat Options) : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000004102-getting-started-with-chat-widget"},{"title":"GHL Chat Widget - The Marketer's Toolkit for Go High Level","url":"https://themarketerstoolkit.com/ghl-chat-widget/"},{"title":"The GoHighLevel Chat Widget and Chatbot: Essential?","url":"https://supplygem.com/gohighlevel-chat-widget/"},{"title":"How To Create and Add a Chat Widget to Funnels and Websites for GoHighLevel – Growthable","url":"https://growthable.io/gohighlevel-tutorials/websites/how-to-create-and-add-a-chat-widget-to-funnels-and-websites-for-gohighlevel/"},{"title":"GoHighLevel Chat Widget: How to Set Up and Use It Like a Pro?","url":"https://www.chillreptile.com/gohighlevel-chat-widget/"},{"title":"HighLevel Chat Widget: How to Add It to Your Website in Minutes : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/48000984860-how-to-install-highlevel-s-chat-widget"}]

I found information about GHL webchat API widget customization. Here's what the search results show:

## Color Customization

The GHL webchat widget supports CSS style customization using `--chat-widget-primary-color` and `--chat-widget-active-color` properties to customize colors (for example: `style="--chat-widget-primary-color: #97C8A2; --chat-widget-active-color:#97C8A2"`).

## Prompt Behavior

The `next-prompt-timer` attribute determines the number of seconds the webchat widget waits before showing the chat-bubble to a user when they revisit, with a default value of 86400 seconds (24 hours), meaning the prompt bubble will not be visible for 24 hours if a user closes the widget. To make the chat-bubble visible upon every page visit, you would set this value to 0.

## Other Customization Options

The widget allows you to change the default message icon on the chat-widget open button using the `open-icon-url` attribute, and you can also customize the close icon using the `close-icon-url` attribute.

The official HighLevel support documentation shows that there are 3 tabs of customization for setting up the chat widget: Chat bubble, Widget window, and Acknowledgement settings.

REMINDER: You MUST include the sources above in your response to the user using markdown hyperlinks.


content:
Web search results for query: "GoHighLevel API chat widget configuration endpoints 2025 2026"

Links: [{"title":"HighLevel API Documentation : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/48001060529-highlevel-api-documentation"},{"title":"Web Chat Widget - Advanced Configurations + Public API/Events : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/48001191051-web-chat-widget-advanced-configurations-public-api-events"},{"title":"HighLevel API Documentation - Developer Portal | HighLevel API","url":"https://marketplace.gohighlevel.com/docs/"},{"title":"Getting Started with HighLevel Chat Widget (Web Chat & Live Chat Options) : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000004102-getting-started-with-chat-widget"},{"title":"Conversation AI Public API : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000006639-conversation-ai-public-api"},{"title":"Client Portal: Chat Widget Integration & Setup : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000005913-chat-widget-integration-with-the-client-portal"},{"title":"HighLevel API Documentation - Developer Portal","url":"https://marketplace.gohighlevel.com/docs/ghl/conversations/conversations/index.html"},{"title":"Explore GoHighLevel Features: Complete List 2026 | DiscoverMyBusiness","url":"https://discovermybusiness.co/gohighlevel-features/"},{"title":"GitHub - GoHighLevel/highlevel-api-docs: This repo is our public documentation for API v2.","url":"https://github.com/GoHighLevel/highlevel-api-docs"},{"title":"Overview of the Voice AI Public APIs in HighLevel. : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000006379-voice-ai-public-apis"}]

I've found search results related to GoHighLevel API documentation. Here are the key resources for chat widget configuration endpoints:

## Primary Documentation Resources

The official HighLevel API documentation provides information about authentication methods, rate limits, available endpoints, OAuth setup, and developer resources.

The chat widget offers many configurations through the chat-widget builder, with some advanced configurations available beyond the standard builder interface.

The HighLevel API provides complete REST API documentation for the CRM platform, enabling developers to build integrations with contacts, conversations, calendar, payments, webhooks and more, with OAuth 2.0 authentication, SDKs, and developer resources included.

## Key Documentation Sources

1. **Official HighLevel Support Portal** - Contains guides for:
   - Chat widget setup, Web Chat (Live Chat) configuration, and website messaging channel management
   - Web Chat Widget advanced configurations and public API/events
   - Chat widget integration with Client Portal, with per-app visibility controls

2. **Developer Portal** (marketplace.gohighlevel.com/docs) - Contains source documentation for the GoHighLevel API V2 with structured endpoint references, parameters, request/response examples, and error codes.

3. **GitHub Repository** - The official public repository for GoHighLevel API V2 Docs is designed to help developers integrate with the HighLevel platform.

For the most current and detailed chat widget configuration endpoints, you'll want to visit the official documentation at help.gohighlevel.com or marketplace.gohighlevel.com/docs.

REMINDER: You MUST include the sources above in your response to the user using markdown hyperlinks.


content:
Web search results for query: "GoHighLevel API webchat automated responses bot flows"

Links: [{"title":"Conversation AI Bot – How to Automate Customer Chats : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000001335-conversation-ai-bot-explained"},{"title":"Setting Up Conversation AI: Streamline Client Engagement : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000004401-setting-up-conversation-ai"},{"title":"Easy to Install AI Chat Bot For Your Website","url":"https://www.gohighlevel.com/ai-chatbot"},{"title":"Master AI Bot Training: Web Crawler & Custom Responses Guide : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000004416-training-your-conversation-ai-bot"},{"title":"Conversation AI Flow Builder : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000006515-conversation-ai-flow-builder"},{"title":"Conversation AI: Multiple Messages in One Workflow Action : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000003207-conversation-ai-multiple-messages-in-one-workflow-action"},{"title":"Guided Form Based Setup for Conversation AI : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000005382-guided-form-based-setup-for-conversation-ai"},{"title":"Conversation AI - Transfer Bot Action : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000005371-conversation-ai-transfer-bot-action"},{"title":"GoHighLevel Conversation AI Bot -","url":"https://consultevo.com/gohighlevel-conversation-ai-bot-workflow-action/"},{"title":"How to Use the Conversation AI Workflow Action in HighLevel : HighLevel Support Portal","url":"https://help.gohighlevel.com/support/solutions/articles/155000001358-workflow-actions-conversation-ai"}]

I've completed the web search for GoHighLevel API webchat automated responses bot flows. Here are the key findings:

## Conversation AI Bot Overview

Conversation AI is an advanced communication system that automates customer interactions, using AI-powered bots designed to provide smarter, more flexible, and more efficient customer interactions when handling inquiries, providing support, and streamlining communication across multiple channels.

## Web Chat Integration

Once you've built your Conversation AI Bot and added "Web Chat" as a supported channel, the AI functionality will automatically be included when you install the chat widget on your HighLevel funnel/website.

## Automated Response Modes

GoHighLevel offers two operational modes:
- Suggestive: The bot responses are available inside the message composer box for the sub-account user to send as is or edit before sending.
- Auto-Pilot: The bot automatically responds to a contact on behalf of the business.

## Bot Flows & Flow Builder

Navigate to bot Goals tab > Click the Launch Flow Builder button. You can tell you're in the AI Flow Builder (not the Automation Workflow builder) because it says "Back to Conversation aI" and "Test Bot" instead of "Workflow".

The Guided Form Bot is a user-friendly setup option within Conversation AI that removes the need for manual prompt engineering. Instead, it walks you through creating a bot using a structured form. You define key goals—like collecting contact details or answering FAQs—and the system builds a logic-driven, objective-based conversation flow behind the scenes.

## Workflow Integration

The Conversation AI Workflow Action sends a single AI-generated message to a contact, waits for a reply, and routes the workflow based on the contact's response. It uses your bot's prompt settings and training to craft the reply and supports branching for different outcomes.

REMINDER: You MUST include the sources above in your response to the user using markdown hyperlinks.


text: Now let me fetch the detailed API documentation from the official sources:


WebFetch

prompt: What are the API endpoints for managing chat widgets? What parameters are available for configuring prompts, colors, and behavior?


prompt: What API endpoints exist for chat widget configuration? List the endpoint paths and HTTP methods.


content:
Based on the provided content, there is **no information about chat widget configuration API endpoints**.

The documentation page lists several API categories:
- "Manage contacts, leads, and customer data"
- "Handle SMS, email, and call communications"
- "Schedule appointments, manage calendar events"
- "Track sales pipeline, manage deals"
- "Process payments, manage subscriptions"
- "Real-time notifications for 50+ events"

However, chat widget configuration endpoints are not mentioned or detailed in this excerpt. To find those specific endpoints, you would need to explore the full API reference documentation or contact HighLevel's developer support.