![\"Vivantio:](\"https:\/\/staging.seven.io\/wp-content\/uploads\/create_webhook.png\")
<\/p>\nVivantio 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
At first we need to navigate to Admin -> Integration & API -> Webhooks<\/i>.<\/p>\nSelect 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 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
![\"Vivantio:](\"https:\/\/staging.seven.io\/wp-content\/uploads\/webhook_basic_details.png\")
<\/p>\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>\nRecipients<\/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
![\"Vivantio:](\"https:\/\/staging.seven.io\/wp-content\/uploads\/parameter_recipients-1.png\")
<\/p>\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
![\"Vivantio:](\"https:\/\/staging.seven.io\/wp-content\/uploads\/parameter_text.png\")
<\/p>\n
In the tab Request Body<\/i> we need to define how the payload of our API request looks like. Click on Save<\/i> to finally create your first webhook.<\/p>\n Find the button Roles<\/i> in the toolbar and click on it. Open a ticket of type Incident<\/i> and press the Actions<\/i> button. Click on the button saying Send SMS via sms77<\/i>. The following popup shows up, where you type in your SMS text in the field Text<\/i>. Finally press OK<\/i> and your SMS will be sent!<\/p>\n
\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![\"Vivantio:](\"https:\/\/staging.seven.io\/wp-content\/uploads\/request_body.png\")
<\/p>\nSave Webhook<\/h3>\n
Select Roles<\/h3>\n
\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![\"Vivantio:](\"https:\/\/staging.seven.io\/wp-content\/uploads\/select_roles.png\")
<\/p>\nTest Webhook<\/h3>\n
\n![\"Vivantio:](\"https:\/\/staging.seven.io\/wp-content\/uploads\/incident_send_sms.png\")
<\/p>\n
\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![\"Vivantio:](\"https:\/\/staging.seven.io\/wp-content\/uploads\/incident_send_sms_compose-1.png\")
<\/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}]}}