Events

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

Browser-Events

Event	Wann es ausgelöst wird	`event.detail`
`homiebot:api-ready`	`window.homieBot` ist verfügbar	`{ chatbotId }`
`homiebot:assistant-ready`	Das Chat-Iframe ist bereit für `sendMessage` / `getHistory`	`{ chatbotId }`
`homiebot:opened`	Das Chat-Widget wurde geöffnet	`{ chatbotId }`
`homiebot:closed`	Das Chat-Widget wurde geschlossen	`{ chatbotId }`

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.

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 });
});

Öffnen und Schließen 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:closed', (e) => {
  window.dataLayer?.push({ event: 'homie_chat_closed', chatbotId: e.detail.chatbotId });
});

REST API

Client-API

Browser-Events

Auf die API hören

Auf den Assistenten hören

Öffnen und Schließen tracken

​Browser-Events

​Auf die API hören

​Auf den Assistenten hören

​Öffnen und Schließen tracken

Browser-Events

Auf die API hören

Auf den Assistenten hören

Öffnen und Schließen tracken