How-To: Create an Opt-In Keyword Contact Group

How-To: Create an Opt-In Keyword Contact Group

The Opt-in Keyword feature for Contact Groups allows new participants to be added to the contact group when they send a text message to your organization containing a unique keyword, phrase, letters, or numbers attributed to that contact group. Upon the keyword, phrase, letter or number being received, an auto response is sent back to the participant. These auto responses can also create a new chat message, including adding a subject, or assigning the chat message to a particular user. 
  1. For more information about creating a contact groups, please visit:  Contacts Page

Add an Opt-In Keyword to a New Contact Group

  1. Log-in to: https://hms.teletask.com/, your email address is your username.

  2. Click on Contacts   in the top menu bar.

  3. Press Create a new Group  button in the top right-hand corner.

  4. TypeGroup Name for the new contact group



  5. Under Where do you want to import contacts from?select the radio button for Add Contacts Later.


  6. Press the Next  button to finalize your selection. The contact group will now be created.

  7. Locate the newly created contact group in the list, click the drop-down menu next to Edit, and choose Settings to open the Settings tab.



  8. On the Settings tab, click on the Add Opt-In keyword button   to open the opt-in keyword Settings.



  9. Under Opt-in keyword, input the word, phrase, letters, or numbers you wish participants to text to your organization in order to be added to the contact group. The keyword must be a minimum of 4 characters, is not case sensitive and cannot be used by any other contact group or in a message's auto response.

    1. For more information about auto responses please visit: How to: Add Auto-Response For Text Messages



  10. Under Canned auto response, type the message that will be sent to the recipient when the keyword is received. You can include Merge TagsWeb Surveys, or Media Files in the text box.

    Note: We recommend configuring this message as a text message and then copying over the message to the Canned auto response field to make sure any custom links and Merge Tags are configured correctly. You can re-size the field by right-clicking and dragging on the bottom right-hand corner   icon.



    1. For more information about Merge Tags, please visit: How to: Create a Text Message
    2. For more information about Web Surveys, please visit: How to: Create a Web Survey
    3. For more information about Media files, please visit: How To: Add and Send Media Files

  11. OPTIONAL:  To open a new chat on the Chat page of the web portal, check the box for Route Responses to Chat. This chat will open as Unread and Unassigned without a Subject associated with it.

    Note: The option to Route Responses to Chat must be checked if you want to utilize the options Mark Chat Responses as Read, Assign Chat Subject, or Assign Chat to User (Optional Steps 12-14).



  12. OPTIONAL:  To leave the chat Open but left in the Read status, check the box for Mark Chat Responses as Read. If the chat was already in the Unread status before the Reply Text is received, it will remain Unread.



  13. OPTIONAL:  To assign an existing subject to the chat, use the drop-down menu to select the subject under the Assign Chat Subject heading.

    Note: Removing a chat subject from the Chat Settings will result in any auto-responses with that assigned chat subject to appear with a blank chat subject, both in Chats and Reports.



    1. For more information about creating chat subjects, please visit: How to: Add Subjects to Chat

  14. OPTIONAL:  To assign an existing user to the chat, use the drop-down menu to select a user under the Assign Chat to User heading.

    Note: Please verify the user the chat is being assigned to has access to the Chats page on the web portal.



    1. For more information about adding users, please visit: How to: Add a New User

  15. Press the green Next   button in the bottom right corner to save your changes. The Opt-in keyword is now live and ready to be used.

  16. OPTIONAL: Repeat steps 6 through 15 to add additional Opt-in keywords to your contact group. 

Adding an Opt-In Keyword to an Existing Contact Group

  1. Log-in to: https://hms.teletask.com/, your email address is your username.

  2. Click on Contacts   in the top menu bar.

  3. Locate the contact group that you will be editing in the list, click the drop-down menu next to Edit, and choose Settings to open the Settings tab.



  4. On the Settings tab, click on the Add Opt-In keyword button   to open the opt-in keyword Settings.



  5. Under Opt-in keywordinput the word, phrase, letters, or numbers you wish participants to text to your organization in order to be added to the contact group. The keyword must be a minimum of 4 characters, is not case sensitive and cannot be used by any other contact group or in a message's auto response.

    1. For more information about auto responses please visit: How to: Add Auto-Response For Text Messages



  6. Under Canned auto responsetype the message that will be sent to the recipient when the keyword is received. You can include Merge TagsWeb Surveys, or Media Files in the text box.

    Note: 
    We recommend configuring this message as a text message and then copying over the message to the Canned auto response field to make sure any custom links and Merge Tags are configured correctly. You can re-size the field by right-clicking and dragging on the bottom right-hand corner   icon.



    1. For more information about Merge Tags, please visit: How to: Create a Text Message
    2. For more information about Web Surveys, please visit: How to: Create a Web Survey
    3. For more information about Media files, please visit: How To: Add and Send Media Files

  7. OPTIONAL:  To open a new chat on the Chat page of the web portal, check the box for Route Responses to Chat. This chat will open as Unread and Unassigned without a Subject associated with it.

    Note:
     The option to Route Responses to Chat must be checked if you want to utilize the options Mark Chat Responses as Read, Assign Chat Subject, or Assign Chat to User (Optional Steps 8-10).



  8. OPTIONAL:  To leave the chat Open but left in the Read status, check the box for Mark Chat Responses as Read. If the chat was already in the Unread status before the Reply Text is received, it will remain Unread.



  9. OPTIONAL:  To assign an existing subject to the chat, use the drop-down menu to select the subject under the Assign Chat Subject heading.

    Note:
     Removing a chat subject from the Chat Settings will result in any auto-responses with that assigned chat subject to appear with a blank chat subject, both in Chats and Reports.



    1. For more information about creating chat subjects, please visit: How to: Add Subjects to Chat

  10. OPTIONAL:  To assign an existing user to the chat, use the drop-down menu to select a user under the Assign Chat to User heading.

    Note:
     Please verify the user the chat is being assigned to has access to the Chats page on the web portal.



    1. For more information about adding users, please visit: How to: Add a New User

  11. Press the green Next   button in the bottom right corner to save your changes. The Opt-in keyword is now live and ready to be used.

  12. OPTIONAL: Repeat these steps to add additional Opt-in keywords to your contact group. 

    • Related Articles

    • How to: Edit or Delete an Existing Contact Group

      The clients or contacts that you have may change over time and you may need to update or delete your current Contact Groups. Here we have directions on how to: Import a New List of clients Download the Current List of clients in a Contact Group ...
    • How to: Create a Contact Group through the Transfer Client

      Creating a Contact Group through the Transfer Client is used when you want to continually update a Contact Group of contacts/clients using our Transfer Client or SFTP  (Secure File Transfer Protocol). Supported file formats include: .csv, .xls, ...
    • How to: Edit an Existing Contact or Client in a Contact Group

      A contact profile is a record of a client/contact which includes their contact information, opt-in preferences, message history and additional details.  The information in the contact profile may change over time and need to be updated or you may ...
    • How to: Create a Contact Group using Microsoft Excel Files

      You can create a new group by importing clients/contacts through a Microsoft Excel file. Please follow the steps below to import clients using Microsoft Excel files. Note: Our Supported Formats are: .xls, .xlsx and .csv only. Additionally, any hidden ...
    • How to: Create a Contact Group using a .txt File

      You can create a new group or add to an existing group of clients/contacts with a few changes to a .txt file. Please follow the steps below to import clients using .txt files. Note: Our Supported Formats are: .xls, .xlsx and .csv only this tutorial ...

      Support Ticket

      Submit a support request to our Support Team