1

Incoming SMS Alerts are Sent to Incorrect Recipient

Issue Scenario

The incoming SMS alerts are sent to unintended recipient.


Possible Causes

The following are the possible causes for the issue:

•Data indexing issue – There are more than 200,000 records on which the query runs. Therefore the incoming SMS is assigned to the OAuth user.

•Notification settings are not configured correctly.

•The Previous message lookup did not happen.

•Incoming SMS was received from an unknown number.

•User does not have permissions for updating the Previous Lookup or the related SMS History


Solution

Do the following to resolve the issue:

•Index all mobile fields. Refer to the document in the link provided below for more details on Field Indexing.
https://docs.google.com/document/d/1PsBNr8PQuKD_abbRwggCZTtfGQqedAdAU74tzqlZ10k/edit?usp=sharing

•Configure all notifications correctly. For more details, refer the section on Configure Incoming Notifications under Sender ID and Assignment in the SMS-Magic Converse Guide for Salesforce Admin:
https://www.sms-magic.com/technical-resource-center/sms-magic-guide-for-salesforce-admin/




Unable to Send Messages Using Conversation View/Converse Desk/ECD

Issue Scenario

A user tries to send messages using Conversation View/Converse desk/ECD is unable to do so.


Possible Causes

The following reasons may have caused the issue:

•The user is not assigned an SMS-Magic License.

•The user does not have permissions for SMS-Magic object granted either for permission sets or at the profile level

•The user does not have read access to the name field, mobile field or SMS Opt Out/SMS Opt In field referenced in the MOC.

•SMS Credits are exhausted

•Mobile field used in MOC is empty

•SMS History record is created but SMS is not delivered (due to issue on providers end)

•A custom automation rule is causing an error with SMS History record creation.


Solution

Make sure that the user has a license assigned to him/her as well as he/she has appropriate permissions assigned.

Click the following link to review the minimum access level –
https://www.sms-magic.com/technical-resource-center/sms-magic-guide-for-salesforce-admin/sms-magic-converse-guide-for-salesforce-admin/

Follow the procedure given below to resolve the issue caused owing to any custom automation rule:

1.Ensure that all process builder/workflow/flow/triggers on the SMS History object in the Customer’s Org is configured correctly. Incorrect values definitions may result in the SMS History record not being created properly.  

2.Review the configurations and modify them if required.

3.Reach out to the Dev team if the issues persists even after reviewing and consulting with the CS team.




Select your Destination Country

When you configure SMS-Magic Converse, you can choose your destination country of operation where you would want to send messages. You can choose the All option to send messages in more than one country. Messages will follow the compliance guidelines and Sender ID restrictions based on the country of coverage. 

To select your Primary Country of Operation where you would want to send messages:

1. In the Coverage section, select the country from the Primary Country list.

2. Click Yes in the Confirm Selection pop-up window.

3. Click Go to Next Step.




Messaging Compliance

SMS or messaging compliance is a highly regulated industry. The applicable laws depend on the place of business, destination country of your recipients and the specific industry you are in. Telecom laws apply uniformly to any SMS sent in that particular country.

Businesses are required to obtain specific consent before messaging their prospects and customers. Each regulation such as Telephone Consumer Protection Act (TCPA), General Data Protection Rights (GDPR), Canada’s Anti-Spam Legislation (CASL), or California Consumer Privacy Act (CCPA), California or the new California law, makes it mandatory for each business to obtain specific consent. SMS Magic has created an extensive framework which serves as a guideline for you to define:

  • Who are you messaging?
  • What you are messaging and obtain specific consent for that content?
  • How you are obtaining Consent?

There are several considerations in choosing your consent options. We advise you to consult your attorneys before deciding on the messaging consent.

This image has an empty alt attribute; its file name is rsd.jpg


Choose a Consent Database

The applicable laws like TCPA and GDPR make it mandatory to obtain consent and keep records in a readily available audit database which can be used as evidence in case of a dispute. This database of Consent records needs to be maintained for 4 years (as per GDPR) from the date of its creation. 

With SMS Magic you can choose how you obtain and maintain or record your consent. You can choose to get a blanket consent for sending any legally possible Content or get a specific Consent. For example, you can get blanket consent for sending any type of messages, service, transactional, or promotional; Or you can get specific consent for sending transactional messages only.

This specific consent is recorded via Sender ID and Content Type. You can choose any of the following methods:

  • Mobile Number Only – You Opt-in to have a blanket yes or no consent for any recipient
  • Mobile Number and Sender ID – You record consent for specific Sender ID’s. You always have the option to choose “All”, while creating your consent records.
  • Mobile, Sender ID, and Content Type – You choose to do specific consent based on Content Type.

We recommend using the Mobile number and Content Type to be specific. If you are obtaining blanket consent, then choose “All”.

The compliance feature helps you create a consent database based on all these parameters. You can also enable users to create a consent record manually. However, users need to be provided with relevant permissions to create and update the consent database. 

You can define consent record parameters in the following four possible combinations:

Parameter  Description
Mobile Number  When you enable mobile number as a record parameter, all consent will be accepted only when responses are received through the default mobile number the customer provides. This is a mandatory parameter and will have to be included in every combination.
Mobile Number and Sender ID When you enable this parameter, consent records will be registered when responses are received from the registered mobile number and by the defined sender ID of the customer.
Mobile Number, Content Type, and Sender ID When you enable this parameter, consent records will be registered against responses received from the defined phone number of the customer, for a specified Content-Type sent to the customer, and by the Sender ID of the user.









Methods Of Input

Consent is captured through text messaging, paper forms, emails or web forms. All these varied methods of input can be categorized under three areas. These are as follows:

Mobile – You can print the mobile numbers on billboards, posters or print ads in order to encourage customers to share their consent for receiving updates on your products and services. When customers send in their consent through these numbers, the input source is recorded as Mobile. 

Online – All Web forms or partner sources sending in new lead information are considered as valid sources for collecting consent. However, it is recommended that you provide explicit instructions to customers to perform a specific action (like selecting a checkbox or clicking a Submit button) in order to submit their consent. Once submitted the database can record the input source as Online.

Offline – All physical forms like contracts or other paper forms can also be used to collect consent requests. Even for physical forms, you need to mention the specific action the customer needs to perform in order to send in their request. All requests collected through paper forms need to be added in the consent database with its input source as Offline.

Consent once captured in the consent database needs to mention the input source that has been used to collect it. Create a Comments field in the Consent object that will capture information on the input source for collecting the consent.
Similarly, the lead or Contact object record also needs to be updated with a custom field that will comprise details on how the record is being created. This is a recommended practice for maintaining the audit details.

The Methods of Input section will also appear only the first time you are configuring the compliance details.

To Configure the Audit Database:

1. In Consent Record Setting, select the relevant parameters to define consent records.

2. In Keep Audit Report as Object, click View Sample Database. A popup window appears displaying a sample database.

3. Enable the Allow users to manually Add/Edit Consent Records option if you want to allow Agents to add consent records manually. 

In addition to enabling this feature, you have to provide users with the custom permission AllowToAddManualConsent to help them create and update consent record database.

4. Click Next.

The Add Manual Consent Record button in the Consent Record will remain disabled if you do not enable the Allow users to manually Add/Edit Consent Records option. The Consent Record database will be created only after you complete the compliance settings. To send a message successfully, the combination of Mobile Number, Sender ID, and Content Type has to match (or the combination configured here has to match).

Configure Consent Method and Content

You can initiate and respond to messages from multiple messaging sources. As each message has a specific purpose, the need to ensure that consent is received for those messages prior to sending them, is therefore critical.

For example, while sending automated messages or sending messages to multiple recipients, it is mandatory that you receive an opt-in request prior to sending. This helps to ensure that your marketing efforts generate positive results.

While sending one-to-one messages, you will not be able to send messages to customers who have explicitly opted-out of your communication strategies.

SMS-Magic Converse helps you configure the consent method that is needed to send out messages through different interfaces. This is a recommended best practice that all users should follow.

The interfaces that you can configure with these consent methods can be categorized based on the type of messages that they are used for sending. The consent method can be selected from the drop-down list placed below each category name. These are as follows:

Automated Conversations – All sources like Converse Apps and Process builders that help you send automated messages.

Bulk Conversations – All sources like Record list view, Campaign Managers, reports and Salesforce Campaigns that help you send bulk messages.

Interactive Conversations –  All sources like the Send Message window in Converse Desk, Converse Inbox and Record View that help you send one-to-one messages to a single customer.

There are two options for defining what you obtaining consent for:

Source Type – You can define if the source requires a prior consent or not. For example,  you might not require consent for sending an Emergency message. Another scenario is that you might not be required to use SMS Magic Compliance Center because you have built your own compliance center. So you can choose, “Consent Not required”.

Content Type – Content type opt-ins are useful in ensuring that you can continue sending messages to customers for a specific content-type. Therefore, in case the customer is applying for a blanket opt-out instruction, in the opt-out confirmation message they receive, you specify the content type opt-in they can send if they wish to continue receiving messages for that specific content type.  


To Create Consent for Source:

1. In Consent for Source, click the drop-down list beneath the relevant message interface name to select the consent mode. Refer to the following table for details.

Field Description
Consent Required If you select this mode, you can send messages to only those customers who have provided explicit Opt-In instructions. This can be used for receiving mobile-initiated consent, consent received through online (web forms) or offline (Physical forms) sources.
Consent Not Required If you select this mode, you can send messages to all customers except those who have specifically provided Opt-Out instructions. This can only be used in countries where compliance guidelines dictate that you can continue sending messages to customers until you receive an opt-out instruction. It is not necessary to receive an opt-in request prior to sending out messages to these businesses.
Consent Not Applicable If you select this mode, you can send messages to all customers without checking for any consent details. This can be used by businesses sending out emergency messages or those who use their own internal compliance guidelines. In all such scenarios, the existing consent status is ignored and the message is sent.

Click View Source next to the conversation interface type to view the various interfaces (for example, Campaign Manager, Converse Desk, Bulk SMS) that help you send the relevant conversations.

To Create Consent for Specific Content:

1. In the Consent For Specific Content section, click Create New.

2. Enter the customer details to create a new content type. Refer to the following table for more details on individual fields.

3. Click Next. The Configure section appears to help you add the Sender ID and keyword configurations for the new content type.

4. Enter the keyword configurations for the new content type. Refer to the following table for more details on individual fields.

Ensure that you do not use the same keywords used in the default Keyword configuration section.

5. Click Validate & Next. The Opt-out Instructions section appears.

6. Enter the following details to add an opt-out instruction to your message. Refer to Table for more details.

This is optional and you may skip appending any opt-out instructions.

7. Click Save. The new message type appears on the Content Type table.

Field Description
Define
Content Type Name Type the content type name. It must follow the given guidelines: It must be a maximum of 40 alphanumeric characters including underscores (_). It must start with a letter. It should not include spaces. It must not end with an underscore or contain two consecutive underscore characters. 
Consent Mode In the drop-down list select the relevant consent mode for the new content type. 
Applicable Sources Select the conversation source for which the content type will be available. The options provided are:
Automated Conversation
Bulk Conversation
Interactive Conversation
Configure
Confirmation Message Sender ID In the drop-down list, select the Sender ID that will be associated with this Content Type. You can send messages using this content type if you select this defined Sender ID. 
Opt-In keyword Type the specific Opt-in Keywords that you want to associate with this content type.
Once configured it will override the manual message keywords created under the Compliance section Basic Settings.
Opt-In Confirmation Message Type the message that will be sent to customers in response to the Opt-in request. 
Opt-out Keyword Type the specific Opt-out Keywords that you want to associate with this content type.
Once configured it will override the manual message keywords created under the Compliance section Basic Settings
Opt-Out Confirmation Message Type the message that will be sent to customers on receiving the Opt-out request.
Opt-Out Instructions (Optional)
Auto append opt out Instruction in every message Select the option if you want to add an opt-out instruction to every message that is sent out.
In an Interval
Do not Auto-append opt out instructions in every message Select the option if you do not want to add an opt-out instruction to every message that is sent out.
Opt-out Message Type the message you want to append as an opt-out instruction

To Edit a Content Type:

  1.  On the content type page, select next to the content type you want to edit. A drop-down menu appears.

2. Click Edit. The Edit Content Type popup window appears.

3. Modify the fields as per requirements. Refer to the following table for more details.

Field Description
Define 
Content Type Name Displays the content type name. You cannot modify the content type name. 
Consent Mode In the drop-down list select the relevant consent mode for the new content type. 
Applicable Sources Select the conversation source for which the content type will be available. The options provided are:
Automated Conversation
Bulk Conversation
Interactive Conversation
Configure
Sender ID In the drop-down list, select the Sender ID that will be associated with this Content Type. You can send messages using this content type if you select this defined Sender ID. 
Opt-In keyword Type the specific Opt-in Keywords that you want to associate with this content type.
Once configured it will override the manual message keywords created under the Compliance section Basic Settings.
Opt-In Confirmation Message Type the message that will be sent to customers on receiving the Opt-in request. 
Opt-out Keyword Type the specific Opt-out Keywords that you want to associate with this content type.
Once configured it will override the manual message keywords created under the Compliance section Basic Settings
Opt-Out Confirmation Message Type the message that will be sent to customers on receiving the Opt-out request.
Opt-Out Instructions
Auto append opt out Instruction in every message Select the checkbox if you want to add an opt-out instruction to every message that is sent out 
In an Interval
Do not Auto-append opt out instructions in every message Select the option if you do not want to add an opt-out instruction to every message that is sent out.
Opt-out Message Type the message you want to append as an opt-out instruction

4. Click Save.


To Delete a Content Type:

You can delete a content type only when it is not associated with a consent record.

1. On the Content Type page, select next to the content type you want to delete. A drop-down menu appears. 

2. Click Delete. The Delete Confirmation pop-up window appears.

3. Click Confirm. The Content Type Configuration is deleted.


Configure Double Opt-in

Many times businesses obtain consent to send messages via Web forms, emails or offline methods like contracts. Many industry bodies and associations like the TCPA recommend confirming the Opt-in via handset by sending an explicit SMS asking to confirm or at least notify the recipient that they are subscribed to the text message service from your business. 

The consent status of the recipients is set to pending until they use this keyword to confirm the request. On receiving the keyword from the prospect, you send a response confirming the consent. This completes the compliance process. 

The consent collection process can be automated. You can set up a process builder so that whenever a new lead is created you will be able to create a new record in the consent database.

This section helps you create the configuration for double opt-in or confirmation messages for opt-ins via manual or online forms. All consent will be captured based on these configurations.


To Create a Double Opt-in Configuration:

1. In Double Opt-in & Others, click Create Configuration. The Create New Configuration screen appears.

2. Enter the details as required. Refer to the following table for more details.

3. Click Validate and Save. The Double-Opt In screen appears.

  • Click the Down icon next to the double opt-in record you want to view and click View Details from the dropdown list.
  • Click the Down icon next to the double opt-in record you want to remove and click Delete.
FIELD DESCRIPTION
Source Select the non-handset source from which you want to create consent records. The current version provides Manual as the only available source.
Confirmation Message Sender ID Select the Sender ID from which the confirmation message will be sent.
OPT-IN
Send Confirmation Message Select the option to send a confirmation message.
Double Opt-in Select the option to enable the customer to send a double opt-in.
Opt-in Confirmation Message Type the confirmation message that will be sent out for an Opt-in request.
Double Opt-In Message Type the message that will be sent out to request for a Double Opt-in. This field appears only if you select the Double Opt-in option.
Double Opt-in Keyword Type the keyword that will be used for sending double Opt-in requests.This field appears only if you select the Double Opt-in option.
Double Opt-in Confirm Message Type the message that will be sent out to confirm a Double Opt-in request. This field appears only if you select the Double Opt-in option.
OPT-OUT
Opt-out Confirmation Message Type the message that will be sent out to confirm an Opt-out request. This field will appear if you do not select the Double Opt-in option.

Configure Keywords

To comply with industry standards, you must respond to keywords for HELP & STOP. Any user who opts-out using the STOP keyword must be added to an opt-out list (blacklist) and must not be sent any further messages until or unless they opt back in. You can configure mandatory keywords for the three keyword types provided. These are:

  • Opt-out
  • Opt-in
  • Help

For each keyword type, some default keywords have already been pre-defined. You can also create new ones following industry-specific norms.

Create keywords using the following guidelines:

  • Use Alphabets
  • Do not add spaces
  • Do not include special characters

When a customer uses the keywords defined under the Opt-out keyword type, they will be opted out or blocked from receiving messages for all campaigns and other activities. You cannot send any more messages to all such customers.

Similarly, when a customer uses the keywords defined under Opt-in keyword type, they choose to opt-in for receiving messages from any team within the organization.

You can define separate keywords to help customers opt-in for specific content type messages, for example, notification or promotions. These keywords will be considered for receiving consent for that specific content-type.

Content-Type opt-ins are useful in ensuring that you can continue sending messages to customers for a specific content-type. Therefore, in case the customer is applying for a blanket opt-out instruction, in the opt-out confirmation message they receive, you specify the content-type opt-in they can send if they wish to continue receiving messages for that specific content-type.


To Configure Compliance Keywords: 

1. Click Edit next to the Keyword type you want to modify. The Edit Keyword Configuration pop-up window appears. Refer to the table below for more details on the Keyword options.

You cannot edit the default keywords.
FIELD DESCRIPTION
Opt-In Keywords Displays the opt-in keywords that will be used at the organization-wide level. You can define Opt-in keywords that are specific to a content type.
Opt-Out Keywords Displays the opt-out keywords that will be used at the organization-wide level. This will opt-out users from all the campaigns/content types.No further messages can be sent to customers from any teams in the organization.
Help Keywords Displays the help keywords that will be used at the organization-wide level. This will redirect customers to request for support based on the keyword you provide.

2. Enter the following details to add keyword configuration.

FIELD DESCRIPTION
Type Displays the keyword type that you have selected to edit. For example, Opt-out, Opt-in, Help.
Keywords Type the new keywords that you want to configure for the keyword type.You can type multiple keywords for a single keyword type.The new keywords should not be the same as the default keywords.
Message Type the message that will be sent to customers who have sent the consent details.
Do you wish to enable this setting? In the drop-down, select to indicate whether you want to enable the keyword type.If you disable the keyword type configuration, then customer consent sent for the keyword type will be ignored. For example, Customers who wish to Opt-out using the defined keywords will continue to receive messages if opt-out Keyword type configuration is disabled.Similarly, customers who wish to opt-in with the defined keywords will not be included in the subscription list if Opt-in keyword type configuration is disabled.

3. Click Save Changes. The Keyword Management section appears.

4. In Opt-out instructions, click Change next to the pre-configured instruction. The Opt-out Instructions popup window appears.

Opt-out instructions are as follows:

FIELD DESCRIPTION
Auto append opt-out Instruction in every message Select the option if you want to add an opt-out instruction to every message that is sent out.
In an Interval Select this option to send messages only after the defined number of weeks. The recommended practice is to send 1 message every 4 weeks. You can select the interval period in the drop-down list that appears.
Do not Auto-append opt-out instructions in every message Select this option if you do not want to add an opt-out instruction to every message that is sent out.
Opt-out Message Type the message you want to append as an opt-out instruction. This field appears only if you select the Auto append opt-out Instruction in every message

5. Click Save. The opt-out instructions, if added, appears as shown.




Create a Consent Database

Consent records are the most important prerequisites for sending messages to your customers. It defines the necessary permissions that are required for you to send messages to customers.

Double opt-in consents are another essential requirement in order to continue your messaging practices. These are received in response to requests sent to customers using non-handset sources, like web forms or emails, to record their compliance.

As per regulatory guidelines, all consent, collected through non-handset sources or created manually needs to be maintained and recorded in a database.

Consent is recorded on the basis of the parameters defined in the Compliance Configuration.

Consent can be created in the following ways:

  • Create Consent through Process Builders
  • Create Consent Manually

Create Consent through Process Builders

  1. Under Setup, click Process Builder and then click New. The New Process pop-up window appears
  2. .

  3. Enter the following information.
    • The Process Name
    • The API name
    • A Description of the process
    • The Action trigger indicating when the process will begin
  4. Click Save.
  5. In the Process Builder page click Add Object.
  6. Under Object, type the object that will be modified, for example, Contact or Lead.
  7. Click Save.
  8. Click Add Criteria.
  9. Define the criteria as Whenever a new lead is created for the action group.
  10. Click Add Action . The Action fields appear.
  11. Enter the details, as required. Refer to the table below for more details.
  12. Click Add Row to include additional fields.
  13. FIELD DESCRIPTION
    Action Define the Action as: Create a Record.
    Action Name Provide a name for the Action. 
    Define Fields
    these fields need to be configured during the Compliance Configuration process.
    Mobile Number Select the Mobile Number that is selected as the consent parameter for creating the consent record.
    Sender ID Select the Sender ID that will be used to create the consent record.
    This field is important only if you select Sender ID as one of the parameters for creating the consent record. You may skip this field if it has not been defined as a parameter in your compliance configurations. In such a scenario consent record will be created irrespective of the Sender ID the request is received from.
    Content Select the Content type for which the consent request will be created.
    You may skip this field if content type is not selected as a parameter to collect consent requests in your compliance configurations.
    Confirmation Config Select the confirmation configuration ID from the Confirmation Config object. This ID comprises the Sender Id from which the confirmation message will be sent. This configuration is completed in Step 3 of the compliance configuration process and will be displayed for Opt-in, optout and double opt-in consent requests.
    Do Not Send Confirmation Select this value as true if you do not wish to send a confirmation message.
    Compliance Status Select the consent status that shall be recorded i.e. Opt-Out, Opt-In, etc. You will need to create multiple process builders to generate consent records with different compliance status.
    Source Select the source for generating the consent and set the value as Non-handset
    Lead Select Lead as a record field and select the value for the lead lookup.
    This can also be contact depending on which object you are selecting.
  14. Click Save.
  15. Click Activate and then click Confirm.
  16. You can also import consents by creating a CSV with all the fields mentioned above. Click Import to start importing consents.

Create Consent Manually

  1. Click. The app launcher appears.
  2. Under All Items, click Consents. The Consent List view page appears.
  3.  

  4. Click New. The Add New Consent Record pop-up window appears.
  5. If the button is disabled, enable the Allow users to manually Add/Edit Consent Records option in Step 2 of the Compliance Configuration process.
  6. Enter the details as required.

    Refer to the table below for more details on individual fields.
  7. Click Save. The Consent Record List is added to the consent database and appears as shown.
  8. Click individual record and the record details appears as shown.
FIELD DESCRIPTION
Select Object Select the object for which you want to create the consent record.
Phone field Select the phone field from which consent records will be considered. 
Search By name Search the Contact name for which the consent record will be created.
Comment Type a comment for the record.
Content Type Select the appropriate checkbox next to select the appropriate content type. This parameter will appear only if they have been configured in Step 1 of the Compliance Configuration process. Contact your System Admin for more details on the consent record parameters configured.
Sender ID Select the Sender ID from which consent will be initiated. This is available only if Sender ID is configured as a consent record parameter in Step 1 of the Compliance Configuration process. Contact your System Admin for more details on consent record parameters configured.

If Sender ID is not configured then consent will be created from any Sender ID. Once the consent record is created, a confirmation message is sent back to the same Sender ID to complete the process. If a Sender ID is configured then consent will be created only when request is received from the specified Sender ID.
Consent Status In the drop-down list select the status of your consent. The available options are:
Opt-In, Opt-Out, and Pending.
Do not send Confirmation Message Select this check-box to avoid sending a message to confirm the consent status of the customer.
Confirmation Message Sender ID Select the sender ID that will be displayed when the confirmation message is sent to the customer.

Edit Content Records

  1. Select the checkbox adjacent to the consent record you want to edit.
  2. Click and then select edit. The Edit Consent Record for <phone number> pop-up window appears.
  3. Edit the details as required. Refer to the table below for more details on individual fields.
  4. FIELD DESCRIPTION
    Content Type Displays the content type for which consent has been added.
    Sender ID Displays the default Sender ID for receiving the consent.
    Current Status Displays the current consent status.
    Change Status To Select the new consent status.
    Do not send Confirmation Message Select this check-box to send a message confirming the consent status of the customer.

    Confirmation Message Sender ID Select the Sender ID that will be displayed when the confirmation message is sent to the customer. 
    Opt-out confirmation message Type the confirmation message that will be sent in case the consent status is set to Opt-Out.
  5. Click Save Changes. Consent Record is updated in the list view.
  6. Click  on the list view to edit the record phone number.
    Click and then select Delete to delete a consent record.
  7. Click the record number. The Consent Details appear.
FIELD DESCRIPTION
Content Type Displays the content type for which consent has been added.
Sender ID Displays the default Sender ID for receiving the consent.
Current Status Displays the current consent status.
Change Status To Select the new consent status.
Do not send Confirmation Message Select this check-box to send a message confirming the consent status of the customer.

Confirmation Message Sender ID Select the Sender ID that will be displayed when the confirmation message is sent to the customer. 
Opt-out confirmation message Type the confirmation message that will be sent in case the consent status is set to Opt-Out.

Change Consent Record Owner

  1. Log in to Salesforce.
  2. Click . The App Launcher pop-up window appears.

  3. Under All items, click Consents. The Consents record page appears.

  4. Click and select All to remove filters and view all records. The All records view appears.
  5. Select the checkbox adjacent to the consent record you want to edit.
  6. Click and then select Change Owner. The Change Owner pop-up window appears.
  7. Type the first three letters to search for the user you want to move the consent record. The search results appear as a drop-down list.
  8. Select a user.

    Prior to selecting a user, ensure that read permissions are enabled for the current record and all related records.

  9. Clear the Send Notification Email checkbox if you do not want to send an email to notify the selected user of being assigned as the consent record owner.
  10. Click Submit.

View Audit History

  1. Log in to Salesforce.
  2. Click . The App Launcher pop-up window appears.
  3. Under All items, click Consents. The Consents record page appears.
  4. Click and select All to remove filters and view all records. The All records view appears.
  5. Click a consent record to view details. The Consent details page appears.
  6. Click a consent status on the right to view the audit history details.
  7. Refer to the table below for more details on individual fields.

FIELD DESCRIPTION
Sender ID Displays the Sender ID who sent the consent.
Confirmation Sent Displays whether a confirmation message has been sent out for the consent received.
Source Displays the source from which the consent is received.
Double Opt-In Displays whether a double opt-in request is sent to the customer.
Double Opt-in Keyword Displays the Double opt-in keywords that is shared with customer. This field displays value only if the Double opt-in request is sent to customers.
Status Displays the current consent status of the record. For example, Opt-in, Opt-out or Pending.
SMS Record Reference Displays the reference number of the SMS History record.
Old Status Displays the previous consent status of the record.
Modified By Displays the ID of the user who modified the record.

Change Consent Owner

  1. Log in to Salesforce.
  2. Click . The App Launcher pop-up window appears.
  3. Under All items, click Consents. The Consents record page appears.
  4. Click and select All to remove filters and view all records. The All records view appears.
  5. Select the checkbox adjacent to the consent record you want to edit.
  6. Click and then select Change Owner from the drop-down list that appears. The Change Owner pop-up window appears.
  7. Type the first three letters to search for the user to whom you want to assign the consent record. The search results appear as a drop-down list.
  8. Select the user.

  9. Prior to selecting a user, ensure that read permissions are enabled for the current record and all related records.
  10. Clear the Send Notification Email checkbox if you do not want to notify the selected user of being assigned as the consent record owner.
  11. Click Submit

Upload Existing Consent Database

Why do I Need to Create a Consent Record for Using SMS-Magic Converse with the Compliance Feature?

We store the consent record in Converse 1.59 differently as compared to the previous version of SMS-Magic Converse.

Prior to the 1.59 release, we used to store consent information like Opted-In or Opted-Out on the object record detail page. The disadvantage of this style of storing consent information is that if the same number exist for two lead records and one record has opted-in and another record has opted-out information. The system will block one message but will still send the message to another record.

To overcome the above problem, we maintain consent information in Consent object and not at the object record level. These consent records are referred to when a user attempts to send messages via bulk, automated or manually. So, for example, the Bulk source, the Consent Required is configured, the system will always check for an Opt-In entry in Consent object.

When Do I Need to Create or Migrate Consent Records?

Consent migration is required for the following scenarios:

  • If you have explicit consent obtained via the website, email or mobile handset captured at the object record level.
  • If you have explicit consent obtained via contract or paper forms.

Consent Obtained via Website, Email, or Mobile Handset

You have explicitly obtained consent for the recipient via Web, Email or Mobile Handset and stored at the object record level. SMS-Magic Converse have no information where and how the consent information is stored. In order to map this consent information with the SMS-Magic Converse, admins need to create these records in Consent object along with consent type (Opt-in or Opt-Out).

To create consent records previously obtained from the recipient’s mobile numbers, you need to create a CSV file with all the fields mentioned below.

FIELD DESCRIPTION
Phone Number The mobile phone number from which the consent is obtained.
SenderId The phone number or virtual number used by SMS-Magic customers to obtain consent.
Content Type If the consent has been obtained for a specific program.
Compliance Status Opt-In or Opt-Out or Pending (In case of double opt-in).
Lead, Contact or Custom Object Lookup Id for lead, contact, or any custom object.
Confirmation Config Id of confirmation configuration created in Step 3 of the compliance setup.
Do Not Send Confirmation When set true, no confirmation message will be sent to the recipient mobile number.
Comment Add text on how the consent was obtained.

Once the consent record is created for the recipient from whom the consent is obtained. The next step is to define the configuration when the record is created in CRM so that the consent record is automatically created.

Consent Obtained via Contract or Paper Forms

Steps remain the same as above for creating consent via contract or paper forms.

How to Ensure that Consent Records are Created Automatically for a New Contact?

Again, you would need to create a consent record for contacts for the following scenarios:

  • Explicit consent obtained via the website, email or mobile handset captured at the object record level.
  • Explicit consent obtained via contract or paper forms.

Explicit Consent Obtained via Website, Email, or Mobile Handset

We recommend that you use a process builder and create the consent record when the record is created or edited. Write a process builder on record creation and create a consent record with the below fields.

FIELD DESCRIPTION
Phone Number The mobile phone number from which the consent is obtained.
SenderId The phone number or virtual number used by SMS-Magic customers to obtain consent.
Content Type If the consent has been obtained for a specific program
Compliance Status Opt-In or Opt-Out or Pending (In case of double opt-in)
Lead, Contact or Custom Object Lookup Id for lead, contact or any custom object
Confirmation Config Id of confirmation configuration created in Step 3 of the compliance setup.
Do Not Send Confirmation When set true, no confirmation message will be sent to the recipient mobile number.
Comment Add text on how the consent was obtained.

Please note, when records are created via non-mobile handset like web forms, one needs to get the opt-in via a mobile handset. This process of confirming consent via mobile handset by contact created by web forms is called as Double Opt-in.

To initiate double opt-in, the admin needs to use Confirmation Config field and add Compliance Status to Pending to initiate a double opt-in process. One can find Confirmation Config Id under Converse Settings > Compliance > Double Opt-In & Other > View Details.

Explicit Consent Obtained via Contract or Paper Forms

If you need to capture the consent on a continuous basis and whenever the records are created or edited. We recommended the same process as mentioned above. You must use the comment fields when creating a consent record so that during the audit process you can confirm the source of the consent.




Assign a Permission Set

The Permission Sets are preset by SMS-Magic while the Custom Permissions are customized permissions based on the requirements of the user’s organization.

Assign these permission set to users to provide access to SMS-Magic Objects.

Available Permission Sets:

SMS Converse Conversation User: Provides permissions for objects and fields to users required to send messages using SMS-Magic converse.

SMS Converse Template Author: Provides permissions for objects and fields to users required to edit and create SMS-Templates using SMS-Magic Converse.

SMS Converse Permission Set: Superset of the above-mentioned Permission Sets. Provides permissions for all the objects and fields to use SMS-Magic Converse, Recommended for Admin Users.

For more information about assigning permission sets, see (Admin Guide Topic link).




Assign Custom Permissions

You can assign custom permission to profiles of your Salesforce Org to control access of features of SMS-Magic Objects. For more information about assigning custom permissions, see (Admin Guide Topic link).

Below are key use business use cases, that would help you to get started on User Permissions.

Use-cases Salesforce Permissions (MOC)  Permission Sets (Users) Custom Permission (Profiles) 
Conversation User: Ben is a sales agent and wants to interact with an Opportunity through SMS on SMS Magic Converse App with pre-defined templates  Read Access to Opportunity — Object-defined through MOC  SMS Converse Conversation User AllowToUseSMSInsight, AllowToSendMMS, AllowToChangeConversationOwner, AllowToTakeActionOnConversation, 
Campaign User: Seema is a marketing associate and she wants to run recurring campaigns  Read Access to Campaign Object-defined through MOC SMS Converse Conversation User AllowToSendBulkMessage, AllowToSendCampaignMessage, AllowToSendListViewMessage, AllowToSendMMS, AllowToScheduleMessage, AllowToScheduleRecurringMessage, 
Automation User: Shelly wants to run promotional offer notifications on SMS for its customers Read Access to Contacts Object-defined through MOC SMS Converse Conversation User AllowToUseSMSInsight, AllowToSendMMS 
Admin User: Rony is salesforce consultant to the Org and he handles all configuration and needed to setup custom templates for sales, marketing, etc.  SMS Converse Template Author AllowToEditSMSSettings
Conversation User: Morgan is the boss of Jen and he interacts with healthy prospects with opportunity value > $10k Read Access to Opportunity defined through MOC SMS Converse Conversation User AllowToUseSMSInsight, AllowToSendMMS, AllowToChangeConversationOwner, AllowToTakeActionOnConversation, AllowToChangeTemplateSelection, AllowToChangeOptout 
Admin User: Rony is tasked to assign 4 sender ID to Sales team, 4 to service team, 2 to marketing team and restrict its usage to these teams SMS Converse Permission Set AllowToEditSMSSettings



Configure Converse Desk Layout

In the Converse Desk Layouts tab, you can configure the following:

  • Conversation Filters and Global Filters for specific users and profiles
  • The color theme for the Converse Desk
  • Conversation Topic Layout

 For more information about configuring Converse Desk Layouts, see (Admin Guide Topic link).




49. Can a Sender ID be assigned to a user?

Yes, Sender IDs can be assigned to a user or a profile in the SMS-Magic Converse version. Refer to the Sender Id and assignment section in the SMS-Magic Converse Salesforce Admin Guide.




Configure General Settings

In the General Settings tab, you can disable or enable user privileges for the following features:

  • Send Canned Responses
  • Define Character Limit for Messages
  • Internal Note
  • Configure CRM Actions
  • Configure Related Conversation

For more information about configuring message settings, see (Admin Guide Topic link).