{"id":32305,"date":"2021-12-14T10:42:50","date_gmt":"2021-12-14T09:42:50","guid":{"rendered":"https:\/\/www.sms77.io\/docs\/third-party-solutions\/manageengine-servicedesk-plus\/"},"modified":"2021-12-14T11:33:44","modified_gmt":"2021-12-14T10:33:44","slug":"manageengine-servicedesk-plus","status":"publish","type":"docs","link":"https:\/\/www.seven.io\/en\/docs\/third-party-solutions\/manageengine-servicedesk-plus\/","title":{"rendered":"ManageEngine ServiceDesk Plus"},"content":{"rendered":"<p>ServiceDesk Plus from ManageEngine is a versatile helpdesk software specifically for the IT sector. In many cases, it can be beneficial to notify affected parties via SMS instead of mail. In this article we would like to explain how you can integrate sms77 as SMS gateway into ServiceDesk Plus. The necessary interface is already provided, we just need to add an operator. The workload is about five minutes and can be done even by laymen.<\/p>\n<p>We start by logging into the software as a technician.<br \/>\nNow we have to navigate to the administrator settings. To do this, we click on the cogwheel in the upper toolbar, which is typically located in the upper right corner on desktop PCs.<br \/>\nThen we click on the <i>Sms Notification Settings<\/i> menu item, which is assigned to the <i>Service Desk Configuration<\/i> section.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/staging.seven.io\/wp-content\/uploads\/admin_settings.png\" alt=\"ServiceDesk Plus Admin Settings\" width=\"1679\" height=\"1705\" class=\"alignnone size-full wp-image-32295\" srcset=\"https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings.png 1679w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-295x300.png 295w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-1008x1024.png 1008w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-350x355.png 350w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-250x254.png 250w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-600x609.png 600w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-768x780.png 768w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-300x305.png 300w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-400x406.png 400w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-394x400.png 394w, https:\/\/www.seven.io\/wp-content\/uploads\/admin_settings-200x203.png 200w\" sizes=\"(max-width: 1679px) 100vw, 1679px\" \/><\/p>\n<p>Now we start with the configuration of sms77 as SMS gateway.<\/p>\n<p>Select <i>Send SMS through SMS Gateway Provider<\/i>.<\/p>\n<p>Make sure that <b>Custom<\/b> is selected as <i>SMS Provider<\/i>.<\/p>\n<p>For <i>HTTP Method<\/i>, we select <b>POST<\/b>.<\/p>\n<p>For <i>URL<\/i> we set the value <b>https:\/\/gateway.sms77.io\/api\/sms<\/b>. The requests for sending SMS will be sent to this address.<\/p>\n<p>At <i>Request Headers<\/i> we add a key pair with <b>X-Api-Key<\/b> as <i>key<\/i> and your <a href=\"https:\/\/help.sms77.io\/en\/api-key-access\" target=\"_blank\" rel=\"noopener\">API key<\/a> from sms77 as <i>value<\/i>. This value ensures that you are authorized to access the API.<\/p>\n<p>At <i>Authentication details<\/i> we make sure that <b>None<\/b> is selected.<\/p>\n<p>In the <i>Request Payload<\/i> we define the content of our API request.<br \/>\nThe required parameters are <i>text<\/i> for the message content and <i>to<\/i> for the recipient number.<br \/>\nThe value then looks like this:<\/p>\n<pre lang=\"json\">\r\n{\r\n\"text\": \"${{message}}\",\r\n\"to\": \"${{recipients}}\"\r\n}\r\n<\/pre>\n<p>The cryptic-looking values are placeholders, which are replaced with the text and recipient numbers when composing messages. This becomes immediately clear when testing our API request.<br \/>\nIf you want an individual sender ID, you can add the key &#8220;from&#8221; with the appropriate value &#8211; see the screenshot below. This value will then be used as the sender ID of the SMS, depending on the country.<br \/>\nAccording to the <a href=\"https:\/\/staging.seven.io\/en\/docs\/gateway\/http-api\/sms-dispatch\/\" target=\"_blank\" rel=\"noopener\">API documentation<\/a>, further parameters can be added optionally.<\/p>\n<p>In the dropdown menu under <i>Request Payload<\/i> we select <b>application\/json<\/b>. This defines the language of the request.<\/p>\n<p>For <i>Response from provider<\/i> we enter <b>100<\/b>. This value determines which value the API returns when the SMS is sent successfully.<\/p>\n<p>We also make sure that <i>Send SMS messages using Unicode characters for multi language<\/i> is checked.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/staging.seven.io\/wp-content\/uploads\/add_provider.png\" alt=\"ServiceDesk Plus Add SMS Gateway\" width=\"1905\" height=\"1600\" class=\"alignnone size-full wp-image-32300\" srcset=\"https:\/\/www.seven.io\/wp-content\/uploads\/add_provider.png 1905w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-300x252.png 300w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-1024x860.png 1024w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-350x294.png 350w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-250x210.png 250w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-600x504.png 600w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-768x645.png 768w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-400x336.png 400w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-476x400.png 476w, https:\/\/www.seven.io\/wp-content\/uploads\/add_provider-200x168.png 200w\" sizes=\"(max-width: 1905px) 100vw, 1905px\" \/><\/p>\n<p>Finally, it makes sense that we test the configuration. Clicking on <i>Test<\/i> opens a form for the creation of an SMS.<br \/>\nAt <i>To we<\/i> enter a recipient number to which the SMS should be sent.<br \/>\nAt <i>Message<\/i> we define the message text for the test SMS.<br \/>\nTo send the test SMS, we click on <i>Send<\/i>.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/staging.seven.io\/wp-content\/uploads\/send_a_test_sms.png\" alt=\"ServiceDesk Plus Send Test SMS\" width=\"1920\" height=\"2170\" class=\"alignnone size-full wp-image-32302\" srcset=\"https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms.png 1920w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-265x300.png 265w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-906x1024.png 906w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-350x396.png 350w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-250x283.png 250w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-600x678.png 600w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-768x868.png 768w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-300x339.png 300w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-400x452.png 400w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-354x400.png 354w, https:\/\/www.seven.io\/wp-content\/uploads\/send_a_test_sms-200x226.png 200w\" sizes=\"(max-width: 1920px) 100vw, 1920px\" \/><\/p>\n<p>To apply the settings, we click <i>Save to<\/i> submit the completed form to the server.<\/p>\n<p>The setup is now complete and sms77 will be used as SMS gateway in ServiceDesk Plus.<\/p>\n","protected":false},"featured_media":0,"parent":17826,"menu_order":72,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-32305","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/32305","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=32305"}],"version-history":[{"count":4,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/32305\/revisions"}],"predecessor-version":[{"id":32309,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/32305\/revisions\/32309"}],"up":[{"embeddable":true,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/17826"}],"prev":[{"title":"Zoho CRM","link":"https:\/\/www.seven.io\/en\/docs\/third-party-solutions\/zoho-crm\/","href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/docs\/30666"}],"wp:attachment":[{"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/media?parent=32305"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.seven.io\/en\/wp-json\/wp\/v2\/doc_tag?post=32305"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}