Track Chatbot Events in Google Analytics 4

Set Up a Webhook in Chatonbo

In the Chatonbo dashboard, navigate to your bot and click the "Integrations" tab. Add a new webhook and enter the URL of your server endpoint or cloud function (you will create this in Step 2). Chatonbo will send a POST request to this URL every time a relevant event occurs — new conversation, new message, lead captured, etc.

The webhook payload includes the bot ID, conversation ID, event type, visitor data, and page URL — everything you need to send meaningful events to GA4.

Create a Server Endpoint or Cloud Function

You need a lightweight endpoint to receive the Chatonbo webhook and forward events to GA4. The most common options:

• Google Cloud Function — free tier includes 2M invocations/month
• AWS Lambda — free tier includes 1M requests/month
• Your own server — a simple Express.js or Python Flask endpoint

The endpoint should parse the incoming Chatonbo webhook payload, map it to a GA4 event, and forward it using the GA4 Measurement Protocol.

Use the GA4 Measurement Protocol to Send Events

The GA4 Measurement Protocol lets you send events server-side via a simple HTTP POST request. You will need your GA4 Measurement ID (starts with G-) and an API Secret (create one in GA4 under Admin > Data Streams > your stream > Measurement Protocol API secrets).

POST https://www.google-analytics.com/mp/collect
  ?measurement_id=G-XXXXXXXXXX
  &api_secret=YOUR_API_SECRET

{
  "client_id": "chatonbo_visitor_id",
  "events": [{
    "name": "chatbot_message",
    "params": {
      "bot_id": "abc-123",
      "bot_name": "Support Bot",
      "conversation_id": "conv-456",
      "page_url": "https://example.com/products"
    }
  }]
}

Use the visitor's session ID from the Chatonbo webhook payload as the client_id for consistent user tracking across chatbot and web analytics.

Define Custom Events in GA4

In Google Analytics 4, go to Admin > Events and create these custom events to categorize chatbot interactions:

Mark lead_captured as a conversion event in GA4 to track it in your conversion reports alongside form submissions and purchases.

Create Custom Dimensions in GA4

Go to Admin > Custom Definitions > Custom Dimensions and add these dimensions to enrich your chatbot analytics:

These dimensions let you filter and segment your GA4 reports by bot, conversation, and page — giving you granular insight into chatbot performance across your website.

Build a Custom Dashboard in GA4

Go to Reports > Library > Create New Report in GA4 and build a custom chatbot dashboard. Recommended widgets:

• Total chatbot conversations over time (line chart)
• Lead capture rate by page (bar chart)
• Messages per conversation (average metric)
• Top pages by chatbot engagement (table)
• Chatbot conversion funnel: opened > messaged > lead captured (funnel)

This dashboard becomes your single source of truth for chatbot performance — share it with your marketing team, managers, or clients.