SMS Notifications

You can set up automated SMS order notifications to be sent to your customers using Clickatell, a third-party mobile messaging gateway provider. With Clickatell integration, SMS messages can be sent when an order has been placed and when an order has been shipped. In order to use Clickatell SMS notifications, you must have a Clickatell account with an SMS API Integration set up and credits purchased from Clickatell.

Prerequisites

• You must have administrator access to use this feature.

To set up a Clickatell API Integration

1. Click here to sign up for an account with Clickatell.
2. Activate your account and log in to the Clickatell portal.
3. In the Products & Services tab, click on SMS under Channels.

   

   Click the image to enlarge.

   

4. Click on the + Activate Channel button.

   

   Click the image to enlarge.

   

5. When the SMS channel has been successfully added, browse to My Workspace.

   

   Click the image to enlarge.

   

6. Click on SMS under Channels.
7. Click on the + New SMS Setup button under My SMS Setups. A setup wizard will take you through the steps to setup your SMS integration.

   

   Click the image to enlarge.

   

8. Select API under the How do you plan to use your new SMS channel section.

   

   Click the image to enlarge.

   

9. Under the Messaging Type section, choose the messaging type.
   • One-way: only allows SMS messages to be sent to customers.
   • Two-way: will allow customers to respond to your SMS notifications.
10. Click Next.
11. Select the number type - choose whether you want to use a long number or short code and indicate whether you are using an existing number or need to purchase a new one.

    If you are purchasing a new number, select the country and choose the number you want to use.

    If you are using an existing number, select it from the drop-down list.

    

    Click the image to enlarge.

    

12. Click Next.
13. Select a payment plan if you have not already done so.
14. Click Next.
15. Set up the payment method if you have not already done so.
16. Select "Basic HTTP API" under API Type and select Create new HTTP API.

    

    Click the image to enlarge.

    

    The HTTP Setup Details page will be displayed.

    

    Click the image to enlarge.

    

17. Enter a name for the API integration, such as "DecoNetwork SMS", in the Setup Name field.
18. Enter a Description for the integration.
19. Choose the delivery type.
    • Time critical: offers the fastest and most direct line of delivery for your SMS messages at premium rates. Recommended for high-priority messages, such as one-time PINs, transactional messages, and time-critical alerts.
    • Standard: uses reliable routes at lower rates. Ideal for messages that aren't time-sensitive, like promotions or CRM messages.
20. Select the Setup Type you would like to start in.
    • Sandbox: allows you to test the API using one of your test phone numbers.
    • Production: choose this option when you are ready to make your integration live.
21. Configure the other options for the API as required, and click Next. Your API details will be displayed. Make a note of the API key. You will need to enter this in the DecoNetwork SMS Notifications set up.

To set up SMS notifications:

1. Log into your DecoNetwork Website.
2. Browse to Admin > Settings > Customer Settings > SMS Notifications.
   

   If this is the first time you have been to the SMS Notifications area, you will launch the Add App screen which will add the required extra functionality into your DecoNetwork system. Click the app to select it and then click Add now to install. Click Close when DecoNetwork has finished re-configuring your site.

3. Tick the Enable Clickatell SMS checkbox.
   
4. Enter your Clickatell SMS Integration information:
   1. Enter the API key from the Clickatell SMS Integration you set up into the API Key field.
   2. (Optional). Enter your Sender IDThe Sender ID is the name or number that appears in the recipient's phone when they receive a message, if you have one set up for your account.
      
5. (Optional). Tick the Order Placed SMS checkbox if you want the customer to receive an SMS to confirm that their order has been placed.
   1. (Optional) Enter a personalized message for the order placed SMS.
      
6. (Optional). Tick the Order Shipped SMS checkbox if you want the customer to receive an SMS to notify them that their order has been shipped.
   1. (Optional) Enter a personalized message for the order shipped SMS.
      

      You can use the following placeholder values in your SMS notification messages to show details of the order:

      • [SITE]: the URL of the website the order comes from
      • [SITE_NAME]: the name of the website the order comes from
      • [ORDER_NUMBER]: the order number
7. Click Save.

   You can test if you have correctly set up the integration by clicking on the Send test sms to... button at the bottom of the page. A test message will be sent to the phone number provided in your DecoNetwork account details.

   Make sure this number is configured in international format.