Nexmo

To integrate Nexmo with Zendesk in order to send outbound SMS via triggers and automations, we will be using the extension URL Target.

1. Login to Zendesk
   
2. Click Settings -> Extensions
   
3. Click Targets tab -> click add target
   
4. After clicking add target, please click on URL target
   
5. You will then have to fill the required values for:
   
   • Title → Name your target as desired
     
   • URL → https://rest.nexmo.com/sms/json?username=NEXMO_API_KEY&password=NEXMO_API_SECRET&from=YOUR_BRAND&to={{ ticket.requester.phone}} if you want to send SMS to the ticket requester.
     You may choose to use other placeholders with the to parameter instead of {{ticket.requester.phone}}.
     
   • Method → use POST
   • Attribute Name → text
   • Basic Authentication → leave blank as your credentials are set in the URL field
     
6. To check if all the details are correct, click on Test Target → Submit. You should get a success response if the details are correct (i.e. Nexmo API Key and API Secret). Once you have successfully tested it you can go ahead and create the target.
7. To configure Zendesk to send your SMS notifications using a trigger, click Triggers under Business Rules: Click Add Trigger and configure the trigger.
8. Populate the Conditions fields that you want to be true for the Trigger and set up the action to be performed. In this case, the action will be 'Notifications: Notify target' and you will select the previously created Target. You can populate the message field with the text that you want to be sent, using Zendesk placeholders as desired.
9. Note that if have used the {{ticket.requester.phone}} placeholder in your target, you must ensure that the phone number field is correctly populated in the Zendesk user profile (using the international format, ie. +1, +44).
10. You can now send an SMS from Zendesk using the Nexmo SMS API!
11. The recipient configured in your target (eg. the ticket requester) will receive an SMS via the Nexmo SMS API.