ERP-APIs

Aktualisiert am

Wo: Einstellungen > Integrationen > ERP-APIs

Wofür es da ist:

Binden Sie Ihre eigenen Systeme als Schaltflächen neben jedem Chat ein. Öffnet ein Mitarbeiter eine Unterhaltung, fragt SyBox die Daten zu diesem Kunden in Ihrem System ab und blendet das Ergebnis direkt neben dem Chat ein – ganz ohne Systemwechsel. Das können Bestellungen, Kontostände, Tickets oder beliebige andere Rückmeldungen sein. SyBox übermittelt dabei die Telefonnummer des Kunden bzw. bei E-Mail-Chats dessen E-Mail-Adresse.

Es gibt drei Typen von ERP-APIs:

  • „Seitenleisten-Tab — Daten neben dem Chat anzeigen“: Eine Schaltfläche in der Seitenleiste des Posteingangs. Ein Klick zeigt die Daten Ihres Systems zum aktuell geöffneten Kunden an.
  • „Nachrichtenaktion — eine Nachricht aus ihrem Menü senden“: Ein neuer Eintrag im Menü eingehender WhatsApp-Nachrichten. Der Mitarbeiter wählt ihn aus, kann den Text anpassen und klickt auf Senden. SyBox übergibt den Text an Ihr System. Ihr System kann mit „Fertig“ antworten, einen Fehler melden, eine Ja/Nein-Frage stellen oder eine einzeilige Eingabe verlangen.
  • „Produkte — Katalog durchsuchen und Artikel in den Chat senden“: Der Mitarbeiter tippt den Kundenwunsch ein. Ihr System liefert passende Produkte als Karten mit Name, Preis, Bild und Bestand zurück. Ein Klick genügt, um den Produktlink direkt in das Nachrichtenfeld einzufügen.

So fügen Sie eine ERP-API hinzu

  1. Gehen Sie zu Einstellungen > Integrationen > ERP-APIs.
    Settings, ERP APIs: a connected stock system that shows as a button in conversations
  2. Klicken Sie auf „ERP-API hinzufügen“.
    The new ERP API window: its type first, then its name, button and address
  3. Wählen Sie den passenden „Typ“ (siehe die drei Typen oben).
  4. Geben Sie unter „Anzeigename“ die vollständige Bezeichnung der Integration ein.
  5. Vergeben Sie unter „Schaltflächenname“ die kurze Beschriftung für die Schaltfläche oder den Menüpunkt.
  6. Wählen Sie unter „Schaltflächensymbol“ das gewünschte Icon aus.
  7. Fügen Sie unter „ERP-API-URL“ die Adresse Ihres Systems ein. Sie muss mit http:// oder https:// beginnen.
  8. Tragen Sie unter „ERP-Token“ das Token Ihres Systems ein, sofern eines verwendet wird. SyBox sendet es bei jedem Aufruf mit, damit Ihr System die Anfrage verifizieren kann.
  9. Optional: Klicken Sie unter „Benutzerdefinierte Header“ auf „Header hinzufügen“, um bei jeder Anfrage zusätzliche Name-Wert-Paare mitzuschicken, etwa eine Filialkennung. Jeder Header lässt sich per Schalter pausieren, ohne ihn zu löschen. Klicken Sie auf das Papierkorb-Symbol, um einen Header zu entfernen. Einzelne Header-Namen, die SyBox intern nutzt, werden ignoriert.
  10. Klicken Sie auf Speichern.

Die neue Schaltfläche ist im Posteingang sofort verfügbar – ein Neuladen der Seite ist nicht erforderlich.

So bearbeiten, pausieren oder löschen Sie eine ERP-API

  1. Suchen Sie die Karte in der Übersicht ERP-APIs.
  2. Klicken Sie auf Bearbeiten, um Anpassungen vorzunehmen. Um ein hinterlegtes Token beizubehalten, lassen Sie „ERP-Token“ leer („Leer lassen, um aktuell zu bleiben“).
    To edit, pause or delete an ERP API: "Edit" marked on the screen in SyBox
  3. Klicken Sie auf Aktivieren / Deaktivieren, um die Schaltfläche im Posteingang ein- oder auszublenden. Deaktivierte Einträge sind als „Deaktiviert“ markiert.
  4. Klicken Sie auf Löschen und bestätigen Sie mit „Diese Integration löschen?“.

Was die Karte anzeigt: Name, Schaltflächenname, URL sowie „Aktiv“ oder „Deaktiviert“. Wurde kein Token hinterlegt, steht dort „Kein Token“. Ist ein Token gespeichert, sind nur dessen letzte Zeichen zu sehen.

Regeln und Meldungen:

  • „Anzeigename“, „Schaltflächenname“ und „ERP-API-URL“ sind Pflichtfelder. Fehlt eine Angabe, erscheint „Unvollständige Daten“.
  • Die Webadresse muss mit http:// oder https:// beginnen.

Einrichtung auf Ihrer Seite: Die öffentliche SyBox-Entwicklerdokumentation (auf der SyBox-Website unter Entwickler) beschreibt im Detail, welche Parameter SyBox sendet und wie Ihr System antworten muss. Dies umfasst Ausgabeformate, anklickbare Zeilen zum Öffnen von Detailansichten und die Produktsuche.

Ich habe eine ERP-API angelegt, aber neben dem Chat erscheint keine Schaltfläche.

Prüfen Sie, ob die Karte auf „Aktiv“ steht. Die Typen „Seitenleisten-Tab“ und „Produkte“ erzeugen Schaltflächen in der Seitenleiste. Der Typ „Nachrichtenaktion“ erscheint nicht in der Leiste, sondern als Eintrag im Menü eingehender WhatsApp-Nachrichten.

Das Seitenfenster öffnet sich, zeigt aber keine Daten oder meldet einen Fehler.

SyBox spiegelt die Antwort Ihres Systems wider. Stellen Sie sicher, dass Ihre URL über das Internet erreichbar ist, das Token stimmt und Ihr System den Kunden anhand von Telefonnummer (oder E-Mail-Adresse bei E-Mail-Nachrichten) zuordnen kann.

Kann ich mehrere Systeme verknüpfen?

Ja. Legen Sie so viele ERP-APIs an, wie Sie benötigen. Jede erhält eine eigene Schaltfläche.

Wer kann die Daten im Fenster sehen?

Alle Teammitglieder, die berechtigt sind, die jeweilige Unterhaltung im Posteingang zu öffnen.