Message

メールやメッセージを送受信します。
GmailSend
概要
GmailSendは、GmailのAPIによりメールを送信します。この機能により、利用者は、自分のGmailアカウントからメールを送信することができます。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
送信に使うGmail ConnectionのProvider ID
gmail_**
to*
文字列
メールの送信先アドレス
[email protected]
subject*
文字列
送信するメールの件名
Hello! John!
body*
文字列
送信するメールの本文
Hi John, I'm very happy to send this mail to you.
attachments
文字列
メールに添付するファイルのパス
/tmp/sample.txt
from
文字列
メールの送信元アドレス。使用できるアドレスは、Gmail設定からアカウントに追加済みのアドレス（追加方法はこちらを参照してください）。また、下記「fromを指定する際の注意点」も参照してください。
[email protected]
fromを指定する際の注意点
fromに指定したアドレスがアカウントに追加済みのアドレスでなかった場合、GmailコネクションとGmail for G Suiteコネクションで挙動が異なります。
追加済みのアドレスを問題なく指定できている場合は、どちらのコネクションでも指定したアドレスから送信されます。
コネクション
fromのアドレスが間違っていた際のアクションの挙動
Gmail for G Suite
エラー
Gmail
コネクションで紐づくアカウントのデフォルトアドレスから送信
アウトプット
タイプ
型
概要
例
Boolean
真理値
APIのリクエストが、200で返却されたときにtrue
true
使用例
+gmail_send:
  action>: GmailSend
  provider: 'gmail_e7502c3b8b8147410ce2'
  to: '[email protected]'
  subject: 'Hello! John!'
  body: 'Hi John, I\'m very happy to send this mail to you.'
  attachments: '/tmp/sample.txt'
  from: '[email protected]'
GmailGet
概要
GmailGetは、Gmailのアカウントからメールを取得するアクションです。この機能により、利用者は、自分のGmailアカウントからメールを取得することができます。
パラメーター
*は、必須パラメーター
名前
型
概要
例
query*
文字列
検索条件
from:[email protected] (検索条件の詳細についてはこちら参照してください。)
provider*
文字列
送信に使うGmail ConnectionのProvider ID
gmail_**
limit
文字列
取得するメールの上限値
10(default)
アウトプット
タイプ
型
概要
例
List
配列
取得したメールオブジェクトの配列
※使用例のアウトプット参照
使用例
+gmail_get_1:
  action>: GmailGet
  query: 'from:chan-shiro'
  provider: gmail_********************
  limit: 10
#=> [
#   {
#     "id": "1234567890aaaaaa",
#     "subject": "ミーティング日程調整",
#     "to": "minna <[email protected]>",
#     "cc": "aaa <[email protected]>",
#     "from": "bbb <[email protected]>",
#     "date": "2019-03-14T10:41:09.000Z",
#     "body": "ミーティングはXX月XX日XX時開始にしましょう。",
#     "html": "<html xmlns=\"http://www.w3.org/1999/xhtml\">\r\n<head>\r\n<title></title>\r\n</head>\r\n<body>\r\n<div name=\"messageBodySection\">\r\n<div dir=\"auto\">ミーティング日程調整</div>\r\n</div>\r\n</body>\r\n</html>\r\n",
#     "attachements": [
#       {
#         "filename": "combine.pdf",
#         "contentType": "application/octet-stream",
#         "attachmentId": "ANGjdJ8xf--nLYOiblQaphB0PPmxwiHzqWb189HnjTBSsfYaIEDtgYj2ERCLNrDwMw_okMmC6yPCsip0rHRTvzwH7PbjuEd7TPE1mkYHPANdMCd0K8BU9kNEwR0AEKfw8JFPuHlxcTznvBBVlyjXfdMdjtrRSYRKPKwD-sqRZL0mleYM5TARSDLLKFVl0rhlMNFhvnFwUCLQPx_EmrHByTu2iZOQqDFLwF2gPuAvsvz3qc_ZmrCMs6A825NfRcniz0AzcNvDaCEEAMjbrif6hzOVqnaT1wBeBw-uRX9KxiFLquwuxW3-GI6oRROSG5QdzuzuvCUzcaK4vqxCaGzcDil0OjOOgbYBKCEZMXjKpGfeSq416VpQcj4t3YCaO0c8mfjP7MbwkHxmAS7wT8kGUSMI_0icEtmHKuQNwy3dgQ"
#       },
#       {
#         "filename": "添付画像.png",
#         "contentType": "image/png",
#         "attachmentId": "ANGjdJ9A5SjcD6C0B3vB-DKy5bt7b8FxTPJpnAVwJ7KmtZ3bPRH8vYyM8XbWqUbNGLvGveHo0f4B0ucUiyTTV1zLRRQigFPTTHtdxE4rZodBQQjvQng3Fnyv82Z8H7rlyA2ST8eXP4sEvaWuJy16Gs8qS_QNVME86VLkSllif19xEwddOK3fM2WXmCG8A8kGdOl1W8xHpJ44wAVgzjxn1ah2VbxKbS-HEjx9n-kZ70rtlIKBlRl-5Nhr2MrifV4LtTvSx6Z-14Iw7RmECkB4PC6fHQk7CseD3z6x3aa4oRDygNeAwakSHbYq-FFajw1elYkCfG6b6t8sIEslCvNHERw8J3JiQfdcWE6QSoXkCSsp56xrkAsS4W__iQQ3hxR1iehbMu_h1rPTw4oANJ3R"
#       }
#     ]
#   },...
# ]
GmailGetAttachments
概要
GmailGetAttachmentsは、GmailGetで取得したメールオブジェクトをインプットにして、メールに添付されているファイルをダウンロードフォルダに保存します。
パラメーター
*は、必須パラメーター
名前
型
概要
例
mail*
Gmail
メールオブジェクト
GmailGet で取得したリストから GetItemFromList で取得してください。
ignoreError
真偽値
true の場合、Gmailにメールが添付されていなかった例外を無視します。その他の例外はエラーとなります。
false (default)
アウトプット
タイプ
型
概要
例
List
配列
ダウンロードしたファイルの情報
※使用例のアウトプット参照
ダウンロードされたファイルは、ダウンロード一覧を取得アクションで確認できます。
使用例
+gmail_get_1:
  action>: GmailGet
  query: 'from:chan-shiro'
  provider: gmail_********************
  limit: 10
​
+get_item_from_list_1:
  action>: GetItemFromList
  list: +gmail_get_1
  index: 0
​
+gmail_get_attachments_1:
  action>: GmailGetAttachments
  mail: +get_item_from_list_1
  ignoreError: false
#=> [
# [{
#   "size": 12025,
#   "filename": "添付画像.png",
#   "contentType": "image/png",
#   "path": "/path/to/添付画像.png"
# }]
​
 +get_download_files_1:
   action>: GetDownloadFiles
​
#=> [
#    "/path/to/添付画像.png"
#   ]
SendSlackMessage
概要
SendSlackMessageは、Slackのアプリからbotとしてメッセージを送信するアクションです。この機能により、任意のチャンネルに追加したアプリのbotから自動でメッセージの送信が可能です。
アクション実行前の準備
このアクションを実行する為に、事前にSlack APIでアプリを作成しておく必要があります。 詳しくは、こちら（Slack APIアプリの設定）の記事をご覧ください。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
SlackコネクションのプロバイダーID
slack_**
channel*
文字列
送信先のチャンネル名。プロバイダーIDが入力されている時は、ハンバーガーメニューのslackのアイコンボタンから選択できます。予めチャンネルにアプリを追加しておく必要があります。
#general
text*
文字列
送信するメッセージ
Hello,World!
file
文字列
添付ファイル。ファイルは、「ファイルを取得」アクションなどで、ロボット内にダウンロードされている必要があります。
+get_file_1
アウトプット
タイプ
型
概要
例
JSON
オブジェクト
JSONレスポンス
※使用例のアウトプット参照
使用例
メッセージのみ送信する場合
# Slackでメッセージを送信
+send_slack_message:
  action>: SendSlackMessage
  provider: slack_**
  channel: '#test'
  text: 'Hello, World!'
# =>
# { "ok": true,
#   "channel": "123456",
#   "ts": "1558588475.001100",
#   "message": {
#     bot_id: '123456',
#     type: 'message',
#     text: 'Hello, World!',
#     user: '123456',
#     ts: '1558588475.001100',
#     team: '123456',
#     bot_profile: {
#       id: '123456',
#       deleted: false,
#       name: 'Robotic Crowd',
#       updated: 1584090964,
#       app_id: '123456',
#       icons: [Object],
#       team_id: '123456'
#     }
#   }
#   "response_metadata": {
#     "scopes": [
#       "files:write",
#       "chat:write",
#       "channels:read"
#     ],
#     "acceptedScopes": [
#       "chat:write"
#     ]
#   }
# }
ファイルを添付する場合
# ファイルを取得
+get_file_1:
  action>: GetFile
  filename: 'rc_hogehoge'
  provider: local
​
# Slackでメッセージを送信
+send_slack_message_1:
  action>: SendSlackMessage
  provider: slack_**
  channel: '#test'
  text: 'ファイルを送信する'
  file: +get_file_1
# =>
# { "ok": "true",
#   "file": {
#     "id": "123456",
#     "created": "1583938905",
#     "timestamp": "1583938905",
#     "name": "test.txt",
#     "title": "test.txt",
#     "mimetype": "text/plain",
#     filetype: "text",
#     pretty_type: "プレーンテキスト",
#     ...
#   },
#   "response_metadata": {
#     "scopes": [
#       "files:write",
#       "chat:write",
#       "channels:read"
#     ],
#     "acceptedScopes": [
#       "files:write"
#     ]
#   }
# }
GetChatworkMessages
概要
GetChatworkMessages は、Chatwork のルームからメッセージを取得するアクションです。 force パラメータを設定することで、メッセージの取得方法を指定することができます。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
プロバイダーID
chatwork_**
room_id*
文字列
メッセージを取得するルームID。プロバイダーIDが入力されている時は、chatworkのアイコンボタンから選択できます。
1234567890
force
真偽値
未取得にかかわらず最新の100件を取得するか。trueの場合、未取得にかかわらず最新の100件を取得します。falseの場合、未読のメッセージのみ取得します。未読のメッセージがない場合は、空文字が返却されます。デフォルトは false です。
false
ルームIDの取得方法
Chatwork にて送信先のルームを開きます。URLの「#!rid」より後の数字がルームIDです。
アウトプット
タイプ
型
概要
例
JSON
オブジェクト
JSONレスポンス
※使用例のアウトプット参照
使用例
# Chatworkからメッセージを取得
# +get_chatwork_messages_1:
#   action>: GetChatworkMessages
#   provider: chatwork_**
#   room_id: 1234567890
#   force: false
# =>
# [ { message_id: '1234567890',
#     account:
#      { account_id: 123456,
#        name: '山田　太郎',
#        avatar_image_url: 'https://appdata.chatwork.com/avatar/ico_default_green.png' },
#     body: 'Hello Charwork! read',
#     send_time: 1576740683,
#     update_time: 0
#   },
#   ....
# ]
SendChatworkMessage
概要
SendChatworkMessage は、Chatwork アカウントからメッセージを送信するアクションです。指定したルームにメッセージを送信します。self_unread パラメータを設定することで、追加したメッセージを自分から見て未読とするか既読とするかを選択できます。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
プロバイダーID
chatwork_**
room_id*
文字列
送信先のルームID。プロバイダーIDが入力されている時は、chatworkのアイコンボタンから選択できます。
1234567890
body*
文字列
メッセージ本文
Hello Chatwork!
file
文字列
添付ファイル。ファイルは、「ファイルを取得」アクションなどで、ロボット内にダウンロードされている必要があります。添付ファイルを送る場合、メッセージ本文は任意となります。
+get_file_1
self_unread
真偽値
追加したメッセージを自分から見て未読とするか。true の場合は未読、false の場合は既読となります。デフォルトは false（既読）です。添付ファイルを送る場合、自動的にfalseとなります。
false
ルームIDの取得方法
Chatwork にて送信先のルームを開きます。URLの「#!rid」より後の数字がルームIDです。
アウトプット
タイプ
型
概要
例
JSON
オブジェクト
JSONレスポンス
※使用例のアウトプット参照
使用例
メッセージのみ送信する場合
# Chatworkにメッセージを送信
+send_chatwork_message_1:
  action>: SendChatworkMessage
  provider: chatwork_**
  room_id: 1234567890
  body: 'Hello Chatwork!'
  self_unread: false
# =>
# {
#   "message_id": "1234567890"
# }
添付ファイルを送信する場合
# Chatworkにメッセージを送信
+send_chatwork_message_1:
  action>: SendChatworkMessage
  provider: chatwork_**
  room_id: 1234567890
  body: 'Hello Chatwork!'
  file: +get_file_1
# =>
# {
#   "message_id": "1234567890"
# }
OutlookSend
概要
OutlookSendは、Outlookアカウントからメールを送信するアクションです。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
OutlookコネクションのProvider ID
outlook_**
to*
文字列
メールの送信先アドレス
[email protected]
subject*
文字列
送信するメールの件名
Hello! John!
body*
文字列
送信するメールの本文
Hi John, I'm very happy to send this mail to you.
attachment
文字列
メールに添付するファイルのパス
/tmp/sample.txt
アウトプット
タイプ
型
概要
例
Boolean
真理値
メール送信に成功したときにtrue
true
使用例
+outlook_send:
  action>: OutlookSend
  provider: 'outlook_e7502c3b8b8147410ce2'
  to: '[email protected]'
  subject: 'Hello! John!'
  body: 'Hi John, I\'m very happy to send this mail to you.'
  attachment: '/tmp/sample.txt'
OutlookGet
概要
OutlookGetは、Outlookアカウントからメールを取得するアクションです。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
OutlookコネクションのProvider ID
outlook_**
folder
文字列
メールフォルダー名（パス指定も可能）
受信トレイ
query
文字列
クエリパラメーター
$select=id,subject (検索条件の詳細についてはこちらを参照してください。)
limit*
数値
最大取得件数（0の場合は、全件取得）
10
アウトプット
タイプ
型
概要
例
List
配列
取得したメールオブジェクトの配列
例は下記参照(メールオブジェクトの詳細についてはこちらを参照してください。)
[
  {
    "@odata.etag": "W/\"CQAAABYAAABtaUN2QyPsS6QzjVEesIOcAAAFyQ/9\"",
    "id": "AAMkADY0YTkzNDM3LWYwZGItNDhlOC05YWU4LTU0Nzc5OWM1ODEyYQBGAAAAAACnJlOhO_yqRoxxwC8pFn_4BwBtaUN2QyPsS6QzjVEesIOcAAAAAAEMAABtaUN2QyPsS6QzjVEesIOcAAAFzZwSAAA=",
    "createdDateTime": "2020-06-29T06:58:59Z",
    "lastModifiedDateTime": "2020-06-29T06:59:00Z",
    "changeKey": "CQAAABYAAABtaUN2QyPsS6QzjVEesIOcAAAFyQ/9",
    "categories": [],
    "receivedDateTime": "2020-06-29T06:58:59Z",
    "sentDateTime": "2020-06-29T06:58:58Z",
    "hasAttachments": true,
    "internetMessageId": "<[email protected]D.OUTLOOK.COM>",
    "subject": "this is test",
    "bodyPreview": "hello world",
    "importance": "normal",
    "parentFolderId": "AAMkADY0YTkzNDM3LWYwZGItNDhlOC05YWU4LTU0Nzc5OWM1ODEyYQAuAAAAAACnJlOhO_yqRoxxwC8pFn_4AQBtaUN2QyPsS6QzjVEesIOcAAAAAAEMAAA=",
    "conversationId": "AAQkADY0YTkzNDM3LWYwZGItNDhlOC05YWU4LTU0Nzc5OWM1ODEyYQAQAOMe6S_MZVJIqo6jq-_0Ics=",
    "conversationIndex": "AQHWTeLD4x7pL4xlUkiqjqOr/7Qhyw==",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": false,
    "isDraft": false,
    "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkADY0YTkzNDM3LWYwZGItNDhlOC05YWU4LTU0Nzc5OWM1ODEyYQBGAAAAAACnJlOhO%2ByqRoxxwC8pFn%2B4BwBtaUN2QyPsS6QzjVEesIOcAAAAAAEMAABtaUN2QyPsS6QzjVEesIOcAAAFzZwSAAA%3D&exvsurl=1&viewmodel=ReadMessageItem",
    "inferenceClassification": "focused",
    "body": {
      "contentType": "text",
      "content": "hello world"
    },
  },
]
使用例
+outlook_get:
  action>: OutlookGet
  provider: 'outlook_e7502c3b8b8147410ce2'
  folder: '受信トレイ'
  query: '$select=id,subject'
  limit: 10
OutlookGetAttachments
概要
OutlookGetAttachmentsは、メールに添付されたファイルを取得するアクションです。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
OutlookコネクションのProvider ID
outlook_**
mail*
JSON
Outlookのメールオブジェクト
OutlookGetのアウトプットを参照
アウトプット
タイプ
型
概要
例
Array
配列
取得したファイルオブジェクトの配列
例は下記参照
[
  {
    "filename": "excel.xlsx",
    "contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "path": "/tmp/a4b81858-2453-40fa-83df-992e14a10e1a/download/excel.xlsx",
    "size": 8364
  }
]
使用例
# Outlookメールを取得する
+outlook_get_1:
  action>: OutlookGet
  provider: outlook_1237bc9d0838a4b4cc1e
  folder: '受信トレイ'
  query: '$filter=hasAttachments eq true'
  limit: 10
​
# リストから要素を取得
+get_item_from_list_1:
  action>: GetItemFromList
  list: +outlook_get_1
  index: '0'
​
+outlook_get_attachments_1:
  action>: OutlookGetAttachments
  provider: 'outlook_e7502c3b8b8147410ce2'
  mail: +get_item_from_list_1
SendTeamsMessage
概要
SendTeamsMessageは、Microsoft Teamsにメッセージを送信するアクションです。 デフォルトで作成された「一般」チャンネルにメッセージを送りたい場合は、 チャンネル名を「一般」ではなく「General」と指定してください。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
Microsoft Teams MessageコネクションのProvider ID
msteams_**
team*
文字列
チーム名
team
channel*
文字列
チャンネル名
General
text*
文字列
メッセージ本文（HTML形式）
hello world
mentions
文字列
メンション名（カンマ区切りで複数指定可能）
Alex Wilber,General
アウトプット
タイプ
型
概要
例
JSON
JSON
メッセージオブジェクト。詳細はこちら​
例は下記参照
{
  "id": "string (identifier)",
  "replyToId": "string (identifier)",
  "from": {"@odata.type": "microsoft.graph.identitySet"},
  "etag": "string",
  "messageType": "string",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "string (timestamp)",
  "deletedDateTime": "string (timestamp)",
  "subject": "string",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "summary": "string",
  "attachments": [{"@odata.type": "microsoft.graph.chatMessageAttachment"}],
  "mentions": [{"@odata.type": "microsoft.graph.chatMessageMention"}],
  "importance": "string",
  "locale": "string",
}
使用例
# MicrosoftTeamsにメッセージを送る
+send_teams_message_1:
  action>: SendTeamsMessage
  provider: msteams_8796f34150fc10934bc4
  team: ttldevelopment
  channel: General
  text: 'ハロー<br>world'
  mentions: 'Alex Wilber,General'
Actions - Previous
Google Calendar
Next - Actions
Control
Last updated 3 days ago
名前	型	概要	例
provider*	文字列	送信に使うGmail ConnectionのProvider ID	gmail_**
to*	文字列	メールの送信先アドレス	[email protected]
subject*	文字列	送信するメールの件名	Hello! John!
body*	文字列	送信するメールの本文	Hi John, I'm very happy to send this mail to you.
attachments	文字列	メールに添付するファイルのパス	/tmp/sample.txt
from	文字列	メールの送信元アドレス。使用できるアドレスは、Gmail設定からアカウントに追加済みのアドレス（追加方法はこちらを参照してください）。また、下記「fromを指定する際の注意点」も参照してください。	[email protected]
コネクション	fromのアドレスが間違っていた際のアクションの挙動
Gmail for G Suite	エラー
Gmail	コネクションで紐づくアカウントのデフォルトアドレスから送信
タイプ	型	概要	例
Boolean	真理値	APIのリクエストが、200で返却されたときにtrue	true
名前	型	概要	例
query*	文字列	検索条件	from:[email protected] (検索条件の詳細についてはこちら参照してください。)
provider*	文字列	送信に使うGmail ConnectionのProvider ID	gmail_**
limit	文字列	取得するメールの上限値	10(default)
タイプ	型	概要	例
List	配列	取得したメールオブジェクトの配列	※使用例のアウトプット参照
名前	型	概要	例
mail*	Gmail	メールオブジェクト	GmailGet で取得したリストから GetItemFromList で取得してください。
ignoreError	真偽値	true の場合、Gmailにメールが添付されていなかった例外を無視します。その他の例外はエラーとなります。	false (default)
タイプ	型	概要	例
JSON	オブジェクト	JSONレスポンス	※使用例のアウトプット参照
タイプ	型	概要	例
Array	配列	取得したファイルオブジェクトの配列	例は下記参照