Events

Das Embed löst CustomEvents auf window aus, damit du ohne Polling auf Lebenszyklus und Interaktion reagieren kannst. Für nahezu alle Integrationen reichen diese Events zusammen mit den Methoden aus. Jedes Event enthält diese Felder in event.detail:

Feld	Typ	Beschreibung
`chatbotId`	`string`	ID des Assistenten
`storeId`	`string \| undefined`	ID des Stores, wenn eine konfiguriert oder ermittelt wurde
`chatId`	`string \| undefined`	ID der Konversation, sobald eine Konversation existiert
`occurredAt`	`string`	Zeitpunkt des Events als ISO-8601-Zeitstempel

Browser-Events

Event	Wann es ausgelöst wird	`event.detail`
`homiebot:api-ready`	`window.homieBot` ist verfügbar	Gemeinsame Felder
`homiebot:assistant-ready`	Das Chat-Iframe ist bereit für `sendMessage` / `getHistory`	Gemeinsame Felder
`homiebot:opened`	Das Chat-Widget wurde geöffnet	Gemeinsame Felder
`homiebot:closed`	Das Chat-Widget wurde geschlossen	Gemeinsame Felder
`homiebot:chat-started`	Für die erste Nutzernachricht wurde eine neue Konversation angelegt	Gemeinsame Felder; `chatId` ist erforderlich
`homiebot:message-sent`	Eine gültige Nutzernachricht wurde hinzugefügt und der Versand gestartet	Gemeinsame Felder plus `inputType`
`homiebot:message-received`	Eine vollständige Assistentenantwort wurde empfangen	Gemeinsame Felder plus `messageId`, `productCount`
`homiebot:chat-reset`	Eine bestehende Konversation wurde zurückgesetzt	Gemeinsame Felder plus `reason`
`homiebot:product-clicked`	Ein empfohlenes Produkt wurde ausgewählt	Gemeinsame Felder plus `product`
`homiebot:feedback-submitted`	Like- oder Dislike-Feedback wurde abgegeben	Gemeinsame Felder plus `messageId`, `rating`

homiebot:opened und homiebot:closed werden bei jeder Öffnen-/Schließen-Aktion ausgelöst — über den Launcher-Button, die Willkommens-Bubbles, window.homieBot.open() / .close() / .toggle() sowie über Aktionen aus dem Chat heraus.

Inhalte von Nachrichten und Antworten, Nutzer-IDs, Feedback-Freitext und interne Fehler sind niemals Bestandteil der Browser-Event-Payloads.

Auf die API hören

Wird ausgelöst, sobald window.homieBot nutzbar ist.

window.addEventListener('homiebot:api-ready', (e) => {
  const { chatbotId } = e.detail;
  console.log('homie API ready', chatbotId);
  window.homieBot.open();
});

Auf den Assistenten hören

Wird ausgelöst, sobald das Iframe für sendMessage und getHistory bereit ist.

window.addEventListener('homiebot:assistant-ready', () => {
  window.homieBot.sendMessage({ text: 'Hello', newChat: false });
});

Konversations-Funnel tracken

Nützlich, um Interaktionen an Analytics weiterzugeben.

window.addEventListener('homiebot:opened', (e) => {
  window.dataLayer?.push({ event: 'homie_chat_opened', chatbotId: e.detail.chatbotId });
});

window.addEventListener('homiebot:chat-started', (e) => {
  window.dataLayer?.push({
    event: 'homie_chat_started',
    chatbotId: e.detail.chatbotId,
    chatId: e.detail.chatId,
    storeId: e.detail.storeId,
  });
});

window.addEventListener('homiebot:message-received', (e) => {
  window.dataLayer?.push({
    event: 'homie_message_received',
    chatId: e.detail.chatId,
    productCount: e.detail.productCount,
  });
});

Interaktions-Payloads

Nachricht gesendet

inputType ist text, speech, suggestion, pdp-question oder api.

{
  chatbotId: 'assistant-id',
  storeId: 'store-id',
  chatId: 'chat-id',
  occurredAt: '2026-07-30T12:34:56.000Z',
  inputType: 'suggestion'
}

Nachricht empfangen

Dieses Event wird einmal für die vollständige Antwort ausgelöst, auch bei gestreamten Antworten. productCount ist 0, wenn die Antwort keine Produktempfehlungen enthält.

{
  chatbotId: 'assistant-id',
  storeId: 'store-id',
  chatId: 'chat-id',
  occurredAt: '2026-07-30T12:34:57.000Z',
  messageId: 'message-id',
  productCount: 3
}

Chat zurückgesetzt

reason ist manual, inactivity oder api. Die chatId bezeichnet die zurückgesetzte Konversation.

Produkt angeklickt

Das product-Objekt enthält ausschließlich gtin, brand, designation und url.

Feedback abgegeben

rating ist entweder like oder dislike. Feedback-Gründe und Freitext werden nicht offengelegt.

REST API

Client-API

Browser-Events

Auf die API hören

Auf den Assistenten hören

Konversations-Funnel tracken

Interaktions-Payloads

Nachricht gesendet

Nachricht empfangen

Chat zurückgesetzt

Produkt angeklickt

Feedback abgegeben

​Browser-Events

​Auf die API hören

​Auf den Assistenten hören

​Konversations-Funnel tracken

​Interaktions-Payloads

​Nachricht gesendet

​Nachricht empfangen

​Chat zurückgesetzt

​Produkt angeklickt

​Feedback abgegeben

Browser-Events

Auf die API hören

Auf den Assistenten hören

Konversations-Funnel tracken

Interaktions-Payloads

Nachricht gesendet

Nachricht empfangen

Chat zurückgesetzt

Produkt angeklickt

Feedback abgegeben