Sangoma Send Application User Guide

Content

Overview

Prerequisite

Getting started

Workspaces

Dashboard

Health Indicators

Key Performance Indicators

Create Notification

Notification History

List Actions

Individual Notification Actions

Scheduled Notifications

List Actions

Drafts

List Actions

Individual Notification Actions

Contacts

How to create a new Contact

How to Edit a Contact

How to Delete a Contact

Contact Email Maintenance

Contact Phone Number Maintenance

How to Export Contacts

How to Import Contacts

How to Add Labels to a Contact

How to Remove Labels to a Contact

Labels

Create or Edit a Labels

Delete a label

Add Contacts to a Label

Remove a contact from a Label

Mailing List

Create and Edit a Mailing List

Delete mailing List

Registration URL

Add Contacts by Label to a Mailing List

Add Individual Contacts to a Mailing List

Remove a contact from Mailing List

Ack. Templates

Create and Edit a Ack. Templates

Example Acknowledge/Response form

Delete an Ack. Templates

How to Create a New Notification

How to test a notification

The Sangoma Send application, provides authorized users the ability to send notifications via email or text/SMS to lists of contacts. This can be useful for marketing campaigns, promotions, weather alerts, business notifications, employee alerts, and more.

The Sangoma Send app consists of the following major components:

1. Contacts: Contacts are the individual that notifications are sent to.

1. Mailing lists: A mailing list is a list of contacts that you can send notifications to.

1. Labels: Labels provide a method to group contacts. By adding labels to contacts, a group of contacts with the selected label can be added to a mailing list.

1. Notifications: A notification is the message that will be sent to the contacts.

1. Acknowledgement forms: Acknowledgement forms provide a method for the notification recipient to respond to the notification.

The Sangoma Send app is a seat based application. Each seat is assigned a Text Messaging number. Each Sangoma Send app Administrator is assigned a seat. If you wish to enable an existing PSTN number you already have, please contact your partner or our support team.

1. Customer Purchases the Sangoma Send app seats.

1. Partner provides the Sangoma team with the Sangoma Send app administrator’s portal user id/email.

1. Sangoma team will obtain and assign a SMS number to the purchased seat.

1. Sangoma team will assign a seat to the Sangoma Send app administrator’s Sangoma account.

1. Once the users have been entitled to administer the Sangoma Send app they will receive a welcome email with links to this guide and other helpful information for configuring and sending notifications.

1. To access the Sangoma Send app click Here (https://teamhub-apps.sangoma.com/).

1. Login using your Sangoma Business Voice portal credentials.

1. If you have access to multiple Sangoma packaged applications, select Sangoma Send in the APPLICATIONS left side panel.

The Workspaces panel on the left side of the page, provides a menu of the following functions:

The Dashboard displays statistics for selected notifications.

The health Indicators validates that the selected notification has no known issues.

1. Select a notification and the following is displayed.

Notification KPIs: provides statistics for selected notifications:

1. Select a notification and the following is displayed.

1. Select a time period. (Today, Yesterday, Last 30 days)

Select the Create Notification option to create a notification. For more information reference the How to Create a New Notification section.

The Notification History option provides a list of previously sent notifications, with the following information.

1. Status - Displays the status of the notification with a link to view more detailed status information.

1. Sent on - Displays the Date and time that the notification was sent.

1. Notification name - Displays the configured name of the notification.

1. Sent to - Displays the mailing list that was used in the notification.

1. Response - Provides a link to view the list of recipients and their responses to the notification.

Status	Sent on	Notification name	Sent to	Response
Success	July 7, 2022 5:00 PM	Today’s news update	Staff news updates	View
Success	July 8, 2022 5:00 PM	Today’s news update	Staff news updates	View
Success	July 9, 2022 5:00 PM	Today’s news update	Staff news updates	View

At the top of the list the following action icons are available:

1. Search - Enter information to search for an existing notification.

1. Export - Provides the ability to export the notification as a CSV formatted file.

1. + New Notification - Create a new Notification.

1. Status - Click on the Status for more detailed information regarding the status of a notification.

1. Response - Click in Response to view the list of recipients and their response to the notification.

1. Duplicate - To create a new notification from an existing notification hover over the desired notification and then click the Duplicate Icon.

This workspace displays a list of notifications that are set up to be scheduled to be sent out at a specific date and time.

Notification name	Scheduled to sent on	Next sent on
Staff News Update Template	Every year	Dec 01, 2022, 5:00 PM
Staff News Updates	Every week	Dec 01, 2022, 5:00 PM

At the top of the list the following action icons are available:

1. Search - Enter information to search for an existing notification.

1. Export - Provides the ability to export the notification as a CSV formatted file.

1. + New Notification - Add a new Notification.

Individual Notification Actions

Hover over the desired notification and select one of the following icons.

1. Test - allows you to send a test message to an email or SMS number, which does not have to be a saved contact

1. Duplicate - Creates a new notification from an existing notification.

1. Edit - Provides the ability to edit the existing notification.

1. Delete - Deletes the notification.

This workspace displays a list of notifications, that when created the Sending option was set as Save as draft. If you want to create a Notification template, you can create the notification and then save it as a draft and they will be stored in this space.

Name	Last Modified
Staff news update	Dec 01, 2022, 5:00 PM

At the top of the list the following action icons are available:

1. Search - Enter information to search for an existing notification.

1. Export - Provides the ability to export the notification as a CSV formatted file.

1. + New Notification - Add a new Notification.

Hover over the desired notification and select one of the following icons.

1. Send now -Sends the notification.

1. Test - allows you to send a test message to an email or SMS number, which does not have to be a saved contact.

1. Duplicate - Creates a new notification from an existing notification.

1. Edit - Provides the ability to edit the existing notification.

1. Delete - Deletes the notification.

The Contacts option within the workspaces is where the contacts are managed. A list of existing contacts along with their email or phone number is displayed. When you hover over an item in the list 4 actions icons are displayed. Add Labels, Remove Labels, Edit Contact, and Delete Contact.

Firstname	Lastname	Email Addresses / Phone Numbers
Joe	Jones	joejones@somewhere.com
Joe	Jones	8005551234
Sue	Jones	suejones@somewhere.com

1. To Create a new contact, click the    + New Contacts    button above the list of contacts.

1. Enter the contact’s First and Last Name.

1. To add or edit a contact’s email address see the Contact Email Maintenance section below.

1. To add or edit a contact’s phone number see the Contact Phone Number Maintenance section below.

1. Click the    Submit    button to submit all changes.

1. To edit a contact, hover over the desired contact and click the Edit Icon.

1. Edit the First and Last Name.

1. To add or edit a contact’s email address see the Contact Email Maintenance section below.

1. To add or edit a contact’s phone number see the Contact Phone Number Maintenance section below.

1. Click the    Submit    button to submit/save all changes.

1. To delete a contact, hover over the desired contact and click the Trash Can Icon.

1. When prompted click the    DELETE    button or the      Cancel    button to cancel out of the changes.

While in Add or Edit Contact mode, follow the steps below.

1. Add an Email
   1. Click the    + Add Email    button.
   1. Select a Label from the Dropdown.
   1. Enter the Contacts Email address.
   1. Click the    Save    button to save the entry or the    Cancel    button to cancel out of the changes.

Note: You must click the    Submit    button to submit/save all changes.

1. Edit an Email
   1. Click the Edit Icon to the right of the desired email.
   1. Select a Label from the Dropdown.
   1. Enter the Contacts Email address.
   1. Click the    Save    button to save the entry or the    Cancel    button to cancel out of the changes.

Note: You must click the    Submit    button to submit all changes.

1. Delete an Email
   1. Click the Trash Can Icon to the right of the desired email.

While in Add or Edit Contact mode, follow the steps below.

1. Add a Phone Number
   1. Click the    + Add Phone Number    button.
   1. Select a Label from the Dropdown.
   1. Enter the Contacts Phone Number.
   1. Click the    Save    button to save the entry or the    Cancel    button to cancel out of the changes.

Note: You must click the    Submit    button to submit/save all changes.

1. Edit a Phone Number
   1. Click the Edit Icon to the right of the desired phone number.
   1. Select a Label from the Dropdown.
   1. Enter the Contacts Phone Number
   1. Click the      Save      button to save the entry or the      Cancel    button to cancel out of the changes.

Note: You must click the    Submit    button to submit/save all changes.

1. Delete a Phone Number
   1. Click the Trash Can Icon to the right of the desired phone number.

Note: You must click the   Submit   button to submit/save all changes.

1. Click the Contacts option in the WorkSpaces panel on the left side of the page..

1. Click the Export Icon at the top of the page.

1. A CSV file will be created in the device's default location with all Contacts included.

The Sangoma Send app provides the ability to import a list of contacts using a CSV formatted file.

1. Step 1 - Create a template CSV file:
   1. At the top of the Contact list, click the Import button.
   1. In the Pop-up window that is displayed, Click the Download Sample button.
   1. A CSV file will be created in the device's default location.

1. Step 2 - Add contacts to the new CSV file.
   1. Open the downloaded export file using a spreadsheet app like Excel.
   1. Do not add any entries in the first column “uuid”
   1. Add the following contact information:
      1. Firstname - Enter the contact’s first name.
      1. Lastname - Enter the contact’s last name.
      1. Labels - Enter an existing or new label (example: Monthly Newsletter). Note: If the Label is a new label, and the contact already exists the row will be rejected.
      1. Email - (optional) Enter the contact’s email address.
      1. Emailtype - Enter one of the following valid emailtypes (No Label, Home, Work, Other).
      1. Phonenumber - (optional) Enter the contact’s SMS/phone number. Note: The number should be just the number, no special characters.
      1. Phonenumbertype - Enter one of the following valid phonenumbertype (No Label, Mobile, Work, Home, Main, Other).
      1. Additional emails and phone numbers can be added in the subsequent columns.
      1. Save the changes.

1. Step 3 - Import the contacts via the new CSV file.
   1. Click the Contacts option in the WorkSpaces panel on the left side of the page.
   1. Click the Import Icon at the top of the page.
   1. Click the Browse button.
   1. Select a previously created CSV file.
   1. If the first row has column headers, click the “First row has headers” checkbox.
   1. Click the    IMPORT    button.
   1. A popup window will appear and display how many rows were processed, rejected and imported. Normally there will be at least 1 row rejected, which is the first row of column headers.

Note: A Contact can have multiple labels.

1. To Add Labels to a contact hover over the desired contact and click the Add Labels Icon.

1. The contact - Add Label page is displayed.

1. Click the    + Add Label    button.

1. Select an existing Label.

1. Click the    Save    button or the       Cancel       button to cancel out of the changes.

1. Repeat the above 3 steps to add additional labels.

1. After all Labels have been added to the Contact click the    Submit    button to submit all changes to the system, or the       Cancel       button to cancel out of the changes.

1. Hover over the desired contact and click the Remove Labels Icon.

1. Hover over the desired Label and click the Trash Can icon.

1. Click the    DELETE    button to complete the deletion, or the      Cancel    button to back out of the delete function.

Labels provide a method to group contacts. An example might be to add a location id to all employees at a location, or a campaign name to all affected customers. Labels make it easier to create mailing lists, as you can add all contacts with a specified label to a mailing list. Once a label is created you can add contacts to the label or you can add the label to a contact. A Contact can have multiple labels.

Click the Labels option in the WorkSpaces panel on the left side of the page.

1. To Add a new Label, click the    + New Label    button.

1. To Edit an existing Label, hover over the desired Label and click the Edit Icon on the right side of the Label.

1. Enter the Label Name.

1. Enter a Description.

1. Click the    Submit    button.

1. Hover over the desired Label and then click on the Trash Can Icon on the right side of the Label.

1. Click the    DELETE    button to complete the deletion, or the      Cancel    button to back out of the delete function.

1. Hover over the desired Label and then click on the Add Contacts Icon on the right side of the Label.

1. Click the    + Add Contact    button.

1. Search and select a contact from the dropdown.

1. Click the    Save    button to save the entry or the    Cancel    button to cancel out of the changes.

1. When you have completed adding all the desired contacts, click the   Submit    button at the bottom of the window to submit all changes, or the    Cancel    button to cancel out of all entries.

1. Hover over the desired Label and click the Remove Contact Icon on the right side of the Label.

1. From the list of displayed contacts, hover over the desired Contact and click the Trash Can Icon on the right side of the Contact.

1. Click the    DELETE    button to complete the deletion, or the      Cancel    button to back out of the delete function.

A Mailing List is a group of contacts that can be assigned to notifications. The contacts in the list will be sent the notification when it is submitted. When creating a notification, it is required to select one or more Mailing Lists.

To Access the Mailing List, click the Mailing Lists option in the WorkSpaces panel on the left side of the page.

1. To Create a new Mailing List, click the    + New List    button.

1. To Edit an existing Mailing List, hover over the desired Mailing List and click the Edit Icon on the right side of the Mailing List.

1. Name - Enter a Name for the mailing list.

1. Description - Enter a description for the mailing list.

1. SMS Number - Enter the SMS number that Sangoma provides with your license.

1. Allow Subscribe/Unsubscribe - Click the checkbox, to allow recipients of the notification to Subscribe or Unsubscribe to future notifications. By default, all Mailing Lists will be set to Unsubscribe/Subsubscribe. When selected:
   1. A URL will be created that will be automatically added to each SMS and Email to comply with regulations that stipulate that recipients can unsubscribe from mailings.
   1. This URL can also be copied and added to a website or other information to allow a person to register for the mailings.
   1. YOU MUST use this feature on your first messages to new external audiences. This will allow a person to subscribe or unsubscribe to these types of notifications.
   1. You can uncheck this feature on the outbound message if you wish but best practice will be to include it on all messages, and at minimum on the first message to all new contacts.
      1. For more information on the requirements and best practices for email and SMS marketing, we recommend consulting with third party legal guidance as needed to remain in compliance with all applicable regulations: https://www.ctia.org/the-wireless-industry/industry-commitments/messaging-interoperability-sms-mms and https://www.campaignmonitor.com/resources/guides/understanding-emails-laws-regulations/

1. Click the    Submit    button

1. Hover over the desired Mailing List and then click on the Delete Icon on the right side of the Mailing List.

1. Click the    DELETE    button to complete the deletion, or the      Cancel    button to back out of the delete function.

1. To review the pop-up that the customer will see if they open a Self Registration URL, click the “Click to Review” link.

1. Click the Copy Icon to copy the Self Registristration URL.

This feature allows adding all contacts to a mailing list that have the selected label.

1. Hover over the desired Mailing List and then click on the Add by Label Icon on the right side of the Mailing List.

1. Click the    + New Label    button.

1. Select a Label from the dropdown.

1. Click the    Save    button to save the entry or the    Cancel    button to cancel out of the changes.
   1. Once the entry has been saved, prior to submitting the changes you have the option to edit or delete the entry via the edit or Delete Icons.

1. When you have completed adding all the desired Labels, click the    Submit    button at the bottom of the window to save all saved entries, or the    Cancel    button to cancel out of all entries.

1. Hover over the desired Mailing List and then click on the Manage List Icon on the right side of the Mailing List.

1. Click the    + Contact    button.

1. Click the    + Add Contact    button.

1. Search and select a contact from the dropdown.

1. Click the    Save    button to save the entry or the    Cancel    button to cancel out of the changes.

1. When you have completed adding all the desired contacts, click the    Submit    button at the bottom of the window to save all saved entries, or the    Cancel    button to cancel out of all entries.

1. Hover over the desired Mailing List and then click on the Manage List Icon on the right side of the Label.

1. Hover over the desired Contact and then click on the Trash Can Icon on the right side of the Contact.

1. Click the    DELETE    button to complete the deletion, or the      Cancel    button to back out of the delete function.

Acknowledgement Templates are used to allow the recipient of a notification to acknowledge/respond to a notification.

To Access the Ack. Templates, click the Ack. templates option in the WorkSpaces panel on the left side of the page.

1. To create a new Ack. Template click the    + New Template    button.

1. To edit an existing template, hover over the desired template and click the Edit Icon.

1. Message
   1. Name this template: Enter a name for the acknowledgement template.
   1. Message Title: Enter a title/header for the Acknowledge/response form.
   1. Message body: Enter the message to be presented after the title. If a response from the contact is expected, this message might include a question to guide the contact with how to respond to the notification.
   1. Response Options: Create up to 5 response buttons that the contact will be provided to respond to a notification.
      1. To add a response button, click the    + Add button    button.
      1. Button Label: Enter the text to help the contact know which response to provide.
      1. Redirect to: This option allows you to redirect the contact to a different web page when the button is clicked.

1. Footer
   1. URL or Phone number link: This option allows you to redirect the contact to a different web page or Send a text message.
   1. Text to display: Optionally you can display a message at the bottom of the Response form. If a URL was provided this is the text that will be displayed in the URL.

1. Hover over the desired template and click the Trash can Icon.

1. Click the    DELETE    button to complete the deletion, or the      Cancel    button to back out of the delete function.

Select the Create Notification option in the WorkSpaces panel on the left side of the page.

Optionally you can create a new or copy and existing notification while viewing Notification history, Scheduled notifications, or Draft notifications.

To create a new Notification click the    + New notification    button at the top of the page. After the form is displayed enter the following:

1. Name this notification - Enter a name for the notification.

1. Assign mailing list - Select a previously created mailing list. This will associate the SMS number that is saved to the mailing list with your notification.

1. By default it will include the unsubscribe link. You may uncheck that option if you are sure that all your users have double opted in to receive your messages and you have presented the opt-out link in an earlier message.

1. Sending options:
   1. Send now - Send the notification now.
   1. Send later - When this option is selected you will be prompted to enter a Date and a Time to send the notification.
   1. Schedule recurring - When this option is selected you will be prompted for the following:
      1. Interval - Enter the number of times you want to send this notification.
      1. Frequency - Select how often the notification should be sent: (Yearly, Monthly, Weekly, or Daily)
      1. Start on - Enter the Date and Time the notifications should start being sent.
      1. All recurring messages should include the opt-out/unsubscribe link.
   1. Save as draft - Select this option if you want to:
      1. Test the notification - See the How to test a notification section for additional information.
      1. Complete the notification at a later time.
      1. Save as a template.

1. UNSUBSCRIBE / RESPONSES
   1. Send Unsubscribe Link
      1. Select this option if you want to provide a link that allows the contact to unsubscribe to future notifications.
   1. Request acknowledgement
      1. Select this option if you want the contact to respond to the notification.
      1. Select a previously created Acknowledgement template from the dropdown.

1. Variables:
   1. You can copy and paste these variables into your Email and SMS messages to make them more personal.
   1. Available Variables:
      1. firstname
      1. Lastname

1. SMS: This is the body of the SMS message that will be sent to recipients. This message will only be sent to recipients for which you have added a valid phone number in the mailing list.

1. Email: This is the subject and body of the email message that will be sent to recipients. This message will only be sent to recipients for which you have added a valid email address in the mailing list.

1. Scroll back to the top of the form and click the      Create      button or      Save and schedule      depending on your selected send option..

1. Create a new notification and save it as a draft or as a scheduled notification.

1. Select the Draft or Scheduled notifications option in the Workspaces panel on the left side of the page.

1. Hover over the desired notification and click the Test Icon.

1. Enter an Email or Phone number to send the test notification to.

1. Click the    Send    button.