Placetel-Verbindung für Zammad einrichten

Bemerkung

Dieser Konfigurationsschritt erfordert ein vollständiges administratives Placetel-Konto. Sie können Fehlermeldungen erhalten, wenn Ihre Berechtigungen dafür nicht ausreichen.

Die folgenden Aktionen können über Placetels Webschinterface konfiguriert werden.

Schritt 1: Aktivieren der Zammad-Integration

Scrollen Sie innerhalb von Integrationen nach unten zu Partnerintegrationen und wählen Sie Zammad.

Sie können alternativ nach „Ticket-Systemen“ filtern, um die Anzahl der Einträge auf der Seite zu reduzieren. 🤓

Innerhalb der Zammad-Integration klicken Sie nun auf „Aktivieren“. Ein neuer Tab API wird verfügbar - öffnen Sie diesen Tab.

Setzen Sie nun ein Häkchen bei „Enable Call Control / Notify API“ und fügen Sie den Placetel-Endpunkt aus Ihrer Zammad-Instanz in das Feld „URL of your API endpoint“ ein. Speichern, um die Einstellungen zu übernehmen

Screencast, der zeigt, wie die Zammad-Integration aktiviert wird
Schritt 2: API-Token für Placetel generieren

Gehen Sie zurück zur Seite „Integrationen“ und scrollen Sie nach unten zu „Web API“. Erzeugen Sie ein neues API-Token, indem Sie die Schaltfläche „Neues API-Token erstellen“ verwenden.

Bemerkung

Wenn Sie bereits einen Token generiert haben, verwenden Sie entweder Ihren bestehenden Token oder setzen Sie ihn mit der oben genannten Schaltfläche zurück. Placetel wird Sie auffordern, diese Rücksetzung zu bestätigen.

Bitte beachten Sie, dass bestehende API-Skripte aufgrund der Neu-Generierung des Tokens möglicherweise nicht mehr funktionieren!

Kopieren Sie das bereitgestellte API-Token und fügen Sie es in das Feld „API Token“ in der Placetel-Integration von Zammad ein.

Übernehmen Sie Ihre Änderungen über die Schaltfläche „Speichern“ am unteren Rand der Placetel-Integrationsseite und aktivieren Sie die Placetel-Integration.

Screencast, der zeigt, wie man ein API-Token von Placetel für Zammad abruft
Schritt 3: Beschränken Sie die zu benachrichtigenden Nummern

Haben Sie viele Nummern, die nicht für die Benachrichtigung in Zammad verwendet werden sollen? Gehen Sie auf der Integrations-Seite der Placetel-Weboberfläche auf „Notify API“.

Weiter unten auf der Seite ermöglicht Placetel die Einschränkung der zu benachrichtigenden Nummern. Sie finden dies im Abschnitt „External routing API“.

Screenshot mit einer Beispielauswahl von Telefonnummern für die Placetel Notify API

Hinweis

Dieser Menüpunkt bietet auch ein API-Anfrageprotokoll aus Placetel-Sicht. Öffnen Sie einfach „Recent responses of your API endpoint“, um mehr zu erfahren.

Wenn Sie Zammads Perspektive sehen möchten, verwenden Sie den Bereich „Aktuellste Protokolle“ auf der Placetel-Integrationsseite in Zammad.

Screenshot mit Beispielprotokolleinträgen für Placetels API-Anfragen an Zammad
Schritt 4 (optional): Weitere Konfigurationen für Placetel

Bei Bedarf können Sie nun die Placetel-Integration von Zammad detaillierter konfigurieren. Erfahren Sie hier mehr über Ihre Optionen Placetel-Integrationseinstellungen.