Google Chat: Space, Create Message<\/div>
Posts a message in a Google Chat Space. Bold decoration (with asterisks) and Inline-code decoration (with backticks) are also applied as they are. It is also possible to attach some Process Data in card format.<\/div><\/div>\n\n\n
<\/span>Configs<\/div>
\n
- \n
- <\/i><\/span> A1: Set INCOMING WEBHOOK Url (at Menu “Manage Webhook”) *<\/span>#{EL}<\/sup><\/span><\/li>\n
- <\/i><\/span> B1: Set Body of Message#{EL}<\/sup><\/span><\/li>\n
- <\/i><\/span> B2: If to post Data, Set Field Names in each line (eg “q_corp”)#{EL}<\/sup><\/span><\/li>\n
- <\/i><\/span> B3: If to display footer link, Set ${var[applicationRoot]}#{EL}<\/sup><\/span><\/li>\n
- C1: Select STRING DATA that stores Message Name (update)<\/li>\n
- C2: Select STRING DATA that stores Space Name (update)<\/li>\n<\/ul>\n<\/div><\/div>\n\n\n
<\/span>Script (click to open)<\/div>\n\n\n\n\/\/ GraalJS Script (engine type: 2)\n\n\/\/\/\/\/\/\/\/ START "main()" \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\n\nmain();\nfunction main(){ \n\n\/\/\/\/ == Config Retrieving \/ \u5de5\u7a0b\u30b3\u30f3\u30d5\u30a3\u30b0\u306e\u53c2\u7167 ==\nconst strWebhookUrl = configs.get ( "StrConfA1" ); \/\/\/ REQUIRED\n if( strWebhookUrl === "" ){\n throw new Error( "\\n AutomatedTask ConfigError:" +\n " Config {A1: WebhookUrl} is empty \\n" );\n }\nconst strBodyOfMessage = configs.get ( "StrConfB1" ); \/\/ NotRequired\nconst strFieldNames = configs.get ( "StrConfB2" ); \/\/ NotRequired\nconst strApplicationRoot = configs.get ( "StrConfB3" ); \/\/ NotRequired\nconst strPocketMessageName = configs.getObject( "SelectConfC1" ); \/\/ NotRequired\nconst strPocketSpaceName = configs.getObject( "SelectConfC2" ); \/\/ NotRequired\n if( strBodyOfMessage === "" && strFieldNames === "" ){\n throw new Error( "\\n AutomatedTask ConfigError:" +\n " Both Config {B1:Message} and {B2:FieldNames} are empty \\n" );\n }\n\n\/\/\/\/ == Data Retrieving \/ \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u30c7\u30fc\u30bf\u306e\u53c2\u7167 ==\n\/\/ (Nothing. Retrieved via Expression Language in Config Retrieving)\n\n\n\/\/\/\/ == Calculating \/ \u6f14\u7b97 ==\n\/\/\/\/ get property\nconst strProcessInstanceId = processInstance.getProcessInstanceId() + "";\nconst strProcessInstanceTitle = processInstance.getProcessInstanceTitle() + "";\nconst strWorkflowAppName = processInstance.getProcessModelInfoName() + "";\nconst strWorkflowAppId = processInstance.getProcessModelInfoId() + "";\n\n\/\/\/\/ prepare for access to "Google Chat Bot"\n\/\/\/ Google Workspace for Developers > Google Chat for Developers\n\/\/\/ > Integrate any tool, service, or resource with Google Chat bots\n\/\/\/ > Send asychronous messages with incoming webhooks\n\/\/\/ https:\/\/developers.google.com\/chat\/how-tos\/webhooks\n\/\/\/ \n\/\/\/ NOT "Google Chat API"\n\/\/\/ "Get programmatic access to events, messages, spaces, and attachments"\n\/\/\/ Reference > REST Resources > spaces.messages > create\n\/\/\/ https:\/\/developers.google.com\/chat\/api\/reference\/rest\/v1\/spaces.messages\/create\n\n\/\/ Message\nlet request1Obj = {};\n\n\/\/ Simple text message\n\/\/ https:\/\/developers.google.com\/chat\/api\/guides\/message-formats\/basic\n request1Obj.text = strBodyOfMessage;\n\n\/\/ Card message\n\/\/ https:\/\/developers.google.com\/chat\/api\/guides\/message-formats\/cards\n\/\/ https:\/\/developers.google.com\/chat\/api\/guides\/message-formats\/cards#card_text_formatting\n\nif( strFieldNames !== "" || strApplicationRoot !== "" ){\n request1Obj.cards = []; \/\/ ___ ___ prepare Cards array ___ ___\n request1Obj.cards[0] = {};\n request1Obj.cards[0].sections = []; \/\/ ___ prepare Sections array ___\n\n let objTitleSection = {}; \/\/ ### Title Section\n objTitleSection.widgets = []; \/\/ ___ prepare Widgets array ___\n objTitleSection.widgets[0] = {};\n objTitleSection.widgets[0].textParagraph = {};\n objTitleSection.widgets[0].textParagraph.text = strApplicationRoot ?\n \/\/ clickable link to WorkflowApp Info\n `<font color="#57C400"><i>p${strProcessInstanceId}<\/i><\/font><br>` +\n `<font color="#009900"><b>` + escaper.escapeHtml(strProcessInstanceTitle) + `<\/b><\/font><br> ` +\n `<a href=${strApplicationRoot}OR\/ProcessModel\/view?processModelInfoId=${strWorkflowAppId}>` +\n escaper.escapeHtml(strWorkflowAppName) + `<\/a>` :\n \/\/ No link\n `<font color="#57C400"><i>p${strProcessInstanceId}<\/i><\/font><br>` +\n `<font color="#009900"><b>` + escaper.escapeHtml(strProcessInstanceTitle) +\n `<\/b><\/font><br> ` + escaper.escapeHtml(strWorkflowAppName);\n request1Obj.cards[0].sections.push( objTitleSection ); \/\/ push TitleSection to Cards[0].Sections ###\n\n if( strFieldNames !== "" ){\n const arrFieldNames = strFieldNames.split("\\n");\n for( let i = 0; i < arrFieldNames.length; i++ ){\n if( arrFieldNames[i] === "" ){ continue; }\n let objDataSection = {}; \/\/ ### Data Section\n objDataSection.widgets = []; \/\/ ___ prepare Widgets array ___\n let objKeyValueWidget = {}; \/\/ ### KeyValue Widget\n objKeyValueWidget.keyValue = {};\n let qPocket = engine.findDataDefinitionByVarName( arrFieldNames[i] );\n \/\/ refer Process Data\n if( qPocket === null ){\n engine.log( " AutomatedTask RuntimeWarning: " +\n " {B2: FieldName} contains illegal name: " + arrFieldNames[i] );\n continue;\n }else if( qPocket.matchDataType( "STRING_TEXTFIELD" ) ){ \n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n escaper.escapeHtml(engine.findData(qPocket)) : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "false";\n \/\/ "topLabel" "bottomLabel" Subset_of_HTML_Tags not supported\n }else if( qPocket.matchDataType( "STRING_TEXTAREA" ) ){\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n escaper.escapeHtml(engine.findData(qPocket)) : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "true";\n }else if( qPocket.matchDataType( "DECIMAL" ) ){\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n (engine.findData(qPocket) + "") : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "false";\n }else if( qPocket.matchDataType( "SELECT" ) ){\n let qSelected = engine.findData(qPocket);\n let numOfSelected = qSelected.size() - 0;\n let strSelected = "";\n for( let j = 0; j < numOfSelected; j++ ){\n strSelected += escaper.escapeHtml(qSelected.get(j).getDisplay());\n if( j !== numOfSelected - 1 ){ strSelected += "<br>";}\n }\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n strSelected : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "true";\n }else if( qPocket.matchDataType( "DATE" ) ){\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n (engine.findData(qPocket).toString()) : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "false";\n }else if( qPocket.matchDataType( "DATETIME" ) ){\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n (engine.findData(qPocket).toString()) : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "false";\n }else if( qPocket.matchDataType( "FILE" ) ){\n let qFiles = engine.findData(qPocket);\n let numOfFiles = qFiles.size() - 0;\n let strFiles = "";\n for( let j = 0; j < numOfFiles; j++ ){\n strFiles += escaper.escapeHtml(qFiles.get(j).getName());\n if( j !== numOfFiles - 1 ){ strFiles += "<br>";}\n }\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n strFiles : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "true";\n }else if( qPocket.matchDataType( "QUSER" ) ){\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n escaper.escapeHtml(engine.findData(qPocket).getName()) : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "false";\n }else if( qPocket.matchDataType( "QGROUP" ) ){\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n escaper.escapeHtml(engine.findData(qPocket).getName()) : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "false";\n }else if( qPocket.matchDataType( "LIST" ) ){\n objKeyValueWidget.keyValue.topLabel = qPocket.getName();\n objKeyValueWidget.keyValue.content = engine.findData(qPocket) ?\n (`<i><font color="#aaaaaa">` + engine.findData(qPocket).size() + ` rows<\/font><\/i>`) : `<i><font color="#aaaaaa">null<\/font><\/i>`;\n objKeyValueWidget.keyValue.contentMultiline = "false";\n }else if( qPocket.matchDataType( "DISCUSSION" ) ){\n engine.log( " AutomatedTask RuntimeWarning: " +\n " {B2: FieldName} contains DISCUSSION type (skipped): " + arrFieldNames[i] );\n continue;\n }else{\n engine.log( " AutomatedTask RuntimeWarning: " +\n " {B2: FieldName} contains unsupported type (skipped): " + arrFieldNames[i] );\n continue;\n }\n objDataSection.widgets.push( objKeyValueWidget ); \/\/ push Widget to DataSection ###\n request1Obj.cards[0].sections.push( objDataSection ); \/\/ push DataSection to Cards[0].Sections ###\n }\n }\n\n if( strApplicationRoot !== "" ){\n let objFooterSection = {}; \/\/ ### Footer Section\n objFooterSection.widgets = [];\n\n let objTextButtonWidget = {}; \/\/ ### Button Widget\n objTextButtonWidget.buttons = [];\n objTextButtonWidget.buttons[0] = {};\n objTextButtonWidget.buttons[0].textButton = {};\n objTextButtonWidget.buttons[0].textButton.text = "Desktop View";\n objTextButtonWidget.buttons[0].textButton.onClick = {};\n objTextButtonWidget.buttons[0].textButton.onClick.openLink = {};\n objTextButtonWidget.buttons[0].textButton.onClick.openLink.url =\n `${strApplicationRoot}PE\/Workitem\/list?processInstanceId=${strProcessInstanceId}`;\n objTextButtonWidget.buttons[1] = {};\n objTextButtonWidget.buttons[1].textButton = {};\n objTextButtonWidget.buttons[1].textButton.text = "Mobile View";\n objTextButtonWidget.buttons[1].textButton.onClick = {};\n objTextButtonWidget.buttons[1].textButton.onClick.openLink = {};\n objTextButtonWidget.buttons[1].textButton.onClick.openLink.url =\n `${strApplicationRoot}SP\/PE\/ProcessInstance\/view?processInstanceId=${strProcessInstanceId}`;\n objFooterSection.widgets.push( objTextButtonWidget ); \/\/ push Widget to FooterSection ###\n\n request1Obj.cards[0].sections.push( objFooterSection ); \/\/ push FooterSection to Cards[0].Sections ###\n }\n}\n\/\/ engine.log( JSON.stringify( request1Obj ) ); \/\/ for debug\n\n\/\/\/ access to "Google Chat Bot"\nlet request1Uri = strWebhookUrl;\nlet request1 = httpClient.begin(); \/\/ HttpRequestWrapper\n request1 = request1.body( JSON.stringify( request1Obj ), "application\/json" );\n\/\/ request1, try\nconst response1 = request1.post( request1Uri ); \/\/ HttpResponseWrapper\nconst arrRequest1Uri = request1Uri.split('?'); \/\/ "key" will not be loged\nengine.log( " AutomatedTask ApiRequest1 Start: " + arrRequest1Uri[0] );\nconst response1Code = response1.getStatusCode() + "";\nconst response1Body = response1.getResponseAsString() + "";\nengine.log( " AutomatedTask ApiResponse Status: " + response1Code );\nif( response1Code !== "200"){\n throw new Error( "\\n AutomatedTask UnexpectedResponseError: " +\n response1Code + "\\n" + response1Body + "\\n" );\n}\n\/\/ response1, parse\n\/* \nengine.log( response1Body ); \/\/ for debug\n{\n "name": "spaces\/AAAA4xxxxx4\/messages\/EdtRhyyyyy4.EdtRhyyyyy4",\n "sender": {\n "name": "users\/114029999953014888889",\n "displayName": "TestWebhook",\n "avatarUrl": "",\n "email": "",\n "domainId": "",\n "type": "BOT",\n "isAnonymous": false\n },\n "text": "test\\n*bold text*\\n`backquotes`",\n "cards": [],\n "previewText": "",\n "annotations": [],\n "thread": {\n "name": "spaces\/AAAA4xxxxx4\/threads\/EdtRhyyyyy4"\n },\n "space": {\n "name": "spaces\/AAAA4xxxxx4",\n "type": "ROOM",\n "singleUserBotDm": false,\n "threaded": true,\n "displayName": "TestSpace",\n "legacyGroupChat": false\n },\n "fallbackText": "",\n "argumentText": "test\\n*bold text*\\n`backquotes`",\n "attachment": [],\n "createTime": "2022-03-08T07:33:33.109455Z",\n "lastUpdateTime": "2022-03-08T07:33:33.109455Z"\n}\n*\/\nconst response1Obj = JSON.parse( response1Body );\nconst strMessageName = response1Obj.name;\nconst strSpaceName = response1Obj.space.name;\n\n\n\/\/\/\/ == Data Updating \/ \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u30c7\u30fc\u30bf\u3078\u306e\u4ee3\u5165 ==\nif( strPocketMessageName !== null ){\n engine.setData( strPocketMessageName, strMessageName );\n \/\/ Example: spaces\/AAAAAAAAAAA\/messages\/BBBBBBBBBBB.BBBBBBBBBBB\n}\nif( strPocketSpaceName !== null ){\n engine.setData( strPocketSpaceName, strSpaceName );\n \/\/ Example: spaces\/AAAAAAAAAAA\n}\n\n\n} \/\/\/\/\/\/\/\/ END "main()" \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\n\n\n\/*\nNotes:\n- Integrates between the Workflow App and the Google Chat Space.\n - When the process reaches this automated task, a message is automatically posted to Google Chat.\n - Also be used as a means of sharing business data with "non-users" of the workflow platform.\n - The automated task posts an arbitrary string of text (message body).\n - It is also possible to attach a Card with the business data stored in the process.\n- Can be used for various timeline chatting.\n - Automatically report "Order information" to SPACE for management team.\n - Automatically report "Business progress" to SPACE for communication with customers.\n- The Incoming Webhook function of Google Chat is used.\n - The application administrator only needs to set the "Webhook URL" for the automatic process.\n - "Webhook URL" is obtained from the "Manage Webhook" menu of the relevant "Space".\n - e.g: `https:\/\/chat.googleapis.com\/v1\/spaces\/AAAA4xxxxx4\/messages?key=AIzaSxxxxxhCZtEyyyyyMm-WEzzzzzPzqKqqsHI&token=UMlLOxxxxxw2JgtyyyyyWLqMizzzzzSiPnBxxxxxENI%3D`\nAPPENDIX\n- This automated task communicates via the "Incoming Webhook" of Bot. (Asynchronous Messages)\n - No user authentication or user authorization (OAuth2 settings, etc.) configuration is required.\n - https:\/\/developers.google.com\/chat\/how-tos\/webhooks\n - Communication is done by a different mechanism from "Google Chat API".\n - https:\/\/developers.google.com\/chat\/api\/reference\/rest\/v1\/spaces.messages\/create\n- Google Chat "Spaces" were previously called "Rooms" (2021-09)\n - This automated task assumes a "Space" created in your Google Workspace account.\n - Unlike Group Messages, Spaces can add or remove users at any time.\n - Unlike Group Messages, Spaces also allow you to talk to people outside of your organization.\n - Invited external users can join from "Browse Spaces".\n - https:\/\/support.google.com\/chat\/answer\/7653963\n- Message body\n - Posted body messages are sent in plain text.\n - However, decorations such as Bold (with asterisks) and Code (with backquotes) are also possible.\n - https:\/\/developers.google.com\/chat\/api\/guides\/message-formats\/basic\n- Process Data\n - If the app manager specifies a "field name" for the automatic process, the case data will also be posted.\n - A simple Card is additionally displayed at the bottom of the "Message Body".\n - A Process Title is automatically added to the header of the Card.\n - This is useful for sharing information with people who do not have an account on the workflow platform (non-users).\n\nNotes-ja:\n- \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u30a2\u30d7\u30ea\u3068Google\u30c1\u30e3\u30c3\u30c8 Space \u306e\u30c7\u30fc\u30bf\u9023\u643a\u3092\u5b9f\u73fe\u3057\u307e\u3059\u3002\n - \u6848\u4ef6\u304c\u3053\u306e\u81ea\u52d5\u5de5\u7a0b\u306b\u5230\u9054\u3057\u305f\u969b\u3001Google\u30c1\u30e3\u30c3\u30c8\u306b\u5bfe\u3057\u3066\u81ea\u52d5\u7684\u306b\u6295\u7a3f\u3057\u307e\u3059\u3002\n - \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u57fa\u76e4\u306e\u300c\u975e\u30e6\u30fc\u30b6\u300d\u3068\u696d\u52d9\u30c7\u30fc\u30bf\u3092\u5171\u6709\u3059\u308b\u624b\u6bb5\u3068\u3057\u3066\u3082\u5229\u7528\u3067\u304d\u307e\u3059\u3002\n - \u81ea\u52d5\u5de5\u7a0b\u306f\u3001\u4efb\u610f\u306e\u6587\u5b57\u5217\uff08\u30e1\u30c3\u30bb\u30fc\u30b8\u672c\u6587\uff09\u3092\u6295\u7a3f\u3057\u307e\u3059\u3002\n - \u6848\u4ef6\u5185\u306b\u683c\u7d0d\u3055\u308c\u3066\u3044\u308b\u6848\u4ef6\u30c7\u30fc\u30bf\u3092Card\u6dfb\u4ed8\u3059\u308b\u3053\u3068\u3082\u53ef\u80fd\u3067\u3059\u3002\n- \u69d8\u3005\u30bf\u30a4\u30e0\u30e9\u30a4\u30f3\u30fb\u30b3\u30df\u30e5\u30cb\u30b1\u30fc\u30b7\u30e7\u30f3\u306b\u5229\u7528\u3067\u304d\u307e\u3059\u3002\n - \u30de\u30cd\u30fc\u30b8\u30e1\u30f3\u30c8\u30c1\u30fc\u30e0\u7528Space\u306b\u300c\u53d7\u6ce8\u60c5\u5831\u300d\u3092\u81ea\u52d5\u5831\u544a\u3059\u308b\n - \u9867\u5ba2\u3068\u306e\u30b3\u30df\u30e5\u30cb\u30b1\u30fc\u30b7\u30e7\u30f3\u7528\u306eSpace\u3067\u300c\u696d\u52d9\u9032\u6357\u300d\u3092\u81ea\u52d5\u5831\u544a\u3059\u308b\n- Google\u30c1\u30e3\u30c3\u30c8\u306eWebhook\u6a5f\u80fd\uff08\u7740\u4fe1Webhook\uff09\u304c\u5229\u7528\u3055\u308c\u307e\u3059\u3002\n - \u30a2\u30d7\u30ea\u7ba1\u7406\u8005\u306f\u3001\u81ea\u52d5\u5de5\u7a0b\u306b "Webhook URL" \u3092\u30bb\u30c3\u30c8\u3059\u308b\u3060\u3051\u3067\u5229\u7528\u3067\u304d\u307e\u3059\u3002\n - "Webhook URL" \u306f\u3001\u5f53\u8a72\u300c\u30b9\u30da\u30fc\u30b9\u300d\u306e\u300cWebhook \u3092\u7ba1\u7406\u300d\u30e1\u30cb\u30e5\u30fc\u304b\u3089\u53d6\u5f97\u3057\u307e\u3059\u3002\n - \u4f8b: `https:\/\/chat.googleapis.com\/v1\/spaces\/AAAA4xxxxx4\/messages?key=AIzaSxxxxxhCZtEyyyyyMm-WEzzzzzPzqKqqsHI&token=UMlLOxxxxxw2JgtyyyyyWLqMizzzzzSiPnBxxxxxENI%3D`\nAPPENDIX-ja\n- \u3053\u306e\u81ea\u52d5\u5de5\u7a0b\u3067\u306f\u3001Bot \u306e\u300c\u7740\u4fe1Webhook\u300d\u3092\u4ecb\u3057\u3066\u901a\u4fe1\u3055\u308c\u307e\u3059\u3002\uff08\u975e\u540c\u671f\u30e1\u30c3\u30bb\u30fc\u30b8\uff09\n - \u30e6\u30fc\u30b6\u8a8d\u8a3c\u3084\u30e6\u30fc\u30b6\u8a8d\u53ef\uff08OAuth2\u8a2d\u5b9a\u7b49\uff09\u306e\u8a2d\u5b9a\u306f\u5fc5\u8981\u3042\u308a\u307e\u305b\u3093\u3002\n - https:\/\/developers.google.com\/chat\/how-tos\/webhooks\n - "Google Chat API" \u3068\u306f\u7570\u306a\u308b\u4ed5\u7d44\u307f\u3067\u901a\u4fe1\u3055\u308c\u307e\u3059\u3002\n - https:\/\/developers.google.com\/chat\/api\/reference\/rest\/v1\/spaces.messages\/create\n- Google\u30c1\u30e3\u30c3\u30c8\u306e\u300c\u30b9\u30da\u30fc\u30b9\u300d\u306f\u3001\u4ee5\u524d\u306f\u300c\u30c1\u30e3\u30c3\u30c8\u30eb\u30fc\u30e0\u300d\u3068\u547c\u79f0\u3055\u308c\u3066\u3044\u307e\u3057\u305f\uff08\uff5e2021-09\uff09\n - \u3053\u306e\u81ea\u52d5\u5de5\u7a0b\u306f\u3001Google Workspace \u30a2\u30ab\u30a6\u30f3\u30c8\u3067\u4f5c\u6210\u3055\u308c\u305f\u300c\u30b9\u30da\u30fc\u30b9\u300d\u3092\u524d\u63d0\u3068\u3057\u3066\u3044\u307e\u3059\u3002\n - \u300c\u30b9\u30da\u30fc\u30b9\u300d\u306f\u3001\u300c\u30b0\u30eb\u30fc\u30d7 \u30e1\u30c3\u30bb\u30fc\u30b8\u300d\u3068\u7570\u306a\u308a\u3001\u3044\u3064\u3067\u3082\u30e6\u30fc\u30b6\u8ffd\u52a0\u524a\u9664\u304c\u53ef\u80fd\u3067\u3059\u3002\n - \u300c\u30b9\u30da\u30fc\u30b9\u300d\u306f\u3001\u300c\u30b0\u30eb\u30fc\u30d7 \u30e1\u30c3\u30bb\u30fc\u30b8\u300d\u3068\u7570\u306a\u308a\u3001\u793e\u5916\u30e6\u30fc\u30b6\u3068\u306e\u4f1a\u8a71\u3082\u53ef\u80fd\u3067\u3059\u3002\n - \u62db\u5f85\u3055\u308c\u305f\u793e\u5916\u30e6\u30fc\u30b6\u306f\u300c\u30b9\u30da\u30fc\u30b9\u3092\u30d6\u30e9\u30a6\u30b8\u30f3\u30b0\u300d\u304b\u3089\u53c2\u52a0\u3057\u307e\u3059\u3002\n - https:\/\/support.google.com\/chat\/answer\/7653963\n- \u30e1\u30c3\u30bb\u30fc\u30b8\u672c\u6587\n - \u6295\u7a3f\u3055\u308c\u308b\u672c\u6587\u30e1\u30c3\u30bb\u30fc\u30b8\u306f\u30d7\u30ec\u30fc\u30f3\u30c6\u30ad\u30b9\u30c8\u3067\u9001\u4fe1\u3055\u308c\u307e\u3059\u3002\n - \u305f\u3060\u3057\u3001\u592a\u5b57\uff08\u30a2\u30b9\u30bf\u30ea\u30b9\u30af\u56f2\u307f\uff09\u3084Code\uff08\u30d0\u30c3\u30af\u30af\u30aa\u30fc\u30c8\u56f2\u307f\uff09\u3068\u3044\u3063\u305f\u88c5\u98fe\u3082\u53ef\u80fd\u3067\u3059\u3002\n - https:\/\/developers.google.com\/chat\/api\/guides\/message-formats\/basic\n- \u6848\u4ef6\u30c7\u30fc\u30bf\n - \u30a2\u30d7\u30ea\u7ba1\u7406\u8005\u304c\u3001\u81ea\u52d5\u5de5\u7a0b\u306b "\u30d5\u30a3\u30fc\u30eb\u30c9\u540d" \u3092\u6307\u5b9a\u3057\u305f\u5834\u5408\u3001\u6848\u4ef6\u30c7\u30fc\u30bf\u3082\u6295\u7a3f\u3055\u308c\u307e\u3059\u3002\n - \u30b7\u30f3\u30d7\u30eb\u306a Card \u304c\u300c\u30e1\u30c3\u30bb\u30fc\u30b8\u672c\u6587\u300d\u306e\u4e0b\u90e8\u306b\u8ffd\u52a0\u8868\u793a\u3055\u308c\u307e\u3059\u3002\n - Card \u306e\u30d8\u30c3\u30c0\u30fc\u90e8\u306b\u306f\u3001\u6848\u4ef6\u30bf\u30a4\u30c8\u30eb\u304c\u81ea\u52d5\u7684\u306b\u8ffd\u52a0\u3055\u308c\u307e\u3059\u3002\n - \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u57fa\u76e4\u306b\u30a2\u30ab\u30a6\u30f3\u30c8\u3092\u6301\u305f\u306a\u3044\u4eba\uff08\u975e\u30e6\u30fc\u30b6\uff09\u3068\u306e\u60c5\u5831\u5171\u6709\u306b\u4fbf\u5229\u3067\u3059\u3002\n*\/\n\n<\/code><\/pre><\/div>\n\n\n<\/div><\/div>\n\n\n\n<\/a><\/figure>\n\n\n\n
<\/i> Download<\/h3>\n\n\n\n
- \n
- google-chat-space-create-message-2022.xml<\/a><\/li>\n\n\n\n
- google-chat-space-create-message-2023.xml<\/a>\n
- \n
- 2023-08-21 (C) Questetra, Inc. (MIT License)<\/li>\n\n\n\n
- for “GraalJS standard (engine-type 3)” on v15.0 or above<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
2021-03-11 (C) Questetra, Inc. (MIT License)
https:\/\/support.questetra.com\/addons\/google-chat-space-create-message-2022\/<\/a>
<\/i> The Add-on import feature is available with Professional<\/strong><\/span> edition.
Freely modifiable JavaScript (ECMAScript) code. No warranty of any kind.<\/p>\n\n\n<\/div>\n\n\n\n<\/i> Notes<\/h3>\n\n\n\n
- \n
- Integrates between the Workflow App and the Google Chat Space.\n
- \n
- When the process reaches this automated task, a message is automatically posted to Google Chat.<\/li>\n\n\n\n
- Also can be used as a means of sharing business data with non-users of the workflow platform.<\/li>\n\n\n\n
- The automated task posts an arbitrary string of text (message body).<\/li>\n\n\n\n
- It is also possible to attach a Card with the business data stored in the process.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Can be used for a variety of timeline communications.\n
- \n
- Automatical reporting of order information to a Space for the management team.<\/li>\n\n\n\n
- Automatical reporting of business progress to a Space for communication with customers.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- The Incoming Webhook function of Google Chat is used.\n
- \n
- The application administrator only needs to set the Webhook URL for the automatic process.<\/li>\n\n\n\n
- The Webhook URL is obtained from the “Manage Webhook” menu of the relevant Space.<\/li>\n\n\n\n
- e.g:
https:\/\/chat.googleapis.com\/v1\/spaces\/AAAA4xxxxx4\/messages?key=AIzaSxxxxxhCZtEyyyyyMm-WEzzzzzPzqKqqsHI&token=UMlLOxxxxxw2JgtyyyyyWLqMizzzzzSiPnBxxxxxENI%3D<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n- If the phone number has been posted, you can click to call from your smartphone Gmail app.<\/li>\n<\/ul>\n\n\n\n
<\/i> Capture<\/h3>\n\n\n\n
![\"Posts](\"https:\/\/i0.wp.com\/support.questetra.com\/wp-content\/uploads\/2022\/03\/google-chat-space-create-message-2022-capture-en.png?resize=1200%2C675&ssl=1\")
<\/a><\/figure>\n\n\n\n![\"\"](\"https:\/\/i0.wp.com\/support.questetra.com\/wp-content\/uploads\/2022\/03\/google-chat-space-create-message-2022-config-en-851x630.png?resize=851%2C630&ssl=1\")
<\/a><\/figure>\n\n\n\n![\"\"](\"https:\/\/i0.wp.com\/support.questetra.com\/wp-content\/uploads\/2022\/03\/google-chat-space-create-message-2022-prepare.png?resize=882%2C354&ssl=1\")
<\/figure>\n\n\n\n<\/i> Appendix<\/h3>\n\n\n\n
- \n
- This automated task communicates via the bot’s Incoming Webhook (asynchronous messages).\n
- \n
- No user authentication or user authorization configuration is required (OAuth2 settings, etc.).<\/li>\n\n\n\n
- https:\/\/developers.google.com\/chat\/how-tos\/webhooks<\/a><\/li>\n\n\n\n
- The communication mechanism is different from Google Chat API.\n
- \n
- https:\/\/developers.google.com\/chat\/api\/reference\/rest\/v1\/spaces.messages\/create<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Google Chat “Spaces” were previously called “Rooms” (2021-09)\n
- \n
- This automated task assumes a Space created in your Google Workspace account.<\/li>\n\n\n\n
- Unlike Group Messages, Spaces can add or remove users at any time.<\/li>\n\n\n\n
- Unlike Group Messages, Spaces also allow you to talk to people outside of your organization.\n
- \n
- Invited external users can join from “Browse Spaces”.<\/li>\n\n\n\n
- https:\/\/support.google.com\/chat\/answer\/7653963<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Message body\n
- \n
- Posted body messages are sent in plain text.<\/li>\n\n\n\n
- However, decorations such as Bold (with asterisks) and Code (with backquotes) are also possible.<\/li>\n\n\n\n
- https:\/\/developers.google.com\/chat\/api\/guides\/message-formats\/basic<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Process Data\n
- \n
- If the app manager specifies a field name for the automatic process, the case data will also be posted.<\/li>\n\n\n\n
- A simple Card is additionally displayed at the bottom of the message body.<\/li>\n\n\n\n
- A Process Title is automatically added to the header of the Card.<\/li>\n\n\n\n
- This is useful for sharing information with people who do not have an account on the workflow platform (non-users).<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
<\/i> See also<\/h3>\n\n\n\n
- Process Data\n
- Message body\n
- Google Chat “Spaces” were previously called “Rooms” (2021-09)\n
- The communication mechanism is different from Google Chat API.\n
- If the phone number has been posted, you can click to call from your smartphone Gmail app.<\/li>\n<\/ul>\n\n\n\n
- Integrates between the Workflow App and the Google Chat Space.\n
- google-chat-space-create-message-2023.xml<\/a>\n
- <\/i><\/span> B1: Set Body of Message#{EL}<\/sup><\/span><\/li>\n