1. Home
  2. Drittanbieter
  3. Vivantio

Vivantio

Vivantio ist eine ausgezeichnete Kundenservice-Managementsoftware und ermöglicht den SMS-Versand mit nur wenig Einrichtungsaufwand. In diesem Dokument erläutere ich Ihnen die Einrichtung Schritt für Schritt.

Einrichtung

Zuerst navigieren wir nach Admin -> Integration & API -> Webhooks.

Einen Ticket-Typ bestimmen

Wählen Sie einen Ticket-Typ aus dem Dropdown-Menü. In diesem Dokument beschränken wir uns auf Incident.
Vivantio: Create Webhook

Generelle Details festlegen

Bei Name legen Sie eine Kurzbeschreibung dieser Aktion fest. Dieser Name fungiert auch als Button-Text, welcher später im Aktions-Dropdown erscheint.

Setzen Sie Request URL zu https://gateway.sms77.io/api/sms.
Setzen Sie HTTP Method zu POST.
Setzen Sie Authentication Type zu No Authentication.
Setzen Sie Response Content Type zu application/json.
Als Action Description kann eine für Sie plausible Erklärung folgen, welche detailliert beschreibt was bei Nutzung dieser Aktion passiert.

Vivantio: Basic Webhook Details

Parameter

Im Tab Parameters müssen wir die Anfrageparameter Empfänger*innen und Text festlegen.

Mittels Klick auf Add fügen wir einen neuen Parameter hinzu. Wir benötigen zwei Parameter wie folgt:

Recipients

Legt die Empfänger*innen der SMS fest.
Setzen Sie Name zu Recipients.
Stellen Sie sicher, dass bei Read Only kein Häkchen gesetzt ist.
Setzen Sie Data Type zu Alpha Numeric.
Setzen Sie Display Type zu Freetext.
Setzen Sie Default Source zu {{ticket.callerphone}}. Dieser Wert stellt sicher, dass standardmäßig die Rufnummer vom Ticketkontakt als Zielrufnummer gesetzt wird.

Vivantio: Recipients Parameter

Nachrichtentext

Setzen Sie Name zu Text.
Stellen Sie sicher, dass bei Read Only kein Häkchen gesetzt ist.
Setzen Sie Data Type zu Alpha Numeric.
Setzen Sie Display Type zu Freetext (Multiline).
Stellen Sie sicher, dass Default Source leer ist.

Vivantio: Text Parameter

Anfragekörper

Im Tab Request Body müssen wir festlegen, welche Informationen unsere API-Anfrage enthält.
Setzen Sie Request Content Type zu application/json.
Setzen Sie Body Template so, dass es ähnlich ist wie folgt:

{
  "from": "optionaleAbsenderkennungMitMaximal11AlphanumerischenOder16NumerischenZeichen",
  "p": "sms77ApiSchlüsselMussHierEingefügtWerden",
  "text": "{{text}}",
  "to": "{{to}}"
}

Vivantio: Request Body

Webhook speichern

Klicken Sie auf Save um die Erstellung Ihrer ersten Webhook abzuschließen.

Rolle(n) auswählen

Lokalisieren Sie den Button Roles in der Werkzeugleiste und klicken Sie diesen.
Nutzen Sie drag & drop um sicherzustellen, dass Current Roles nicht leer ist. Nur Benutzer mit diesen Rollen zugewiesen können von dieser Webhook Gebrauch machen.
Vivantio: Select Roles

Webhook testen

Öffnen Sie ein Ticket vom Typ Incident und drücken Sie den Button Actions in der Werkzeugleiste. In dem darauffolgendem Dropdown-Menü drücken Sie bitte auf Send SMS via sms77.
Vivantio: Send SMS

Es öffnet sich jetzt ein Popup-Menü, wo Sie im Feld Text Ihre Nachricht eingeben können.
Ist das Ticket mit einem Kontakt verknüpft, welchem eine Rufnummer zugewiesen ist, wird dieser Wert bei Recipients hinterlegt. Sie können weitere Rufnummern per Komma getrennt hinzufügen.

Abschließend drücken Sie OK und Ihre SMS wird versendet!

Vivantio: Compose SMS