So aktivieren Sie das Gateway und erstellen einen Schlüssel

Aktualisiert am

In SyBox erfolgt dies unter Einstellungen > Integrationen > API-Schlüssel. 1) Gehen Sie zu Einstellungen > Integrationen > API-Schlüssel. 2) Schalten Sie den Schalter "API-Gateway" ein. 3) Klicken Sie auf "Neuer Schlüssel". 4) Wählen Sie den "Schlüsseltyp": 5) Füllen Sie "Geräte- oder Programmname" aus, zum Beispiel "Büro-PC" oder "Buchhaltungssystem". Vergeben Sie für jedes Gerät oder Programm einen eigenen Schlüssel. 6) Für einen Schlüssel vom Typ "Über WhatsApp senden" legen Sie…

  1. Gehen Sie zu Einstellungen > Integrationen > API-Schlüssel.
  2. Schalten Sie den Schalter "API-Gateway" ein.
  3. Klicken Sie auf "Neuer Schlüssel".
    Settings, API keys: keys that let another program send through SyBox, and the "New key" button
  4. Wählen Sie den "Schlüsseltyp":
    • "Über WhatsApp senden": Das Programm sendet Nachrichten an Ihre Kunden.
    • "Fall anlegen": Das Programm öffnet Fälle in SyBox. Es kann keine Nachrichten senden.
    • "SMS von einem Telefon importieren": Ein Smartphone leitet seine SMS-Nachrichten in den Posteingang weiter.
  5. Füllen Sie "Geräte- oder Programmname" aus, zum Beispiel "Büro-PC" oder "Buchhaltungssystem". Vergeben Sie für jedes Gerät oder Programm einen eigenen Schlüssel.
  6. Für einen Schlüssel vom Typ "Über WhatsApp senden" legen Sie außerdem fest:
    • "Sendet von": die WhatsApp-Nummer, von der dieser Schlüssel sendet (erforderlich).
    • "Freitextnachrichten erlauben": an oder aus.
    • "Genehmigte Vorlagen erlauben": an oder aus. Mindestens eine dieser beiden Optionen muss aktiv sein, andernfalls erscheint: "Erlauben Sie mindestens Freitext oder Vorlagen — andernfalls kann der Schlüssel nichts senden."
    • "Senden von Medien erlauben": an oder aus.
    • "Vorlagen" (optional): Vorlagennamen, getrennt durch Kommas. Leer lassen, um alle Vorlagen zu erlauben.
    • "Erlaubte Empfängerländer" (optional): zweistellige Ländercodes, z. B. MA,FR,EG. Leer lassen, um jedes Land zu erlauben.
    • "Senden erlaubt von" ... "Zu": das Zeitfenster, in dem der Schlüssel senden darf. Lassen Sie beide Zeiten identisch für unbegrenzte Sendezeiten. Die Zeiten beziehen sich auf die Ortszeit des Arbeitsbereichs.
    • "Tägliches Nachrichtenlimit (0 = unbegrenzt)".
  7. Für einen Schlüssel vom Typ "SMS von einem Telefon importieren" aktivieren Sie "Nur Kontakte und Kunden". Wenn dies aktiv ist, verbleibt eine SMS von jeder anderen Nummer auf dem Telefon und gelangt nicht in den Posteingang. Deaktivieren Sie dies nur, wenn das Telefon ausschließlich beruflich genutzt wird.
  8. Klicken Sie auf Speichern.
  9. Ein Fenster zeigt die "Basis-URL" und den "API-Schlüssel". Kopieren Sie diese jetzt. "Kopieren Sie diesen Schlüssel jetzt — er wird nur einmal angezeigt." Hinterlegen Sie sie in den Einstellungen Ihres Programms.

Fragen

Ich habe meinen API-Schlüssel verloren. Kann ich ihn noch einmal sehen?

Nein. Er wird nur ein einziges Mal angezeigt. Erstellen Sie einen neuen Schlüssel, tragen Sie ihn in Ihr Programm ein und löschen Sie den alten.

Ich befürchte, ein Schlüssel wurde kompromittiert. Was soll ich tun?

Löschen oder deaktivieren Sie diesen Schlüssel unverzüglich. Nur dieser Schlüssel verliert seine Gültigkeit. Ihre WhatsApp-Nummer und Ihre übrigen Schlüssel bleiben unberührt.

Die Liste "Sendet von" ist leer.

Die Liste führt nur WhatsApp-Nummern auf, die verknüpft und eingeschaltet sind. Verbinden Sie zuerst eine Nummer unter Einstellungen > Messaging > Kanäle.

Mein Programm wird beim Senden abgewiesen.

Prüfen Sie, ob das "API-Gateway" eingeschaltet und der Schlüssel aktiv ist. Prüfen Sie auch die Einschränkungen des Schlüssels: Freitext vs. Vorlagen, Medien, erlaubte Vorlagen, Länder, Sendezeiten und das Tageslimit. Zudem gelten weiterhin die Richtlinien von WhatsApp. Freitext funktioniert beispielsweise nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden.

Kann ein Schlüssel vom Typ "Fall anlegen" auch Nachrichten senden?

Nein, das ist bewusst so geregelt. Ein Schlüssel zur Fallerstellung kann Kunden keine Nachrichten schreiben, und ein Sendeschlüssel kann keine Fälle anlegen. Verwenden Sie für jede Aufgabe einen separaten Schlüssel.

Ich habe noch einen alten Schlüssel vom Typ "Von einem Programm empfangen". Funktioniert dieser weiterhin?

Ja, bestehende Schlüssel dieses Typs bleiben funktionsfähig. Neue Schlüssel dieses Typs können jedoch nicht mehr erstellt werden. Verwenden Sie dafür künftig "Fall anlegen".

Mehr über API-Schlüssel.