{"id":32220,"date":"2021-12-09T10:58:18","date_gmt":"2021-12-09T09:58:18","guid":{"rendered":"https:\/\/www.sms77.io\/docs\/drittanbieter\/vivantio\/"},"modified":"2021-12-10T11:00:54","modified_gmt":"2021-12-10T10:00:54","slug":"vivantio","status":"publish","type":"docs","link":"https:\/\/www.seven.io\/de\/docs\/drittanbieter\/vivantio\/","title":{"rendered":"Vivantio"},"content":{"rendered":"

Vivantio ist eine ausgezeichnete Kundenservice-Managementsoftware und erm\u00f6glicht den SMS-Versand mit nur wenig Einrichtungsaufwand. In diesem Dokument erl\u00e4utere ich Ihnen die Einrichtung Schritt f\u00fcr Schritt.<\/p>\n

Einrichtung<\/h2>\n

Zuerst navigieren wir nach Admin -> Integration & API -> Webhooks<\/i>.<\/p>\n

Einen Ticket-Typ bestimmen<\/h3>\n

W\u00e4hlen Sie einen Ticket-Typ aus dem Dropdown-Men\u00fc. In diesem Dokument beschr\u00e4nken wir uns auf Incident<\/i>.
\n\"Vivantio:<\/p>\n

Generelle Details festlegen<\/h3>\n

Bei Name<\/i> legen Sie eine Kurzbeschreibung dieser Aktion fest. Dieser Name fungiert auch als Button-Text, welcher sp\u00e4ter im Aktions-Dropdown erscheint.<\/p>\n

Setzen Sie Request URL<\/i> zu https:\/\/gateway.sms77.io\/api\/sms<\/b>.
\nSetzen Sie HTTP Method<\/i> zu POST<\/b>.
\nSetzen Sie Authentication Type<\/i> zu No Authentication<\/b>.
\nSetzen Sie Response Content Type<\/i> zu application\/json<\/b>.
\nAls Action Description<\/i> kann eine f\u00fcr Sie plausible Erkl\u00e4rung folgen, welche detailliert beschreibt was bei Nutzung dieser Aktion passiert.<\/p>\n

\"Vivantio:<\/p>\n

Parameter<\/h3>\n

Im Tab Parameters<\/i> m\u00fcssen wir die Anfrageparameter Empf\u00e4nger*innen und Text<\/i> festlegen.<\/p>\n

Mittels Klick auf Add<\/i> f\u00fcgen wir einen neuen Parameter hinzu. Wir ben\u00f6tigen zwei Parameter wie folgt:<\/p>\n

Recipients<\/h4>\n

Legt die Empf\u00e4nger*innen der SMS fest.
\nSetzen Sie Name<\/i> zu Recipients<\/b>.
\nStellen Sie sicher, dass bei Read Only<\/i> kein<\/b> H\u00e4kchen gesetzt ist.
\nSetzen Sie Data Type<\/i> zu Alpha Numeric<\/b>.
\nSetzen Sie Display Type<\/i> zu Freetext<\/b>.
\nSetzen Sie Default Source<\/i> zu {{ticket.callerphone}}<\/b>. Dieser Wert stellt sicher, dass standardm\u00e4\u00dfig die Rufnummer vom Ticketkontakt als Zielrufnummer gesetzt wird.<\/p>\n

\"Vivantio:<\/p>\n

Nachrichtentext<\/h4>\n

Setzen Sie Name<\/i> zu Text<\/b>.
\nStellen Sie sicher, dass bei Read Only<\/i> kein<\/b> H\u00e4kchen gesetzt ist.
\nSetzen Sie Data Type<\/i> zu Alpha Numeric<\/b>.
\nSetzen Sie Display Type<\/i> zu Freetext (Multiline)<\/b>.
\nStellen Sie sicher, dass Default Source<\/i> leer ist.<\/p>\n

\"Vivantio:<\/p>\n

Anfragek\u00f6rper<\/h3>\n

Im Tab Request Body<\/i> m\u00fcssen wir festlegen, welche Informationen unsere API-Anfrage enth\u00e4lt.
\nSetzen Sie Request Content Type<\/i> zu application\/json<\/b>.
\nSetzen Sie Body Template<\/i> so, dass es \u00e4hnlich ist wie folgt:<\/p>\n

\r\n{\r\n  \"from\": \"optionaleAbsenderkennungMitMaximal11AlphanumerischenOder16NumerischenZeichen\",\r\n  \"p\": \"sms77ApiSchl\u00fcsselMussHierEingef\u00fcgtWerden\",\r\n  \"text\": \"{{text}}\",\r\n  \"to\": \"{{to}}\"\r\n}\r\n<\/pre>\n
\"Vivantio:<\/p>\n
Webhook speichern<\/h3>\n
Klicken Sie auf Save<\/i> um die Erstellung Ihrer ersten Webhook abzuschlie\u00dfen.<\/p>\n
Rolle(n) ausw\u00e4hlen<\/h3>\n
Lokalisieren Sie den Button Roles<\/i> in der Werkzeugleiste und klicken Sie diesen.
\nNutzen Sie drag & drop um sicherzustellen, dass Current Roles<\/i> nicht leer ist. Nur Benutzer mit diesen Rollen zugewiesen k\u00f6nnen von dieser Webhook Gebrauch machen.
\n\"Vivantio:<\/p>\n
Webhook testen<\/h3>\n
\u00d6ffnen Sie ein Ticket vom Typ Incident<\/i> und dr\u00fccken Sie den Button Actions<\/i> in der Werkzeugleiste. In dem darauffolgendem Dropdown-Men\u00fc dr\u00fccken Sie bitte auf Send SMS via sms77<\/i>.
\n\"Vivantio:<\/p>\n
Es \u00f6ffnet sich jetzt ein Popup-Men\u00fc, wo Sie im Feld Text<\/i> Ihre Nachricht eingeben k\u00f6nnen.
\nIst das Ticket mit einem Kontakt verkn\u00fcpft, welchem eine Rufnummer zugewiesen ist, wird dieser Wert bei Recipients<\/i> hinterlegt. Sie k\u00f6nnen weitere Rufnummern per Komma getrennt hinzuf\u00fcgen.<\/p>\n
Abschlie\u00dfend dr\u00fccken Sie OK<\/i> und Ihre SMS wird versendet!<\/p>\n
\"Vivantio:<\/p>\n","protected":false},"featured_media":0,"parent":17825,"menu_order":62,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-32220","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/docs\/32220","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/comments?post=32220"}],"version-history":[{"count":2,"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/docs\/32220\/revisions"}],"predecessor-version":[{"id":32221,"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/docs\/32220\/revisions\/32221"}],"up":[{"embeddable":true,"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/docs\/17825"}],"next":[{"title":"VirtueMart (Joomla)","link":"https:\/\/www.seven.io\/de\/docs\/drittanbieter\/virtuemart-joomla\/","href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/docs\/22736"}],"prev":[{"title":"Tricoma","link":"https:\/\/www.seven.io\/de\/docs\/drittanbieter\/tricoma\/","href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/docs\/30894"}],"wp:attachment":[{"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/media?parent=32220"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.seven.io\/de\/wp-json\/wp\/v2\/doc_tag?post=32220"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}