{"action":"created","comment":{"url":"https://api.github.com/repos/workato/docs/pulls/comments/194673806","pull_request_review_id":127887131,"id":194673806,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDE5NDY3MzgwNg==","diff_hunk":"@@ -0,0 +1,58 @@\n+---\n+title: Update Workbot messages\n+date: 2018-05-21 10:23:00 Z\n+---\n+\n+# Updating Workbot messages\n+\n+![Update message example](/assets/images/workbot/workbot-update-message/update-message-example.gif)\n+*Message updating from button, menu, and back to button again*\n+\n+You can update a bot message that was posted earlier by using a post message action. This is especially useful when you want to:\n+- remove buttons or access menus after users have made their selection (to prevent spam), replacing them with meaningful responses\n+\n+  ![Update message example](/assets/images/workbot/workbot-update-message/replace-button-example.gif)\n+  *Buttons removed, replaced with users response and a 'thank you' message*\n+\n+- reduce clutter in bot conversations by 'reusing' the original bot message (by repeatedly updating the original)\n+\n+  ![Reduce clutter](/assets/images/workbot/workbot-update-message/reduce-clutter.gif)\n+\n+## How it works\n+\n+You can instruct Workbot to use the message contents of a **Post message** action to update an existing bot message.\n+\n+Each message posted in Slack has a <kbd>Message ID</kbd>, displayed in the output of Workbot triggers & actions.\n+\n+  >For Workbot triggers, <kbd>Message ID</kbd> only exists when the trigger is invoked by a user interactions in a Workbot message (e.g. button / menu option clicks or dialog submissions). In such a case, the <kbd>Message ID</kbd> would correspond to the bot message containing the interactive component(s).\n+\n+Hence, the <kbd>Message ID</kbd> datapill can be obtained from the output of a **Post command** trigger or a **Post message**  / **Post command reply** action.\n+\n+## Using 'Message to update'\n+\n+To update a message, use its <kbd>Message ID</kbd> in the **Message to update** field of a new **Post message** action. This field can be found under the 'Advanced' section of the action.\n+\n+![Message to update example](/assets/images/workbot/workbot-actions/message-to-update-example.png)\n+\n+The message will be replaced by the new message defined in the **Post message** action, along with any interactive components like buttons or message menus.\n+\n+## Replacing messages containing buttons & message menus\n+To replace messages containing buttons, message menus, or both, simply add an 'unmapped' button or message menu (depending on what you're replacing) in the updating post message action.\n+\n+An 'unmapped' button (or message menu) is one where the **Submit button command** (or **Submit menu option command**) does not match any command triggers of any Workbot recipes in the Workato account. This is because 'unmapped' buttons or message menus are not displayed in messages.\n+\n+![Unmapped button](/assets/images/workbot/workbot-update-message/unmapped-button.png)\n+*Since 'blank' does not trigger any Workbot recipe, no button will be shown in the message*\n+\n+## Common mistakes\n+1. **Updating the wrong message**\n+  To ensure that you're updating the correct message, make sure that you use the <kbd>Message ID</kbd> from the output step which posted the original message.\n+\n+\n+2. **Can't find the 'Message to update' field**\n+  Make sure that it's checked from the 'Add/remove optional fields' list at the bottom of the post message action. After it's enabled, the field can be found in the Advanced group of the post message action.\n+  ![Message to update optional fields](/assets/images/workbot/workbot-update-message/message-to-update-optional-fields.gif)\n+\n+\n+3. <kbd>Message ID</kbd> **pill is empty**\n+  When using a <kbd>Message ID</kbd> pill from the output of a trigger, make sure that the trigger is invoked by a button / menu option click or dialog submission from a bot message (presumably from another recipe). Only triggers that are invoked from interactions with a posted bot message will have a <kbd>Message ID</kbd>.","path":"workbot/workbot-update-message.md","position":58,"original_position":58,"commit_id":"4c68a45a606a8aa3fe8c5044c2aab0fa073b102a","original_commit_id":"4c68a45a606a8aa3fe8c5044c2aab0fa073b102a","user":{"login":"eeshansim","id":10286963,"node_id":"MDQ6VXNlcjEwMjg2OTYz","avatar_url":"https://avatars3.githubusercontent.com/u/10286963?v=4","gravatar_id":"","url":"https://api.github.com/users/eeshansim","html_url":"https://github.com/eeshansim","followers_url":"https://api.github.com/users/eeshansim/followers","following_url":"https://api.github.com/users/eeshansim/following{/other_user}","gists_url":"https://api.github.com/users/eeshansim/gists{/gist_id}","starred_url":"https://api.github.com/users/eeshansim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eeshansim/subscriptions","organizations_url":"https://api.github.com/users/eeshansim/orgs","repos_url":"https://api.github.com/users/eeshansim/repos","events_url":"https://api.github.com/users/eeshansim/events{/privacy}","received_events_url":"https://api.github.com/users/eeshansim/received_events","type":"User","site_admin":false},"body":"Second one is better. Can we keep the phrasing consistent with \"invoke\".\r\n\r\n\"When a user invokes this trigger by typing a command\" vs \"When a user invokes a command\"\r\n\r\nFirst one fits better with \"if the trigger is invoked from a bot command\" IMO","created_at":"2018-06-12T09:34:14Z","updated_at":"2018-06-12T09:34:14Z","html_url":"https://github.com/workato/docs/pull/512#discussion_r194673806","pull_request_url":"https://api.github.com/repos/workato/docs/pulls/512","author_association":"CONTRIBUTOR","_links":{"self":{"href":"https://api.github.com/repos/workato/docs/pulls/comments/194673806"},"html":{"href":"https://github.com/workato/docs/pull/512#discussion_r194673806"},"pull_request":{"href":"https://api.github.com/repos/workato/docs/pulls/512"}},"in_reply_to_id":194656865},"pull_request":{"url":"https://api.github.com/repos/workato/docs/pulls/512","id":193913771,"node_id":"MDExOlB1bGxSZXF1ZXN0MTkzOTEzNzcx","html_url":"https://github.com/workato/docs/pull/512","diff_url":"https://github.com/workato/docs/pull/512.diff","patch_url":"https://github.com/workato/docs/pull/512.patch","issue_url":"https://api.github.com/repos/workato/docs/issues/512","number":512,"state":"open","locked":false,"title":"Workbot update message doc","user":{"login":"jandonyada","id":14304570,"node_id":"MDQ6VXNlcjE0MzA0NTcw","avatar_url":"https://avatars3.githubusercontent.com/u/14304570?v=4","gravatar_id":"","url":"https://api.github.com/users/jandonyada","html_url":"https://github.com/jandonyada","followers_url":"https://api.github.com/users/jandonyada/followers","following_url":"https://api.github.com/users/jandonyada/following{/other_user}","gists_url":"https://api.github.com/users/jandonyada/gists{/gist_id}","starred_url":"https://api.github.com/users/jandonyada/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jandonyada/subscriptions","organizations_url":"https://api.github.com/users/jandonyada/orgs","repos_url":"https://api.github.com/users/jandonyada/repos","events_url":"https://api.github.com/users/jandonyada/events{/privacy}","received_events_url":"https://api.github.com/users/jandonyada/received_events","type":"User","site_admin":false},"body":"","created_at":"2018-06-11T08:55:34Z","updated_at":"2018-06-12T09:34:14Z","closed_at":null,"merged_at":null,"merge_commit_sha":"84482229f7f7438d946964936df5fee818f52e54","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/workato/docs/pulls/512/commits","review_comments_url":"https://api.github.com/repos/workato/docs/pulls/512/comments","review_comment_url":"https://api.github.com/repos/workato/docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/workato/docs/issues/512/comments","statuses_url":"https://api.github.com/repos/workato/docs/statuses/4c68a45a606a8aa3fe8c5044c2aab0fa073b102a","head":{"label":"workato:workbot-update-message-doc","ref":"workbot-update-message-doc","sha":"4c68a45a606a8aa3fe8c5044c2aab0fa073b102a","user":{"login":"workato","id":5629924,"node_id":"MDEyOk9yZ2FuaXphdGlvbjU2Mjk5MjQ=","avatar_url":"https://avatars3.githubusercontent.com/u/5629924?v=4","gravatar_id":"","url":"https://api.github.com/users/workato","html_url":"https://github.com/workato","followers_url":"https://api.github.com/users/workato/followers","following_url":"https://api.github.com/users/workato/following{/other_user}","gists_url":"https://api.github.com/users/workato/gists{/gist_id}","starred_url":"https://api.github.com/users/workato/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/workato/subscriptions","organizations_url":"https://api.github.com/users/workato/orgs","repos_url":"https://api.github.com/users/workato/repos","events_url":"https://api.github.com/users/workato/events{/privacy}","received_events_url":"https://api.github.com/users/workato/received_events","type":"Organization","site_admin":false},"repo":{"id":82145434,"node_id":"MDEwOlJlcG9zaXRvcnk4MjE0NTQzNA==","name":"docs","full_name":"workato/docs","owner":{"login":"workato","id":5629924,"node_id":"MDEyOk9yZ2FuaXphdGlvbjU2Mjk5MjQ=","avatar_url":"https://avatars3.githubusercontent.com/u/5629924?v=4","gravatar_id":"","url":"https://api.github.com/users/workato","html_url":"https://github.com/workato","followers_url":"https://api.github.com/users/workato/followers","following_url":"https://api.github.com/users/workato/following{/other_user}","gists_url":"https://api.github.com/users/workato/gists{/gist_id}","starred_url":"https://api.github.com/users/workato/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/workato/subscriptions","organizations_url":"https://api.github.com/users/workato/orgs","repos_url":"https://api.github.com/users/workato/repos","events_url":"https://api.github.com/users/workato/events{/privacy}","received_events_url":"https://api.github.com/users/workato/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/workato/docs","description":null,"fork":false,"url":"https://api.github.com/repos/workato/docs","forks_url":"https://api.github.com/repos/workato/docs/forks","keys_url":"https://api.github.com/repos/workato/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/workato/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/workato/docs/teams","hooks_url":"https://api.github.com/repos/workato/docs/hooks","issue_events_url":"https://api.github.com/repos/workato/docs/issues/events{/number}","events_url":"https://api.github.com/repos/workato/docs/events","assignees_url":"https://api.github.com/repos/workato/docs/assignees{/user}","branches_url":"https://api.github.com/repos/workato/docs/branches{/branch}","tags_url":"https://api.github.com/repos/workato/docs/tags","blobs_url":"https://api.github.com/repos/workato/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/workato/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/workato/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/workato/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/workato/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/workato/docs/languages","stargazers_url":"https://api.github.com/repos/workato/docs/stargazers","contributors_url":"https://api.github.com/repos/workato/docs/contributors","subscribers_url":"https://api.github.com/repos/workato/docs/subscribers","subscription_url":"https://api.github.com/repos/workato/docs/subscription","commits_url":"https://api.github.com/repos/workato/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/workato/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/workato/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/workato/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/workato/docs/contents/{+path}","compare_url":"https://api.github.com/repos/workato/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/workato/docs/merges","archive_url":"https://api.github.com/repos/workato/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/workato/docs/downloads","issues_url":"https://api.github.com/repos/workato/docs/issues{/number}","pulls_url":"https://api.github.com/repos/workato/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/workato/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/workato/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/workato/docs/labels{/name}","releases_url":"https://api.github.com/repos/workato/docs/releases{/id}","deployments_url":"https://api.github.com/repos/workato/docs/deployments","created_at":"2017-02-16T06:04:38Z","updated_at":"2018-06-11T07:39:52Z","pushed_at":"2018-06-12T02:35:08Z","git_url":"git://github.com/workato/docs.git","ssh_url":"git@github.com:workato/docs.git","clone_url":"https://github.com/workato/docs.git","svn_url":"https://github.com/workato/docs","homepage":null,"size":345453,"stargazers_count":2,"watchers_count":2,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":10,"mirror_url":null,"archived":false,"open_issues_count":139,"license":null,"forks":10,"open_issues":139,"watchers":2,"default_branch":"master"}},"base":{"label":"workato:master","ref":"master","sha":"eec30610ecc5289f45e4a3913719b0a78f751b8d","user":{"login":"workato","id":5629924,"node_id":"MDEyOk9yZ2FuaXphdGlvbjU2Mjk5MjQ=","avatar_url":"https://avatars3.githubusercontent.com/u/5629924?v=4","gravatar_id":"","url":"https://api.github.com/users/workato","html_url":"https://github.com/workato","followers_url":"https://api.github.com/users/workato/followers","following_url":"https://api.github.com/users/workato/following{/other_user}","gists_url":"https://api.github.com/users/workato/gists{/gist_id}","starred_url":"https://api.github.com/users/workato/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/workato/subscriptions","organizations_url":"https://api.github.com/users/workato/orgs","repos_url":"https://api.github.com/users/workato/repos","events_url":"https://api.github.com/users/workato/events{/privacy}","received_events_url":"https://api.github.com/users/workato/received_events","type":"Organization","site_admin":false},"repo":{"id":82145434,"node_id":"MDEwOlJlcG9zaXRvcnk4MjE0NTQzNA==","name":"docs","full_name":"workato/docs","owner":{"login":"workato","id":5629924,"node_id":"MDEyOk9yZ2FuaXphdGlvbjU2Mjk5MjQ=","avatar_url":"https://avatars3.githubusercontent.com/u/5629924?v=4","gravatar_id":"","url":"https://api.github.com/users/workato","html_url":"https://github.com/workato","followers_url":"https://api.github.com/users/workato/followers","following_url":"https://api.github.com/users/workato/following{/other_user}","gists_url":"https://api.github.com/users/workato/gists{/gist_id}","starred_url":"https://api.github.com/users/workato/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/workato/subscriptions","organizations_url":"https://api.github.com/users/workato/orgs","repos_url":"https://api.github.com/users/workato/repos","events_url":"https://api.github.com/users/workato/events{/privacy}","received_events_url":"https://api.github.com/users/workato/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/workato/docs","description":null,"fork":false,"url":"https://api.github.com/repos/workato/docs","forks_url":"https://api.github.com/repos/workato/docs/forks","keys_url":"https://api.github.com/repos/workato/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/workato/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/workato/docs/teams","hooks_url":"https://api.github.com/repos/workato/docs/hooks","issue_events_url":"https://api.github.com/repos/workato/docs/issues/events{/number}","events_url":"https://api.github.com/repos/workato/docs/events","assignees_url":"https://api.github.com/repos/workato/docs/assignees{/user}","branches_url":"https://api.github.com/repos/workato/docs/branches{/branch}","tags_url":"https://api.github.com/repos/workato/docs/tags","blobs_url":"https://api.github.com/repos/workato/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/workato/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/workato/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/workato/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/workato/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/workato/docs/languages","stargazers_url":"https://api.github.com/repos/workato/docs/stargazers","contributors_url":"https://api.github.com/repos/workato/docs/contributors","subscribers_url":"https://api.github.com/repos/workato/docs/subscribers","subscription_url":"https://api.github.com/repos/workato/docs/subscription","commits_url":"https://api.github.com/repos/workato/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/workato/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/workato/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/workato/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/workato/docs/contents/{+path}","compare_url":"https://api.github.com/repos/workato/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/workato/docs/merges","archive_url":"https://api.github.com/repos/workato/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/workato/docs/downloads","issues_url":"https://api.github.com/repos/workato/docs/issues{/number}","pulls_url":"https://api.github.com/repos/workato/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/workato/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/workato/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/workato/docs/labels{/name}","releases_url":"https://api.github.com/repos/workato/docs/releases{/id}","deployments_url":"https://api.github.com/repos/workato/docs/deployments","created_at":"2017-02-16T06:04:38Z","updated_at":"2018-06-11T07:39:52Z","pushed_at":"2018-06-12T02:35:08Z","git_url":"git://github.com/workato/docs.git","ssh_url":"git@github.com:workato/docs.git","clone_url":"https://github.com/workato/docs.git","svn_url":"https://github.com/workato/docs","homepage":null,"size":345453,"stargazers_count":2,"watchers_count":2,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":10,"mirror_url":null,"archived":false,"open_issues_count":139,"license":null,"forks":10,"open_issues":139,"watchers":2,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/workato/docs/pulls/512"},"html":{"href":"https://github.com/workato/docs/pull/512"},"issue":{"href":"https://api.github.com/repos/workato/docs/issues/512"},"comments":{"href":"https://api.github.com/repos/workato/docs/issues/512/comments"},"review_comments":{"href":"https://api.github.com/repos/workato/docs/pulls/512/comments"},"review_comment":{"href":"https://api.github.com/repos/workato/docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/workato/docs/pulls/512/commits"},"statuses":{"href":"https://api.github.com/repos/workato/docs/statuses/4c68a45a606a8aa3fe8c5044c2aab0fa073b102a"}},"author_association":"CONTRIBUTOR"}}
{"actor":{"display_login":"eeshansim"}}