{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Receiving & Sending Messages","type":"basic","slug":"receiving-and-sending-messages","excerpt":"","body":"On the left column, there are three segments: New, Mine, and All. \n  * **New** - incoming Sonar messages that have not been assigned to an agent or team member\n  * **Mine** - all Sonar messages assigned to you\n  * **All** - all Sonar messages that are unassigned, assigned to you, or assigned to other team members\n\n##Filtering and Sorting Messages\nIn the New and All sections, you can filter messages based on ****Status**** and/or ****Assignment****.\n* **Status**\n * Unreplied - messages that haven't been replied to\n * Replied - messages that have already been replied to\n * Closed - messages that have been closed\n* **Assignment**\n * Anyone - messages that are assigned to any team member\n * No one - messages that are assigned to no team member\n* **Team**\n * Bots - messages that are assigned to bots\n * Custom Teams - messages assigned to respective teams that your organization has created\n\n\nAlso, you can sort messages from ****New to Old**** or ****Old to New****. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2a5182c-1111.png\",\n        \"1111.png\",\n        566,\n        391,\n        \"#4743a3\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\n##Incoming messages\n* All new messages will be in bold with a red dot to the left side of the thread.\n * Clicking on the message will make it unbolded\n * Replying to the message will remove the red dot\n * ****Mark as Replied**** will remove the red dot\n* New, unassigned messages will appear in the **New** panel\n* Assigned messages that are assigned to you will appear in the **Mine** panel\n* Assigned messages that are not assigned to you will appear in the **All** panel\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/dd189cb-44444443337685f.gif\",\n        \"44444443337685f.gif\",\n        559,\n        620,\n        \"#f9f9f9\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\n## Closing vs Deleting Customers\nClosing a customer text thread will automatically unassign the customer from a rep/team. The text thread will be removed from your viewing list but the entire conversation will be archived for future reference. You will always be able to reopen your conversation again by filtering customers by Closed.\n\nTo close a customer thread:\n\n* Go to the left column and select the box on the left-side of the text thread \n* Open up the Actions drop-down menu\n* Choose Close\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/56db811-Try21.gif\",\n        \"Try21.gif\",\n        396,\n        401,\n        \"#e4e6e0\"\n      ]\n    }\n  ]\n}\n[/block]\nDeleting a customer will remove all their contact information and text conversation history from the Sonar platform. \n\nTo delete a customer:\n\n* Open up the Menu tab and select Customers\n* To the right-side of the Customers pop-up, you'll see an Actions column\n* Click on the X to delete the customer\n* A pop-up will then ask to confirm this action\n\n##Notifications\nWhen incoming messages come through Sonar, you can be notified in 3 ways:\n* Desktop notifications\n* Email notifications (located in the Email Notifications section within the ****Settings**** tab) \n* <a href=\"http://docs.sendsonar.com/docs/slack\">Slack</a>\n\n##Outgoing messages\nTo respond or send a message to a customer (must have opt-in), first type your text in the message input box and click Send or hit Enter. In the message, you can include attachments or emojis as well. \n\nAlso, you can send <a href=\"http://docs.sendsonar.com/docs/canned-responses\">Canned Responses</a> to answer common questions or send an intro/welcome message. \n\nTo send messages via API, check out our [Send Message](doc:send-message) documentation.\n\n\n## **Using Property Values as Templates (Macros)**\nYou can add property values (macros) to messages by starting the property with a {{ then the property name, and then close it with }}.\n\nExample:\n\n**Dear {{first_name}}**\nwill render to something like\n**Dear Joseph** in the actual text message.\n\nThere are cases when a customer may not have a property's value. In this case, you can add a general alternative:\n**Would you like us to wash your {{car_name|chariot}} on Monday?**\nwill render to\n**Would you like us to wash your chariot on Monday?**\n\nIf the customer does not have car_name defined. If the car_name property is set to \"CLK500\", then the text will be:\n**Would you like us to wash your CLK500 on Monday?**\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Property Macros\",\n  \"body\": \"Property values (macros) can also be used in [Campaigns](doc:campaigns) as well.\"\n}\n[/block]","updates":[],"order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"554967d8a5ecbc1900321694","project":"55208137623ff50d009b2bec","category":{"sync":{"isSync":false,"url":""},"pages":["55208138623ff50d009b2bf2","554967bbcd09b317005f8f62","554967c8c634cf2d00125087","554967d8a5ecbc1900321694","554967e4c634cf2d0012508a"],"title":"Getting Started Guide","slug":"getting-started","order":0,"from_sync":false,"reference":false,"_id":"55208138623ff50d009b2bf0","__v":5,"createdAt":"2015-04-05T00:26:32.042Z","version":"55208137623ff50d009b2bef","project":"55208137623ff50d009b2bec"},"githubsync":"","user":"55208129504fd6230022ae20","__v":3,"parentDoc":null,"version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"categories":["55208138623ff50d009b2bf0","55494a226a82a10d00817ae5","55494ba7ee219b0d001743c8","55494bc1ee219b0d001743cc","56ead8c1df765617008bccaf","573a2073dd007d1700cf288f","579695b1f64c9f0e007cd76c","57969e3dfa1ff60e006a1274","579a4592fd9f3c0e008e4f4a","57ab9afe54fa780e006c5430","57b784f5b7ebd60e009cb4a6","58f686818193090f008cec76","59e79fbd4cf31900341d50c6","5b2436973fd93f0003dcf99d","5d824fb2ce98a801366098a2"],"_id":"55208137623ff50d009b2bef","createdAt":"2015-04-05T00:26:31.564Z","releaseDate":"2015-04-05T00:26:31.563Z","__v":15,"project":"55208137623ff50d009b2bec"},"createdAt":"2015-05-06T01:01:12.112Z"}

Receiving & Sending Messages


On the left column, there are three segments: New, Mine, and All. * **New** - incoming Sonar messages that have not been assigned to an agent or team member * **Mine** - all Sonar messages assigned to you * **All** - all Sonar messages that are unassigned, assigned to you, or assigned to other team members ##Filtering and Sorting Messages In the New and All sections, you can filter messages based on ****Status**** and/or ****Assignment****. * **Status** * Unreplied - messages that haven't been replied to * Replied - messages that have already been replied to * Closed - messages that have been closed * **Assignment** * Anyone - messages that are assigned to any team member * No one - messages that are assigned to no team member * **Team** * Bots - messages that are assigned to bots * Custom Teams - messages assigned to respective teams that your organization has created Also, you can sort messages from ****New to Old**** or ****Old to New****. [block:image] { "images": [ { "image": [ "https://files.readme.io/2a5182c-1111.png", "1111.png", 566, 391, "#4743a3" ], "border": true } ] } [/block] ##Incoming messages * All new messages will be in bold with a red dot to the left side of the thread. * Clicking on the message will make it unbolded * Replying to the message will remove the red dot * ****Mark as Replied**** will remove the red dot * New, unassigned messages will appear in the **New** panel * Assigned messages that are assigned to you will appear in the **Mine** panel * Assigned messages that are not assigned to you will appear in the **All** panel [block:image] { "images": [ { "image": [ "https://files.readme.io/dd189cb-44444443337685f.gif", "44444443337685f.gif", 559, 620, "#f9f9f9" ], "border": true } ] } [/block] ## Closing vs Deleting Customers Closing a customer text thread will automatically unassign the customer from a rep/team. The text thread will be removed from your viewing list but the entire conversation will be archived for future reference. You will always be able to reopen your conversation again by filtering customers by Closed. To close a customer thread: * Go to the left column and select the box on the left-side of the text thread * Open up the Actions drop-down menu * Choose Close [block:image] { "images": [ { "image": [ "https://files.readme.io/56db811-Try21.gif", "Try21.gif", 396, 401, "#e4e6e0" ] } ] } [/block] Deleting a customer will remove all their contact information and text conversation history from the Sonar platform. To delete a customer: * Open up the Menu tab and select Customers * To the right-side of the Customers pop-up, you'll see an Actions column * Click on the X to delete the customer * A pop-up will then ask to confirm this action ##Notifications When incoming messages come through Sonar, you can be notified in 3 ways: * Desktop notifications * Email notifications (located in the Email Notifications section within the ****Settings**** tab) * <a href="http://docs.sendsonar.com/docs/slack">Slack</a> ##Outgoing messages To respond or send a message to a customer (must have opt-in), first type your text in the message input box and click Send or hit Enter. In the message, you can include attachments or emojis as well. Also, you can send <a href="http://docs.sendsonar.com/docs/canned-responses">Canned Responses</a> to answer common questions or send an intro/welcome message. To send messages via API, check out our [Send Message](doc:send-message) documentation. ## **Using Property Values as Templates (Macros)** You can add property values (macros) to messages by starting the property with a {{ then the property name, and then close it with }}. Example: **Dear {{first_name}}** will render to something like **Dear Joseph** in the actual text message. There are cases when a customer may not have a property's value. In this case, you can add a general alternative: **Would you like us to wash your {{car_name|chariot}} on Monday?** will render to **Would you like us to wash your chariot on Monday?** If the customer does not have car_name defined. If the car_name property is set to "CLK500", then the text will be: **Would you like us to wash your CLK500 on Monday?** [block:callout] { "type": "info", "title": "Property Macros", "body": "Property values (macros) can also be used in [Campaigns](doc:campaigns) as well." } [/block]