Email コネクターでは、Send Email コマンド を含むことで、チェーンの一部としてメールを送信することができます。このコマンドはSMTP(Simple Mail Transfer Protocol)を使ってメールを送信する。認証には、Basic認証またはOAuth2認証のいずれかを使用できます。電子メールには、自動化を強化するために、チェーン内の以前のコマンドからの追加のコンテキストを含めることができます。
SMTPの前提条件
Emailコネクターを使用するには、Gmail®やMicrosoft® Office 365®などの電子メールプロバイダーのSMTPサーバーに関する詳細情報が組織に必要です。
コネクターの設定には、以下のものが必要だ:
- SMTPサーバーのホスト名
- SMTPサーバーが電子メールの送信に使用するポート
- SMTPサーバーが要求する場合は、HELOドメイン。
- SMTPサーバーに認証が必要な場合、コネクターが認証すべき統合ユーザーのユーザー名とパスワード。
OAuth2の前提条件
このコネクターで OAuth2 セキュリティを使用する前に、以下のアイテムが存在し、実装されている必要があります。
Azureの要素
以下の条件を満たしている必要があります:
- のMicrosoft Azureアカウント( )と、Azureアカウントキーの両方。
- Azure で、の認証コードフロー( )を設定します。
- Azure で、の Exchange Online サービス( )を設定しました。
-
認証コードフローを設定する際は、Azureで正しいリダイレクトURI( )を設定してください。
環境 リダイレクト URI APAC プロダクション(アジア太平洋地域) https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback CA prod(カナダ) https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback EU製品(EMEA) https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback 米国産(米国、中米、南米) https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
これらの前提条件の取得と実装については、Microsoft Azure ドキュメント を参照してください。
Workivaの要素
- Workivaの「」メールコネクタ( )を有効にしている必要があります(これには、および組織のセキュリティ管理者( )の権限が必要です)。
Eメールコネクターの設定
注: 組織のチェーンでこのコネクタを使用可能にするには、組織のセキュリティ管理者が、Configuration の から有効にする必要があります。 。
- チェーンビルダー から、接続 をクリックし、右上の作成 をクリックします。
-
コネクタ接続 で、電子メール およびデフォルトCloudRunner を選択します。
- 一意の名称および説明を入力し、接続の識別を手助けします。
-
「のプロパティ」 で、接続の詳細を入力します。
プロパティ 詳細 ホスト名称 SMTPサーバーのホスト名称を入力します:
-
や Gmail( )の場合、通常は
smtp.gmail.com となります。 -
Microsoft 365 の場合、これは通常
smtp.office365.com となります。 -
および Mailgun の場合、通常は
smtp.mailgun.org となります。
ポート サーバーが実行されているポートを入力します。
SMTPのデフォルトポートは通常、587ですが、25の場合もあります。TLS対応 トランスポート層での暗号化通信を必要とするセキュアなSMTPサーバーを使用する場合は、セキュリティ/セキュア・ソケット・レイヤー(TLS/SSL)の設定を「を有効にする」 に設定してください。 HELOドメイン SMTPサーバーが要求する場合は、ハンドシェイクが正常であることを確認するために使用されるHELOドメインを入力する。 注: 機密性の高い認証情報はすべて、Advanced Encryption Standard (AES)-256 暗号化方式を用いて自動的に暗号化され、保存されます。
-
や Gmail( )の場合、通常は
-
Authentication で、使用する認証タイプを選択し、APIコールの認証に必要な情報を入力します。必要な情報は、選択した認証タイプによって異なります。
ベーシック認証の場合
プロパティ 詳細 ユーザー名称 SMTPサーバーがBasic認証を使用する場合は、コネクターの統合ユーザー名を入力します。 パスワード SMTPサーバーがベーシック認証を必要とする場合は、ユーザー名に関連付けられたパスワードを入力します。 Microsoft Office 365 Email OAuth2
プロパティ 詳細 ユーザー名 SMTPサーバーに使用するユーザー名です。 テナントID これは、MicrosoftテナントのID文字列です。 クライアントID これは、APIに使用させたいキーのクライアントIDである。 クライアントシークレット APIに使用させたいキーのクライアントシークレットです。 - 接続をクリックします。
- 接続を使用する環境を選択して、保存をクリックします。
- 接続をテストするには、 コネクターの Send Email コマンドでチェーンを作成して実行し、自分のメールアドレスにメールを送信し、それが有効な出力を返すことを確認します。
トラブルシューティング
コネクターがメール送信に失敗した場合:
- メールプロバイダーのSMTPサーバーのホスト名とポートが正しいことを確認します。
- SMTPサーバーのドメインタイプが正しい(TLSまたはHELO)ことを確認する。
- ベーシック認証を使用している場合は、ユーザー名とパスワードの値が正しいことを確認する。
- OAuth2認証を使用する場合は、以下の点を確認してください:
- のClientID( )およびのClient Secret( )の値は正しいです。
- AzureでこれらのクライアントIDおよびクライアントシークレット値を生成する際、のリダイレクトURI「 」は正しいものです。
- Send Email コマンドのTo 、CC 、BCC 入力に入力された受信者の電子メールアドレスが正しいことを確認する。