{"_id":"59306418e1a814000f84676e","project":"55208137623ff50d009b2bec","version":{"_id":"55208137623ff50d009b2bef","__v":14,"project":"55208137623ff50d009b2bec","createdAt":"2015-04-05T00:26:31.564Z","releaseDate":"2015-04-05T00:26:31.563Z","categories":["55208138623ff50d009b2bf0","55494a226a82a10d00817ae5","55494ba7ee219b0d001743c8","55494bc1ee219b0d001743cc","56ead8c1df765617008bccaf","573a2073dd007d1700cf288f","579695b1f64c9f0e007cd76c","57969e3dfa1ff60e006a1274","579a4592fd9f3c0e008e4f4a","57ab9afe54fa780e006c5430","57b784f5b7ebd60e009cb4a6","58f686818193090f008cec76","59e79fbd4cf31900341d50c6","5b2436973fd93f0003dcf99d"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55494bc1ee219b0d001743cc","pages":["55496509c634cf2d0012507c","5549650ecd09b317005f8f4e","55496535a5ecbc1900321683","5549654dcd09b317005f8f53","55496557c634cf2d0012507e","55496563cd09b317005f8f55","55496673a5ecbc190032168a","55496682cd09b317005f8f5e","5549668da5ecbc190032168c","55497c3ea5ecbc19003216bd","55c1047d81dc010d00d50678","55c3cad1b0778d2100a7ebd8","5638e41e3539050d0008205f","563a2ac1f0c29b1700daaf98","563a2b7ef0c29b1700daafa2","563a2d83d25e8919005f3f05"],"project":"55208137623ff50d009b2bec","version":"55208137623ff50d009b2bef","__v":16,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-05-05T23:01:21.408Z","from_sync":false,"order":3,"slug":"features","title":"Features"},"user":"58dd58d815f4150f00839ba0","githubsync":"","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-06-01T18:59:36.318Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":21,"body":"Tags provide the ability to add more contextual information to your conversations. You can add tags on any message within a conversation.\n\nWith tags you will be able to track requests, bugs, and specific replies that come from your customers. Simply add a tag to a message as it comes in!\n[block:api-header]\n{\n  \"title\": \"View Tag List\"\n}\n[/block]\nYou will notice a tag icon beside each message in Sonar. Clicking on the icon will allow you to access to tags.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4492276-Screen_Shot_2017-06-01_at_1.35.37_PM.png\",\n        \"Screen Shot 2017-06-01 at 1.35.37 PM.png\",\n        70,\n        70,\n        \"#dcdcdc\"\n      ],\n      \"sizing\": \"original\",\n      \"caption\": \"Tag button\"\n    }\n  ]\n}\n[/block]\nBy default, you will have four tags: *Bug, Feedback, Inquiry, and Request*. You are free to edit or delete these existing tags if you wish.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e68e271-Screen_Shot_2017-06-01_at_1.36.34_PM.png\",\n        \"Screen Shot 2017-06-01 at 1.36.34 PM.png\",\n        396,\n        622,\n        \"#dad5e7\"\n      ],\n      \"caption\": \"Tag List\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Add Tag To A Message\"\n}\n[/block]\nTo add a tag to a message:\n* click on the tag-icon to view a list of existing tags\n* click on a tag to apply a tag\n* you can add more than one tag to a message\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ecdf0b0-add-tag.gif\",\n        \"add-tag.gif\",\n        690,\n        380,\n        \"#3b95a0\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Remove Tag From A Message\"\n}\n[/block]\nTo remove a tag from a message click the X beside the tag you wish to remove.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4c51db9-Screen_Shot_2017-06-01_at_2.41.24_PM.png\",\n        \"Screen Shot 2017-06-01 at 2.41.24 PM.png\",\n        934,\n        314,\n        \"#f6f8f8\"\n      ],\n      \"caption\": \"Click the X beside the \\\"Images\\\" tag to remove the tag from that message.\"\n    }\n  ]\n}\n[/block]\nYou can also deselect a tag from the tag list to remove the tag from a message.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/fa3d599-remove-tag.png\",\n        \"remove-tag.png\",\n        1258,\n        760,\n        \"#e9e7ef\"\n      ],\n      \"caption\": \"In the tag list, there are two tags selected, \\\"Bug\\\" and \\\"Images\\\". Clicking on \\\"Images\\\" in the tag list will deselect the tag from the list and remove the tag from the message.\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Create A Tag\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Tag Visibility\",\n  \"body\": \"Note that when you create a tag, everyone on your Sonar account will also see the tag and be able to use it.\"\n}\n[/block]\nTo create a new tag:\n* Click on the tag-icon to access the list of tags\n* Click on CREATE NEW TAG\n* Specify the name of the tag and choose a color\n* Click CREATE\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d2e81b8-Screen_Shot_2017-06-01_at_2.07.59_PM.png\",\n        \"Screen Shot 2017-06-01 at 2.07.59 PM.png\",\n        1336,\n        632,\n        \"#b0ad52\"\n      ],\n      \"caption\": \"Create a new tag\"\n    }\n  ]\n}\n[/block]\nOnce a tag is created, you will be able to see it in the tag list. From there you can apply this tag to messages.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/755e547-Screen_Shot_2017-06-01_at_2.09.20_PM.png\",\n        \"Screen Shot 2017-06-01 at 2.09.20 PM.png\",\n        1320,\n        822,\n        \"#e9e8ef\"\n      ],\n      \"caption\": \"Newly created tag is listed and applied to a message.\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Edit A Tag\"\n}\n[/block]\nTo edit an existing tag:\n* click on the tag-icon to access the list of tags\n* click on the pencil-icon beside the tag you would like to edit\n* click on EDIT\n\nYou will be able to change the name of the tag and the color. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9c6f26c-edit-tag.png\",\n        \"edit-tag.png\",\n        1258,\n        741,\n        \"#e8e7ef\"\n      ],\n      \"caption\": \"Edit a tag\"\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/854c615-Screen_Shot_2017-06-01_at_4.36.30_PM.png\",\n        \"Screen Shot 2017-06-01 at 4.36.30 PM.png\",\n        412,\n        528,\n        \"#e6d8dd\"\n      ],\n      \"caption\": \"Edit tag name and color\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Affects of tag edits\",\n  \"body\": \"Note that when editing a tag:\\n* all messages with that tag will reflect the edits you made\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Delete A Tag\"\n}\n[/block]\nTo delete an existing tag:\n* click on the tag-icon to access the list of tags\n* click on the pencil-icon beside the tag you would like to delete\n* click on DELETE\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8e96d1d-Screen_Shot_2017-06-01_at_4.38.26_PM.png\",\n        \"Screen Shot 2017-06-01 at 4.38.26 PM.png\",\n        476,\n        594,\n        \"#e66f5d\"\n      ],\n      \"caption\": \"Delete a tag\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Affects of tag deletions\",\n  \"body\": \"Note that when you delete a tag: \\n * the tag will be removed from any messages it was appended to\\n * you will lose any analytics and data that existed for this tag\\n * the tag will no longer be accessible for anyone on your team\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Search For Tagged Messages\"\n}\n[/block]\nTo search for a tag, go to the search bar and type in *tag: <name of tag>*. The search result will be a list of conversations containing messages with that tag.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2673ebc-Screen_Shot_2017-06-01_at_2.47.50_PM.png\",\n        \"Screen Shot 2017-06-01 at 2.47.50 PM.png\",\n        684,\n        96,\n        \"#5d5d5d\"\n      ],\n      \"caption\": \"Searching for conversations by tag name.\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Tag Analytics\"\n}\n[/block]\nNavigate to *Tools > Analytics*. At the bottom of your Analytics page, you will see analytics for your tags. We will provide data such as the total messages sent/received with a particular tag.","excerpt":"","slug":"tags","type":"basic","title":"Tags"}

Getting Started Guide

How Sonar Works

Public API

Features

Facebook Messenger

Integrations

FAQs

Product Updates

Tags

Tags provide the ability to add more contextual information to your conversations. You can add tags on any message within a conversation. With tags you will be able to track requests, bugs, and specific replies that come from your customers. Simply add a tag to a message as it comes in! [block:api-header] { "title": "View Tag List" } [/block] You will notice a tag icon beside each message in Sonar. Clicking on the icon will allow you to access to tags. [block:image] { "images": [ { "image": [ "https://files.readme.io/4492276-Screen_Shot_2017-06-01_at_1.35.37_PM.png", "Screen Shot 2017-06-01 at 1.35.37 PM.png", 70, 70, "#dcdcdc" ], "sizing": "original", "caption": "Tag button" } ] } [/block] By default, you will have four tags: *Bug, Feedback, Inquiry, and Request*. You are free to edit or delete these existing tags if you wish. [block:image] { "images": [ { "image": [ "https://files.readme.io/e68e271-Screen_Shot_2017-06-01_at_1.36.34_PM.png", "Screen Shot 2017-06-01 at 1.36.34 PM.png", 396, 622, "#dad5e7" ], "caption": "Tag List" } ] } [/block] [block:api-header] { "title": "Add Tag To A Message" } [/block] To add a tag to a message: * click on the tag-icon to view a list of existing tags * click on a tag to apply a tag * you can add more than one tag to a message [block:image] { "images": [ { "image": [ "https://files.readme.io/ecdf0b0-add-tag.gif", "add-tag.gif", 690, 380, "#3b95a0" ] } ] } [/block] [block:api-header] { "title": "Remove Tag From A Message" } [/block] To remove a tag from a message click the X beside the tag you wish to remove. [block:image] { "images": [ { "image": [ "https://files.readme.io/4c51db9-Screen_Shot_2017-06-01_at_2.41.24_PM.png", "Screen Shot 2017-06-01 at 2.41.24 PM.png", 934, 314, "#f6f8f8" ], "caption": "Click the X beside the \"Images\" tag to remove the tag from that message." } ] } [/block] You can also deselect a tag from the tag list to remove the tag from a message. [block:image] { "images": [ { "image": [ "https://files.readme.io/fa3d599-remove-tag.png", "remove-tag.png", 1258, 760, "#e9e7ef" ], "caption": "In the tag list, there are two tags selected, \"Bug\" and \"Images\". Clicking on \"Images\" in the tag list will deselect the tag from the list and remove the tag from the message." } ] } [/block] [block:api-header] { "title": "Create A Tag" } [/block] [block:callout] { "type": "info", "title": "Tag Visibility", "body": "Note that when you create a tag, everyone on your Sonar account will also see the tag and be able to use it." } [/block] To create a new tag: * Click on the tag-icon to access the list of tags * Click on CREATE NEW TAG * Specify the name of the tag and choose a color * Click CREATE [block:image] { "images": [ { "image": [ "https://files.readme.io/d2e81b8-Screen_Shot_2017-06-01_at_2.07.59_PM.png", "Screen Shot 2017-06-01 at 2.07.59 PM.png", 1336, 632, "#b0ad52" ], "caption": "Create a new tag" } ] } [/block] Once a tag is created, you will be able to see it in the tag list. From there you can apply this tag to messages. [block:image] { "images": [ { "image": [ "https://files.readme.io/755e547-Screen_Shot_2017-06-01_at_2.09.20_PM.png", "Screen Shot 2017-06-01 at 2.09.20 PM.png", 1320, 822, "#e9e8ef" ], "caption": "Newly created tag is listed and applied to a message." } ] } [/block] [block:api-header] { "type": "basic", "title": "Edit A Tag" } [/block] To edit an existing tag: * click on the tag-icon to access the list of tags * click on the pencil-icon beside the tag you would like to edit * click on EDIT You will be able to change the name of the tag and the color. [block:image] { "images": [ { "image": [ "https://files.readme.io/9c6f26c-edit-tag.png", "edit-tag.png", 1258, 741, "#e8e7ef" ], "caption": "Edit a tag" } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/854c615-Screen_Shot_2017-06-01_at_4.36.30_PM.png", "Screen Shot 2017-06-01 at 4.36.30 PM.png", 412, 528, "#e6d8dd" ], "caption": "Edit tag name and color" } ] } [/block] [block:callout] { "type": "danger", "title": "Affects of tag edits", "body": "Note that when editing a tag:\n* all messages with that tag will reflect the edits you made" } [/block] [block:api-header] { "title": "Delete A Tag" } [/block] To delete an existing tag: * click on the tag-icon to access the list of tags * click on the pencil-icon beside the tag you would like to delete * click on DELETE [block:image] { "images": [ { "image": [ "https://files.readme.io/8e96d1d-Screen_Shot_2017-06-01_at_4.38.26_PM.png", "Screen Shot 2017-06-01 at 4.38.26 PM.png", 476, 594, "#e66f5d" ], "caption": "Delete a tag" } ] } [/block] [block:callout] { "type": "danger", "title": "Affects of tag deletions", "body": "Note that when you delete a tag: \n * the tag will be removed from any messages it was appended to\n * you will lose any analytics and data that existed for this tag\n * the tag will no longer be accessible for anyone on your team" } [/block] [block:api-header] { "title": "Search For Tagged Messages" } [/block] To search for a tag, go to the search bar and type in *tag: <name of tag>*. The search result will be a list of conversations containing messages with that tag. [block:image] { "images": [ { "image": [ "https://files.readme.io/2673ebc-Screen_Shot_2017-06-01_at_2.47.50_PM.png", "Screen Shot 2017-06-01 at 2.47.50 PM.png", 684, 96, "#5d5d5d" ], "caption": "Searching for conversations by tag name." } ] } [/block] [block:api-header] { "title": "Tag Analytics" } [/block] Navigate to *Tools > Analytics*. At the bottom of your Analytics page, you will see analytics for your tags. We will provide data such as the total messages sent/received with a particular tag.