Integrationen & Technik

🔹 Wie integriere ich mein Helpdesk-System (z. B. Zendesk, Freshdesk)?

  • Verwende im Chatflow den E-Mail-Knoten oder Ticket-Knoten, um Anfragen automatisch an dein Helpdesk-System zu senden.

  • Du kannst:

    • Den Empfänger (z. B. [email protected]envelope) festlegen.

    • Betreff, Nachricht und Anhänge (z. B. Chatverlauf) definieren.

    • Ticket-Metadaten als Variable mitgeben (z. B. Kategorie, Nutzername).

  • Alternativ erfolgt die Integration über Webhook-Knoten, um REST-APIs des Helpdesk-Systems direkt anzusprechen.


🔹 Wie funktioniert die automatische Ticket-Kategorisierung?

  • Du kannst in deinen Flows mit Bedingungsknoten oder Intent-Zuordnung steuern, welche Kategorie ein Ticket erhält.

  • Beispiel: Wenn Intent = „Bestellung“, dann category = "Order".

  • Diese Kategorie wird als Variable im Ticket mitgesendet (z. B. als Tag oder Feld in Zendesk/Freshdesk).

  • Auch über Webhooks kann die Kategorie direkt an das Helpdesk übertragen werden.


🔹 Wie füge ich Produktinformationen für die Produktberatung hinzu?

  • Lege Produktdaten als Knowledge Pieces an:

    • Text Piece für manuelle Infos

    • File Piece für z. B. PDF-Kataloge

    • Web Piece für Produkt-Detailseiten

  • Struktur:

    • Ein Produkt = ein Piece

    • Ordner z. B. nach Kategorie („T-Shirts“, „Elektronik“)

  • Der Bot kann dann bei Fragen automatisch relevante Produkte vorschlagen.


🔹 Wie importiere ich Produktdaten über Dateien?

  • Du kannst Produktdaten als PDF-Dateien hochladen:

    • Über den File Piece-Knoten.

    • Optional: Nur bestimmte Seiten extrahieren (z. B. Seite 3–5).

  • Alternativ: Inhalte aus Excel oder CSV manuell in Text Pieces überführen.

  • Wichtig: Die Datei-Inhalte werden indexiert und für den Bot durchsuchbar gemacht.


🔹 Wie binde ich den melibo Chatbot technisch in meine Website ein?

  • Es gibt zwei Einbindungsarten:

    1. HTML-Snippet:

      • Code in den <body> deiner Website einfügen.

      • Besteht aus JavaScript-Loader + <melibo-webchat> Komponente.

    2. JavaScript-Integration:

      • Widget dynamisch über JS einbinden (z. B. bei bestimmten Events).

  • API-Key und Environment-ID findest du im Bereich Chatbot Styler > Installation.

  • Für mehrere Umgebungen kannst du verschiedene Widget-Instanzen nutzen (Staging vs. Live).


🔹 Wie integriere ich melibo in Shop-Systeme (z. B. Shopify, Shopware, Xentral)?

  • Shopify & Shopware:

    • Einbindung des Widgets über Theme-Editor oder Tag Manager möglich.

    • Produktinfos können über APIs oder direkte Verlinkung im Bot ausgespielt werden.

  • Xentral:

    • Datenzugriff über API/Webhooks möglich.

    • Der Bot kann z. B. Bestellstatus abfragen oder Nutzer verifizieren.

  • Voraussetzungen:

    • API-Zugang oder Zugriff auf Shop-Frontend

    • Falls vorhanden, REST-API-Dokumentation prüfen


🔹 Wie füge ich API-Integrationen oder Webhooks hinzu?

  • Im Chatflow-Builder gibt es den Webhook-Knoten:

    • Hier kannst du externe APIs ansprechen (z. B. CRM, ERP, Shops).

    • Übergib Werte als Body, Header oder URL-Parameter (inkl. Variablen).

    • Verwende die Antwort des Webhooks dynamisch im nächsten Knoten.

  • Beispiel: Bestellstatus abrufen, Authentifizierung prüfen, Produkte vorschlagen.


🔹 Wie erkenne und behebe ich Integrationsfehler (Shop, Helpdesk, API)?

Fehlererkennung:

  • Im Webhook-Knoten werden Fehlermeldungen (z. B. Status 400 oder 500) angezeigt.

  • Nutze die Antwortvariable (z. B. webhookResponse.error) zur Weiterleitung an Fehlerknoten.

  • Teste den Webhook direkt mit Testdaten im Flow.

Fehlerbehebung:

  • Prüfe:

    • URL korrekt?

    • Header/Token richtig gesetzt?

    • Payload-Format stimmt?

    • Antwortstruktur wie erwartet?

  • Logik im Flow prüfen (z. B. richtige Bedingung für Weiterleitung bei Fehler).

  • Bei Helpdesk-Fehlern: E-Mail-Header, Anhänge und Adressen kontrollieren.

  • Nutze ggf. einen Debug-Intent oder eine interne Testumgebung.

Zuletzt aktualisiert

War das hilfreich?