Vivantio is an awarded customer service management software and has built-in functionality to add SMS dispatch with just a few steps of work which I am going to describe in this document.<\/p>\n

Setup<\/h2>\n

At first we need to navigate to Admin -> Integration & API -> Webhooks<\/i>.<\/p>\n

Select a Ticket Type<\/h3>\n

Choose a ticket type from the dropdown. In this document we chose to use Incident<\/i>.<\/p>\n

<\/p>\n

Set Basic Details<\/h3>\n

Set a Name<\/i> to describe the action. This is also the button text which appears on the actions dropdown later on.<\/p>\n

Set Request URL<\/i> to https:\/\/gateway.sms77.io\/api\/sms<\/b>.
\nSet HTTP Method<\/i> to POST<\/b>.
\nSet Authentication Type<\/i> to No Authentication<\/b>.
\nSet Response Content Type<\/i> to application\/json<\/b>.
\nSet Action Description<\/i> to something plausible to describe what happens when using this action.<\/p>\n

<\/p>\n

Parameters<\/h3>\n

In the tab Parameters<\/i> we need to add a few request parameters to define the message recipient(s) and the message text.<\/p>\n

Click on Add<\/i> for adding a new parameter. We need to define two of these:<\/p>\n

Recipients<\/h4>\n

Set Name<\/i> to Recipients<\/b>.
\nMake sure that Read Only<\/i> is unchecked<\/b>.
\nSet Data Type<\/i> to Alpha Numeric<\/b>.
\nSet Display Type<\/i> to Freetext<\/b>.
\nSet Default Source<\/i> to {{ticket.callerphone}}<\/b>. This sets the ticket contact phone as default recipient.<\/p>\n

<\/p>\n

Text<\/h4>\n

Set Name<\/i> to Text<\/b>.
\nMake sure that Read Only<\/i> is unchecked<\/b>.
\nSet Data Type<\/i> to Alpha Numeric<\/b>.
\nSet Display Type<\/i> to Freetext (Multiline)<\/b>.
\nLeave Default Source<\/i> empty.<\/p>\n

<\/p>\n

Request Body<\/h3>\n

In the tab Request Body<\/i> we need to define how the payload of our API request looks like.
\nSet Request Content Type<\/i> to application\/json<\/b>.
\nSet Body Template<\/i> to look similar to this:<\/p>\n

\r\n{\r\n  \"from\": \"optionalSenderIdentifierMaximum11alphanumericOr16NumericCharacters\",\r\n  \"p\": \"sms77ApiKeyNeedsToBeInsertedHere\",\r\n  \"text\": \"{{text}}\",\r\n  \"to\": \"{{to}}\"\r\n}\r\n<\/pre>\n
<\/p>\n
Save Webhook<\/h3>\n
Click on Save<\/i> to finally create your first webhook.<\/p>\n
Select Roles<\/h3>\n
Find the button Roles<\/i> in the toolbar and click on it.
\nUse drag & drop to make sure Current Roles<\/i> is not empty. Only users assigned to this role will be able to make use of our webhook.
\n<\/p>\n
Test Webhook<\/h3>\n
Open a ticket of type Incident<\/i> and press the Actions<\/i> button. Click on the button saying Send SMS via sms77<\/i>.
\n<\/p>\n
The following popup shows up, where you type in your SMS text in the field Text<\/i>.
\nIf the user has a phone number assosciated, it will be set as default value in the field Recipients<\/i>. You may add more recipients separated by comma.<\/p>\n
Finally press OK<\/i> and your SMS will be sent!<\/p>\n
<\/p>\n","protected":false},"featured_media":0,"parent":17826,"menu_order":62,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-32195","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/32195","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/comments?post=32195"}],"version-history":[{"count":3,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/32195\/revisions"}],"predecessor-version":[{"id":32223,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/32195\/revisions\/32223"}],"up":[{"embeddable":true,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/17826"}],"next":[{"title":"VirtueMart (Joomla)","link":"https:\/\/www.seven.io\/en\/docs\/third-party-solutions\/virtuemart-joomla\/","href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/22742"}],"prev":[{"title":"Tricoma","link":"https:\/\/www.seven.io\/en\/docs\/third-party-solutions\/tricoma\/","href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/30905"}],"wp:attachment":[{"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/media?parent=32195"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/doc_tag?post=32195"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}