{"id":7686,"date":"2021-09-17T15:50:33","date_gmt":"2021-09-17T15:50:33","guid":{"rendered":"http:\/\/3.26.62.22\/?post_type=ht_kb&#038;p=7686"},"modified":"2021-11-06T00:40:03","modified_gmt":"2021-11-06T00:40:03","slug":"sms-messages","status":"publish","type":"ht_kb","link":"http:\/\/help.gjgardner.com\/nz\/hc\/getting-started\/sms-messages\/","title":{"rendered":"Sending SMS Messages"},"content":{"rendered":"<p>G.J. Software is integrated with Twilio to support SMS functionality. Twilio integrations are managed by the Franchisor and configured under the <a href=\"http:\/\/help.gjgardner.com\/nz\/hc\/setup\/system-variables\/integration-accounts\/\" data-type=\"ht_kb\" data-id=\"771\">Integration Accounts<\/a> in System Variables.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>View the message list<\/strong><\/h2>\n\n\n\n<p>The SMS Messages screen shows a history of all message replies sent to the currently logged-in user. If there are no SMS messages the system shows the page with no results. If there is at least one message displayed a list of SMS messages ordered by Unread messages in the order in which they were received, then by Read messages in descending order with the most recently received messages showing at the top.&nbsp;<\/p>\n\n\n\n<p>Users will only see messages if the recipient replied to their message. However, if a client responds to a <a href=\"https:\/\/help.gjgardner.com\/nz\/hc\/setup\/setup-milestone-events-list\/\" data-type=\"ht_kb\" data-id=\"690\">Milestone Event<\/a>, the SMS will be sent to the assigned salesperson (if lead), administrator (if job), or Supervisor (if schedule).<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Messages sent from a phone number that is not associated with any contact will be sent to all users with the Administrator System Role. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"475\" src=\"https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-1024x475.png\" alt=\"\" class=\"wp-image-7687\" srcset=\"https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-1024x475.png 1024w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-300x139.png 300w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-768x356.png 768w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-50x23.png 50w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-1536x713.png 1536w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-18x8.png 18w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-60x28.png 60w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages-100x46.png 100w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-messages.png 1920w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>1<\/strong><\/td><td><strong>Notification icon<\/strong> <\/td><td>The notification icon displays the number of unread messages.&nbsp; <\/td><\/tr><tr><td><strong>2<\/strong><\/td><td><strong>Search criteria<\/strong> <\/td><td>The search bar refines the list by contact name, phone number, or message content. The date fields allow users to only display messages sent in a specific date range. <\/td><\/tr><tr><td><strong>3<\/strong><\/td><td><strong>Bulk update<\/strong> <\/td><td>Bulk operations can be performed on multiple messages. Here users to Mark one more messages as read or unread. <\/td><\/tr><tr><td><strong>4<\/strong><\/td><td><strong>Filters<\/strong> <\/td><td>The <em>Show Messages<\/em> filters further refine the list of messages.<br><br><strong>Show Contact<\/strong> shows all messages received from phone numbers that are associated with an existing contact. These messages can be identified by the name discipline in the <em>Contact<\/em> column. Disabling this filter will hide all of these contacts from the list.&nbsp;<br><br><strong>Unknown Contact<\/strong> shows all messages received from a phone number that is NOT associated with a contact. These messages will not have any value in the <em>Contact <\/em>column. Disabling this filter will hide all unknown contacts from the list.<\/td><\/tr><tr><td><strong>5<\/strong><\/td><td><strong>SMS information<\/strong> <\/td><td>All information about the SMS is available in the table. Clicking on the message will open a the <em>Reply SMS Window<\/em>. If the message is Unread it will be marked as Read.&nbsp; <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">The SMS list is only visible if users meet any of the following conditions: <br><br>User has the View Contact or View Job Details office role permissions<br><br>User has the Salesperson System Role, View Leads office role permission and access to the specific lead.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>View\/Reply to messages<\/strong><\/h2>\n\n\n\n<p>When a user clicks on the SMS messages from the table the system the SMS window appears showing the content of the message.&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"478\" src=\"https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-1024x478.png\" alt=\"\" class=\"wp-image-7688\" srcset=\"https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-1024x478.png 1024w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-300x140.png 300w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-768x358.png 768w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-50x23.png 50w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-1536x717.png 1536w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-18x8.png 18w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-60x28.png 60w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply-100x47.png 100w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2021\/09\/sms-reply.png 1920w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>1<\/strong><\/td><td><strong>From<\/strong> <\/td><td>Who the message was sent from. Click on the contact name to view their Contact Details. Messages sent from unknown contacts will not display a contact name. <\/td><\/tr><tr><td><strong>2<\/strong><\/td><td><strong>Message<\/strong> <\/td><td>Full message body received from the contact. <\/td><\/tr><tr><td><strong>3<\/strong><\/td><td><strong>Reply<\/strong> <\/td><td>Enter a response to send to the contact. <\/td><\/tr><tr><td><strong>4<\/strong><\/td><td><strong>Cancel \/ Reply<\/strong> <\/td><td>Cancel sending a message or Reply to send a response. <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">The user can only reply to SMS messages if they meet any of the following conditions:<br><br>User has the Job Details, Contact, or Sales Lead Edit office role permissions<br><br>User has the Salesperson System Role, Edit Leads office role permission and access to the specific lead.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>New message notifications<\/strong><\/h2>\n\n\n\n<p>The user who triggered the message receives a pop-up notification as well as an icon counting the number of unread messages over the SMS icon in the top navigation menu. The flow of events is as follows:<\/p>\n\n\n\n<ol class=\"wp-block-list\"><li>User sends an SMS to a recipient<\/li><li>Recipient replies to SMS<\/li><li>The system checks whether the response contained any <a href=\"https:\/\/support.twilio.com\/hc\/en-us\/articles\/223134027-Twilio-support-for-opt-out-keywords-SMS-STOP-filtering-\"><em>opt-out keywords<\/em><\/a><ol><li>If yes, the recipient is unsubscribed from receiving SMS and the flow of events stops<\/li><\/ol><\/li><li>The system adds a value to the unread notification count<\/li><li>The systems displays a pop-ip notification<\/li><\/ol>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-vimeo wp-block-embed-vimeo wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"SMS Reply Notifications\" src=\"https:\/\/player.vimeo.com\/video\/604391299?h=258f0ecb20&amp;dnt=1&amp;app_id=122963\" width=\"643\" height=\"362\" frameborder=\"0\" allow=\"autoplay; fullscreen; picture-in-picture; clipboard-write\"><\/iframe>\n<\/div><\/figure>","protected":false},"excerpt":{"rendered":"<p>G.J. Software is integrated with Twilio to support SMS functionality. Twilio integrations are managed by the Franchisor and configured under the Integration Accounts in System Variables. View the message list The SMS Messages screen shows a history of all message replies sent to the currently logged-in user. If there are&#8230;<\/p>","protected":false},"author":21,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[7],"ht-kb-tag":[197,198],"class_list":["post-7686","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-getting-started","ht_kb_tag-sms","ht_kb_tag-twilio"],"_links":{"self":[{"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/ht-kb\/7686"}],"collection":[{"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/users\/21"}],"replies":[{"embeddable":true,"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/comments?post=7686"}],"version-history":[{"count":2,"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/ht-kb\/7686\/revisions"}],"predecessor-version":[{"id":7918,"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/ht-kb\/7686\/revisions\/7918"}],"wp:attachment":[{"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/media?parent=7686"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/ht-kb-category?post=7686"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.gjgardner.com\/nz\/wp-json\/wp\/v2\/ht-kb-tag?post=7686"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}