Vivantio

Vivantio ist eine ausgezeichnete Software für das Kundenservicemanagement und bietet integrierte Funktionen, um den SMS-Versand mit nur wenigen Schritten hinzuzufügen. In diesem Dokument wird beschrieben, wie dies umgesetzt wird.

Einrichtung

Zuerst navigieren wir zu Admin → Integration & API → Webhooks.

Ticket-Typ auswählen

Wählen Sie einen Ticket-Typ aus dem Dropdown-Menü. In diesem Dokument verwenden wir Incident.

Grundlegende Details festlegen

Geben Sie einen Namen ein, um die Aktion zu beschreiben. Dies ist auch der Text des Buttons, der später im Aktions-Dropdown erscheint.

Setzen Sie die Request URL auf https://gateway.seven.io/api/sms.

Setzen Sie die HTTP-Methode auf POST.

Setzen Sie den Authentifizierungstyp auf Keine Authentifizierung.

Setzen Sie den Antwortinhaltstyp auf application/json.

Geben Sie eine Aktionsbeschreibung ein, um zu beschreiben, was passiert, wenn diese Aktion verwendet wird.

Parameter

Im Tab Parameter müssen wir einige Anforderungsparameter hinzufügen, um den Nachrichtenempfänger und den Nachrichtentext zu definieren.

Klicken Sie auf Hinzufügen, um einen neuen Parameter hinzuzufügen. Wir müssen zwei davon definieren:

Empfänger

Definiert den SMS-Empfänger.

Setzen Sie den Namen auf Empfänger.

Stellen Sie sicher, dass Schreibgeschützt nicht aktiviert ist.

Setzen Sie den Datentyp auf Alphanumerisch.

Setzen Sie den Anzeigetyp auf Freitext.

Setzen Sie die Standardquelle auf ticket.callerphone. Dies setzt die Telefonnummer des Ticketkontakts als Standardempfänger.

Text

Setzen Sie den Namen auf Text.

Stellen Sie sicher, dass Schreibgeschützt nicht aktiviert ist.

Setzen Sie den Datentyp auf Alphanumerisch.

Setzen Sie den Anzeigetyp auf Freitext (Mehrzeilig).

Lassen Sie die Standardquelle leer.

Anforderungstext

Im Tab Anforderungstext müssen wir definieren, wie die Nutzlast unserer API-Anforderung aussieht.

Vivantio Integration

Vivantio ist ein Dienst, der Unternehmen bei der Verwaltung von Kundenservice-Anfragen unterstützt. Mit der Integration können Sie automatisierte Benachrichtigungen und Aktionen direkt aus Ihrem Vivantio-System heraus ausführen.

Anfrageinhaltstyp festlegen

Setzen Sie den Anfrageinhaltstyp auf application/json.

Body-Template festlegen

Das Body-Template sollte wie folgt aussehen:

{
    "from": "optionale Absenderkennung",
    "p": "IHR_API_SCHLÜSSEL",
    "text": "{{text}}",
    "to": "{{to}}"
}

Webhook speichern

Klicken Sie auf Speichern, um Ihren ersten Webhook zu erstellen.

Rollen auswählen

Finden Sie die Schaltfläche Rollen in der Symbolleiste und klicken Sie darauf.

Verwenden Sie Drag & Drop, um sicherzustellen, dass Aktuelle Rollen nicht leer ist. Nur Benutzer, die dieser Rolle zugewiesen sind, können unseren Webhook nutzen.

Webhook testen

Öffnen Sie ein Ticket vom Typ Vorfall und drücken Sie die Schaltfläche Aktionen. Klicken Sie auf die Schaltfläche mit dem Namen, den Sie dem gerade erstellten Webhook gegeben haben.

Es erscheint das folgende Popup, in dem Sie Ihren SMS-Text im Feld Text eingeben.

Wenn der Benutzer eine Telefonnummer zugeordnet hat, wird diese als Standardwert im Feld Empfänger gesetzt. Sie können weitere Empfänger durch Komma getrennt hinzufügen.

Drücken Sie abschließend OK und Ihre SMS wird gesendet!