on
User Guide for SMS-Magic on Zoho CRM
screen-magic.com
NOV 2016
Contents 1. Prerequisites for using SMS-Magic on Zoho CRM............................................................................3 2. Basic Settings .......................................................................................................................................4 3. Send single/bulk SMS .......................................................................................................................11 4. Receive SMS .......................................................................................................................................13 5. SMS History ........................................................................................................................................14 6. SMS Automation ...............................................................................................................................16 7. SMS/MMS Campaign ........................................................................................................................25
screen-magic.com
Page 1
Introduction The SMS Magic Extension for Zoho CRM enables you to make customer conversations much easier. It offers you the ability to to send and receive SMS messages from Zoho CRM. You can also Automate messages using Webhooks, create SMS Templates with Dynamic fields, Manage Sender ID and view Delivery Reports for your messages. This User Guide will enable you to derive the maximum out of your SMS Magic extension for Zoho CRM. It provides you with detailed steps and screenshots on how to use each individual SMS Magic feature. For information on how to Install and Configure SMS Magic on Zoho. Read our Installation Guide. You can also contact [email protected] for any questions or concerns.
screen-magic.com
Page 2
(1) Prerequisites 1. Installation and Configuration a. You need to have a valid Zoho CRM account on which you have installed SMS-Magic Extension b. You need to have an account with SMS-Magic and have the Zoho CRM configured with this account c. Check our Installation Guide for more details
2. Subscription and SMS Pack a. You need choose one of our Subscription Plan to avail the features provided by SMS-Magic. You can buy the Subscription or go for a trial of 15 days to evaluate our product b. SMS Pack is like a recharge pack for your account. You can purchase the SMS credits using these packs c. Contact [email protected] for details and assistance
3. Incoming Number (Only if you wish to receive messages on Zoho CRM) a. To avail incoming functionality, you first need to procure a dedicated incoming number to receive replies b. All the SMSs received on this number are pushed to your Zoho CRM and will also be recorded in your account at SMS-Magic c. Contact [email protected] for details and assistance
screen-magic.com
Page 3
(2) Basic Settings Once you have met all the Prerequisites, you are all set to Send and Receive Messages to your Leads and Contacts. Although there is much more that you can achieve using SMS-Magic! A. Send SMS Button Installation of SMS-Magic Extension on Zoho enables you to send SMSs to your Leads and Contacts by providing Send SMS buttons on the List View of Leads and Contacts Modules.
Send SMS Button
You can also configure the Send SMS button right on the detail view of the record. To add the Send SMS button to the detail view of a record, follow the steps below: 1. In your Zoho CRM, go to Setup > Customization > Modules and choose the module to which you wish to add the Send SMS Button
Choose Module
screen-magic.com
Page 4
2. Go to tab Links and Buttons. You will see that the Send SMS button is already created for List View Page. Click on Create New Button.
Click on Create New Button
3. Enter the details for creating the button: a. Button Name: Name you would want to have for Send SMS button b. Placement of Button: Choose ‘View Page’ as the location c. Action: Choose ‘Invoke a URL’ as action on click of a button URL for creating button on Leads: https://sms-magic.in/zoho/#/campaignSendSms?recordIds=${Leads.Lead Id}&phoneField=Mobile&objectName=Lead URL for creating button on Contacts: https://sms-magic.in/zoho/#/campaignSendSms?recordIds=${Contacts.Contact Id}&phoneField=Mobile&objectName=Contact Note: This button will pick up the phone number stored in the Mobile field. d. Choose the way you want that URL to open and click on Save
Button name Placement of Button Action URL
screen-magic.com
Page 5
4. You now have the Send SMS button created on the detail view of record.
B. Sender ID Sender ID is the Name or Number which flashes on the recipient's mobile phone when they receive an SMS Text message. SMS-Magic provides you the option to configure the Sender ID for your organization. 1. In Zoho CRM, go to SMS SenderID module from the top menu.
SMS Sender ID
screen-magic.com
Page 6
2. Click on ‘+’ icon to create a new Sender ID.
Create new Sender ID
3. Enter the ‘SMS SenderID Name’ for your reference and the ‘Sender ID’ which you wish to use. Click on Save.
SenderID
screen-magic.com
Page 7
4. Your Sender ID is now ready to be used. You can choose the Sender ID while composing the message for your recipients.
SenderID
Note: There are some restrictions on Sender IDs in different countries. Click here to know more. C. SMS Template With SMS-Magic, you can create templates for SMSs which you send frequently. In the templates, you can use dynamic variables of the object like name, address etc. These variables would be auto populated to their values while sending SMSs. This provides you with a personalized touch when you connect with your Leads and Contacts in Zoho. 1. Log in to https://sms-magic.in and go to Campaigns > SMS Template to create a SMS Template.
Create SMS Template
screen-magic.com
Page 8
2. Click on Create New Template.
Create New Template
3. Enter these details for creating a Template: a. Name of the Template. b. Reference ID for your reference. c. Select the Module for which you wish to create the template. d. Fields drop down will auto fetch the fields of the Module you have selected in the earlier step. Choose the field you wish to insert in the Message. e. Enter the Template text manually and insert dynamic fields as mentioned in step above. f. Keep the Type as Normal and click on Save Template.
screen-magic.com
Page 9
4. You can select this template while composing a message for your recipients.
New Template
screen-magic.com
Page 10
(3) Send single/bulk SMS You can either send a message to a single record of your Leads or Contacts or can select multiple records of Leads or Contacts and send a SMS in one go. Here’s how1. Go to the module (Leads or Contacts) you wish to send SMSs to. 2. Select one or multiple records of that module and click on the Send SMS button.
Send SMS button
3. You will be redirected to the SMS-Magic portal. 4. You can select your desired SenderID, List of Recipients & option to remove them from the list, option to choose any template created for that module, text area to compose message and Info Bytes which shows information on the recipient list and expected SMS credits that will be consumed for sending out the SMSs.
screen-magic.com
Page 11
5. Click on Send now, a pop-up will appear to confirm your action.
Pop-up to confirm
Click on Send Now Once the message is sent, you will be redirected back to Zoho CRM.
screen-magic.com
Page 12
(4) Receive SMS There are two ways to collect responses over incoming numbers: 1. Use the incoming number procured as your SenderID, so that your recipient can simply reply to the incoming message.
Incoming number as a SenderID
2. Mention the incoming number in the SMS that you have sent to your recipient. For e.g.: ”Hi Ted, Please reply back at to confirm your appointment.” 3. Once you receive a message, you can see it in the SMS History Module in Zoho CRM and in the Response Tab in the SMS-Magic portal.
Note: In Zoho CRM’s SMS History Module, incoming messages can be identified by the entry in the ‘Direction’ column. If the entry is IN, this message is an incoming message. The SMS History Name for incoming message will also have IN prefixed before the SMS History Name. screen-magic.com
Page 13
(5) SMS History 1. Both Outgoing and Incoming messages will be recorded in the SMS-Magic Portal and Zoho CRM. 2. You can go to SMS History Module in Zoho CRM to have a look at the messages that you have sent and received. The Direction of the message clearly shows whether that message was Sent out (OUT) or Received (IN).
Lookup for Leads
3. The lookup to the Leads or Contacts will be automatically added in the SMS History module. 4. You can check the delivery status of the outgoing message by viewing its details.
screen-magic.com
Page 14
Outgoing: Log in to www.sms-magic.in and go to Campaigns > SMS History.
Incoming: Log-in to www.sms-magic.in and go to Responses.
screen-magic.com
Page 15
(6) SMS Automation Based on the Workflow rules, you can trigger an SMS using webhooks from your Zoho CRM. This is a 3-step process. Let’s visit them one by one1. Understanding the XML configuration for SMS Automation For your ease, we have already provided the XML configuration that needs to be used while creating a Webhook for SMS Automation. You can access the XML by logging in to www.sms-magic.in and then going to Get Started > Automation tab.
XML to be used in Webhooks for SMS Automation We will break down the XML Script for you. a. This is the library used. You need not make any changes in this part. b. [email protected] This contains your username. You need not make any changes in that, this will be auto populated. c. Sender_Id This is the Sender ID, you can change it to your desired Sender Id by replacing ‘Sender_Id’. Example: I wish to have my Sender ID as AM-SALES so I will change Sender_Id to AM_SALES d. 80007894 This contains your account Id. You need not make any changes in that, this will be auto populated. e. d56cb0190e7710caf18841266xxxxxxx This contains the API key of your SMS-Magic account. You need not make any changes in that, this will be auto populated. screen-magic.com
Page 16
f. Template Text This piece of XML defines the module you wish to send message to, field from which to pick the mobile number, and the message to be sent. g. mobilenumber='${Leads.Mobile}' Defines the Leads field from which the message is to be sent. Currently the Mobile field is set to pick up the phone number. If you wish to pick up the phone number from the Phone field replace. mobilenumber='${Leads.Mobile}' with mobilenumber='${Leads.Phone}' h. recordId='${Leads.Lead Id}' Defines the Lead ID to be picked up, you need not make any changes in that. i. modulename='Lead' Defines the Module for which this SMS Automation would work for, this will be auto populated, you need not make any changes in that. j. Template Text This is the text that will be sent out to your recipients when the workflow having this webhook is triggered. You can change this text to your desired message. You can insert dynamic fields in this text while creating a webhook (explained in a later section). 2. Create Webhooks. This allows you to communicate with third party application by sending an instant web notification every time an event occurs. A. In Zoho CRM, Go to Setup and select ‘Workflow Automation’ under Automation.
Select ‘Workflow Automation’
screen-magic.com
Page 17
B. Go to Webhooks and click on Configure Webhook
Configure Webhook
C. Fill in the details of Webhook: i. Name: ii. URL to notify: Use https://sms-magic.in/smsgateway/post iii. Method: Select POST iv. Description: < Any details you wish to mention> v. Module: