Zakelijke functies

Conversies bijhouden met GTM (Google Tag Manager)

Je kunt bijhouden wanneer gebruikers tools binnen Eloquent activeren (bijvoorbeeld wanneer een gesprek via e-mail wordt gedeeld) door te luisteren naar de eloquent:toolcall-event. Dit is vooral handig voor AI-agents die op websites draaien.

Deze gebeurtenis wordt verstuurd telkens wanneer er een tool wordt aangeroepen vanuit je ingesloten Eloquent-agent, en kan worden gekoppeld aan analytics- of conversietrackingsystemen zoals Google Tag Manager (GTM) en Google Analytics 4 (GA4).

Over de `eloquent:toolcall`-event

Telkens wanneer een tool wordt uitgevoerd binnen een ingesloten Eloquent-agent, zendt het systeem een CustomEvent uit met de naam eloquent:toolcall.
Je kunt er direct in je JavaScript naar luisteren om analytics af te handelen, te loggen of andere acties te triggeren.

Voorbeeld van event payload

Zo ziet het detail-object van de gebeurtenis eruit:

{
  "toolCallId": "call_Zb1CxxWyBfdkSJBcdaRzzKkZ",
  "toolName": "share_conversation_via_email",
  "args": {
    "to": "[email protected]",
    "subject": "New lead: track conversion with GTM and GA4",
    "bcc": [
      "[email protected]"
    ]
  }
}

Luisteren naar de gebeurtenis

Om te reageren op tool-aanroepen, voeg je een event listener toe aan het globale document of aan de specifieke iframe waarin je Eloquent-agent draait:

<script defer>
document.addEventListener("eloquent:toolcall", function(event) {
  var toolCallId = event.detail.toolCallId;
  var toolName = event.detail.toolName;
  var args = event.detail.args;
  window.dataLayer = window.dataLayer || [];
  window.dataLayer.push({
    event: "eloquent_toolcall",
    toolCallId: toolCallId,
    toolName: toolName,
    args: args
  });
});
</script>

Hiermee push je de eventdata naar de dataLayer van GTM, zodat je tags kunt triggeren, events naar GA4 kunt sturen of conversies kunt registreren.

Tracking instellen in Google Tag Manager (GTM)

Zodra de gebeurtenis in de dataLayer is gepusht, volg je deze stappen binnen je GTM-container.

1. Maak een Custom Event-trigger

Ga naar Triggers → New
Kies Trigger Type: Custom Event
Stel Event Name in op: eloquent_toolcall
(Optioneel) Voeg filters toe, bijvoorbeeld: toolName equals share_conversation_via_email
Sla de trigger op als: Trigger – Eloquent Tool Call

2. Maak een GA4-eventtag

Ga naar Tags → New
Kies Tag Type: Google Analytics: GA4 Event
Selecteer je GA4 Configuration Tag
Stel Event Name in, bijvoorbeeld: eloquent_toolcall
Onder Event Parameters kun je eventdetails doorgeven:
- toolCallId → {toolCallId}
- toolName → {toolName}
- args → {args}
Koppel je trigger Trigger – Eloquent Tool Call.
Opslaan en publiceren.

3. Markeer het als een conversie in GA4

Om specifieke tools als conversies te tracken (bijvoorbeeld wanneer gebruikers een gesprek via e-mail delen):

Ga naar je GA4 Admin → Events
Zoek de eventnaam eloquent_toolcall
Zet Mark as conversion aan

Vanaf nu zal GA4 elke keer dat een gebruiker een tool activeert (zoals share_conversation_via_email) registreren als een conversie-event.

Analytics & rapportages

ISO 27001