メールやメッセージを送受信します。
GmailSendは、GmailのAPIによりメールを送信します。この機能により、利用者は、自分のGmailアカウントからメールを送信することができます。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
provider* | 文字列 | 送信に使うGmail ConnectionのProvider ID | gmail_** |
to* | 文字列 | メールの送信先アドレス | john.doe@example.com |
subject* | 文字列 | 送信するメールの件名 | Hello! John! |
body* | 文字列 | 送信するメールの本文 | Hi John, I'm very happy to send this mail to you. |
attachments | 文字列 | メールに添付するファイルのパス | /tmp/sample.txt |
from | 文字列 | メールの送信元アドレス。使用できるアドレスは、Gmail設定からアカウントに追加済みのアドレス(追加方法はこちらを参照してください)。また、下記「fromを指定する際の注意点」も参照してください。 | jane.doe@example.com |
fromを指定する際の注意点
fromに指定したアドレスがアカウントに追加済みのアドレスでなかった場合、GmailコネクションとGmail for G Suiteコネクションで挙動が異なります。 追加済みのアドレスを問題なく指定できている場合は、どちらのコネクションでも指定したアドレスから送信されます。
コネクション | fromのアドレスが間違っていた際のアクションの挙動 |
Gmail for G Suite | エラー Gmail | コネクションで紐づくアカウントのデフォルトアドレスから送信
タイプ | 型 | 概要 | 例 |
Boolean | 真理値 | APIのリクエストが、200で返却されたときにtrue | true |
+gmail_send:action>: GmailSendprovider: 'gmail_e7502c3b8b8147410ce2'to: 'john.doe@example.com'subject: 'Hello! John!'body: 'Hi John, I\'m very happy to send this mail to you.'attachments: '/tmp/sample.txt'from: 'jane.doe@example.com'
GmailGetは、Gmailのアカウントからメールを取得するアクションです。この機能により、利用者は、自分のGmailアカウントからメールを取得することができます。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
query* | 文字列 | 検索条件 | from:john.doe@example.com (検索条件の詳細についてはこちら参照してください。) |
provider* | 文字列 | 送信に使うGmail ConnectionのProvider ID | gmail_** |
limit | 文字列 | 取得するメールの上限値 | 10(default) |
タイプ | 型 | 概要 | 例 |
List | 配列 | 取得したメールオブジェクトの配列 | ※使用例のアウトプット参照 |
+gmail_get_1:action>: GmailGetquery: 'from:chan-shiro'provider: gmail_********************limit: 10#=> [# {# "id": "1234567890aaaaaa",# "subject": "ミーティング日程調整",# "to": "minna <minna@gmail.com>",# "cc": "aaa <aaa@gmail.com>",# "from": "bbb <bbb@gmail.com>",# "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は、GmailGetで取得したメールオブジェクトをインプットにして、メールに添付されているファイルをダウンロードフォルダに保存します。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
mail* | Gmail | メールオブジェクト | GmailGet で取得したリストから GetItemFromList で取得してください。 |
ignoreError | 真偽値 | true の場合、Gmailにメールが添付されていなかった例外を無視します。その他の例外はエラーとなります。 | false (default) |
タイプ | 型 | 概要 | 例 |
List | 配列 | ダウンロードしたファイルの情報 | ※使用例のアウトプット参照 |
ダウンロードされたファイルは、ダウンロード一覧を取得アクションで確認できます。
+gmail_get_1:action>: GmailGetquery: 'from:chan-shiro'provider: gmail_********************limit: 10+get_item_from_list_1:action>: GetItemFromListlist: +gmail_get_1index: 0+gmail_get_attachments_1:action>: GmailGetAttachmentsmail: +get_item_from_list_1ignoreError: false#=> [# [{# "size": 12025,# "filename": "添付画像.png",# "contentType": "image/png",# "path": "/path/to/添付画像.png"# }]+get_download_files_1:action>: GetDownloadFiles#=> [# "/path/to/添付画像.png"# ]
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>: SendSlackMessageprovider: 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>: GetFilefilename: 'rc_hogehoge'provider: local# Slackでメッセージを送信+send_slack_message_1:action>: SendSlackMessageprovider: 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 は、Chatwork のルームからメッセージを取得するアクションです。 force パラメータを設定することで、メッセージの取得方法を指定することができます。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
provider* | 文字列 | プロバイダーID | chatwork_** |
room_id* | 文字列 | メッセージを取得するルームID。プロバイダーIDが入力されている時は、chatworkのアイコンボタンから選択できます。 | 1234567890 |
force | 真偽値 | 未取得にかかわらず最新の100件を取得するか。trueの場合、未取得にかかわらず最新の100件を取得します。falseの場合、未読のメッセージのみ取得します。未読のメッセージがない場合は、空文字が返却されます。デフォルトは false です。 | false |
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 は、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 |
Chatwork にて送信先のルームを開きます。URLの「#!rid」より後の数字がルームIDです。
タイプ | 型 | 概要 | 例 |
JSON | オブジェクト | JSONレスポンス | ※使用例のアウトプット参照 |
# Chatworkにメッセージを送信+send_chatwork_message_1:action>: SendChatworkMessageprovider: chatwork_**room_id: 1234567890body: 'Hello Chatwork!'self_unread: false# =># {# "message_id": "1234567890"# }
# Chatworkにメッセージを送信+send_chatwork_message_1:action>: SendChatworkMessageprovider: chatwork_**room_id: 1234567890body: 'Hello Chatwork!'file: +get_file_1# =># {# "message_id": "1234567890"# }
OutlookSendは、Outlookアカウントからメールを送信するアクションです。
*は、必須パラメーター
名前 | 型 | 概要 | 例 |
provider* | 文字列 | OutlookコネクションのProvider ID | outlook_** |
to* | 文字列 | メールの送信先アドレス | john.doe@example.com |
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>: OutlookSendprovider: 'outlook_e7502c3b8b8147410ce2'to: 'john.doe@example.com'subject: 'Hello! John!'body: 'Hi John, I\'m very happy to send this mail to you.'attachment: '/tmp/sample.txt'
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": "<TYBP286MB03513C9BE95C31DCB2B179F9D16E0@TYBP286MB0351.JPNP286.PROD.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>: OutlookGetprovider: 'outlook_e7502c3b8b8147410ce2'folder: '受信トレイ'query: '$select=id,subject'limit: 10
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>: OutlookGetprovider: outlook_1237bc9d0838a4b4cc1efolder: '受信トレイ'query: '$filter=hasAttachments eq true'limit: 10# リストから要素を取得+get_item_from_list_1:action>: GetItemFromListlist: +outlook_get_1index: '0'+outlook_get_attachments_1:action>: OutlookGetAttachmentsprovider: 'outlook_e7502c3b8b8147410ce2'mail: +get_item_from_list_1
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>: SendTeamsMessageprovider: msteams_8796f34150fc10934bc4team: ttldevelopmentchannel: Generaltext: 'ハロー<br>world'mentions: 'Alex Wilber,General'