メール送信

# メール送信

コンソールから、任意のメールクライアントのドメイン、メールアドレス、およびSMTP設定を構成する必要があります。ここに示すコードにより、Catalystアプリケーションから指定したメールアドレスにメールを送信できます。

Catalystでは、1回のメール送信操作で、複数のメールアドレスを受信者として設定し、CC、BCC、返信先を設定できます。メールにファイルを添付することもできます。1回のメール送信操作でサポートされるメール受信者とファイル添付の{{%bold%}}最大制限{{%/bold%}}は以下のとおりです：

* {{%bold%}}宛先アドレス：{{%/bold%}} 10
* {{%bold%}}CC：{{%/bold%}} 10
* {{%bold%}}BCC：{{%/bold%}} 5
* {{%bold%}}返信先：{{%/bold%}} 5
* {{%bold%}}添付ファイル数：{{%/bold%}} 5
* {{%bold%}}添付ファイルサイズ：{{%/bold%}} 15 MB（単一ファイルまたは最大5ファイルの合計）

{{%note%}}{{%bold%}}注意：{{%/bold%}}
件名、送信者、および少なくとも1つの受信者メールアドレスは必須です。メールのその他の属性は任意です。{{%/note%}}

#### 辞書の作成

最初に、メールの必要な属性を含む辞書を作成する必要があります。これには、送信者のメールアドレスとメールのすべての受信者が含まれます。

まず、Catalystコンソールで送信者のメールアドレスを{{%link href="/ja/cloud-scale/help/mail/email-configuration/" %}}設定{{%/link%}}し、確認する必要があります。送信者のメールがプライベートドメインでホストされている場合、またはサードパーティのメールクライアントを使用する場合は、メール送信前にそれらも設定する必要があります。

{{%code class="language-python line-numbers" scroll="set-scroll" %}}#辞書を作成する 
mail_obj = {
    'from_email': 'emma@zylker.com',
    'to_email': ["vanessa.hyde@zoho.com"],
    'cc': ["robert.plant@zylker.com"],
    'bcc': ["ham.gunn@zylker.com", "rover.jenkins@zylker.com"],
    'reply_to': ["peter.d@zoho.com", "arnold.h@zoho.com"],
    'subject': 'Greetings from Zylker Corp!',
    'attachments': [file1],
    'content': "<p>Hello,</p> We're glad to welcome you at Zylker Corp. To begin your journey with us, please download the attached KYC form and fill in your details. You can send us the completed form to this same email address.</p>We cannot wait to get started!<p><p>Cheers!</p><p>Team Zylker</p>"
}
{{% /code%}}

### メール送信

以下のコードに示すように、設定した辞書を{{%badge%}}send_mail(){{%/badge%}}メソッドの引数として渡す必要があります。これにより、メール送信プロセスが開始されます。以下で使用されているコンポーネントインスタンス{{%badge%}}mail_service{{%/badge%}}の詳細については、{{%link href="/ja/sdk/python/v1/cloud-scale/mail/get-component-instance/" %}}こちらのヘルプセクション{{%/link%}}を参照してください。

**使用するパラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
      <th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>{{%badge%}}mail_obj{{%/badge%}}</td>
      <td>Object</td>
			<td>{{%bold%}}必須{{%/bold%}}パラメータです。送信者のメールアドレス、受信者のメールアドレス、CC、BCC、返信先アドレス、件名、添付ファイル、およびメール本文の詳細を格納します。</td>
		</tr>
	</tbody>
</table>

{{%code class="language-python" scroll="set-scroll" %}}#メールを送信する
mail_service = app.email()
response = mail_service.send_mail(mail_obj)
{{% /code%}}

サンプルレスポンスを以下に示します：

{{%code class="language-json line-numbers" scroll="set-scroll" %}}{
  isAsync: false,
  project_details: { project_name: "Onboarding", id: "2136000000007733" },
  from_email: ["emma@zylker.com"],
  to_email: ["vanessa.hyde@zoho.com"],
  cc:["robert.plant@zylker.com"], 
  bcc:["ham.gunn@zylker.com","rover.jenkins@zylker.com"],
  reply_to:["peter.d@zoho.com","arnold.h@zoho.com"],
  html_mode: true,
  subject: "Greetings from Zylker Corp!",
  content: "<p>Hello,</p> We're glad to welcome you at Zylker Corp. To begin your journey with us, please download the attached KYC form and fill in your details. You can send us the completed form to this same email address.</p>We cannot wait to get started!<p><p>Cheers!</p><p>Team Zylker</p>"
}
{{% /code%}}

{{%note%}}{{%bold%}}情報：{{%/bold%}} 上記の操作を実行するために必要な権限レベルを確認するには、{{%link href="/ja/sdk/python/v1/sdk-scopes" %}}SDKスコープの表{{%/link%}}を参照してください。{{%/note%}}

Catalystでは、1回のメール送信操作で、複数のメールアドレスを受信者として設定し、CC、BCC、返信先を設定できます。メールにファイルを添付することもできます。1回のメール送信操作でサポートされるメール受信者とファイル添付の最大制限は以下のとおりです：

宛先アドレス： 10
CC： 10
BCC： 5
返信先： 5
添付ファイル数： 5
添付ファイルサイズ： 15 MB（単一ファイルまたは最大5ファイルの合計）

注意： 件名、送信者、および少なくとも1つの受信者メールアドレスは必須です。メールのその他の属性は任意です。

辞書の作成

最初に、メールの必要な属性を含む辞書を作成する必要があります。これには、送信者のメールアドレスとメールのすべての受信者が含まれます。

まず、Catalystコンソールで送信者のメールアドレスを設定し、確認する必要があります。送信者のメールがプライベートドメインでホストされている場合、またはサードパーティのメールクライアントを使用する場合は、メール送信前にそれらも設定する必要があります。

copy

#辞書を作成する 
mail_obj = {
    'from_email': 'emma@zylker.com',
    'to_email': ["vanessa.hyde@zoho.com"],
    'cc': ["robert.plant@zylker.com"],
    'bcc': ["ham.gunn@zylker.com", "rover.jenkins@zylker.com"],
    'reply_to': ["peter.d@zoho.com", "arnold.h@zoho.com"],
    'subject': 'Greetings from Zylker Corp!',
    'attachments': [file1],
    'content': "Hello,
 We're glad to welcome you at Zylker Corp. To begin your journey with us, please download the attached KYC form and fill in your details. You can send us the completed form to this same email address.
We cannot wait to get started!
Cheers!
Team Zylker"
}