カスタムメールと通知
カスタムメールと通知
メールの件名と本文
署名者に送信されるメールには、デフォルトで、ドキュメントへのリンク、一般的な件名、一般的なメッセージが記載されています。
Box内で管理されているテンプレートを使用する場合、件名とメッセージ本文はテンプレート自体で設定できます。
ただし、テンプレートを使用しない場合も、email_subjectパラメータとemail_messageパラメータを渡すことで、署名者に送信されるメールメッセージをカスタマイズすることができます。
どちらのパラメータにも文字列を使用できますが、email_messageパラメータには、いくつか制限はあるもののHTMLも使用できます。
使用できるのは、一部のHTMLタグだけです。また、メッセージに含まれるリンクは、メールではハイパーリンクに変換されます。
メッセージパラメータには、以下のHTMLタグを含めることができます。
a,abbr,acronym,b,blockquote,code,em,i,ul,li,ol,strong
これらのタグにカスタムスタイルを適用することはできません。
テキストとHTMLの比率が大きすぎると、メールがスパムフィルタに入ったり、切り取られたりする可能性があることにご注意ください。
例:
curl --location 'https://api.box.com/2.0/sign_requests' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ej...3t' \
--data-raw '{
"email_subject": "All we need is your signature to get started",
"parent_folder": {
"id": "234102987614",
"type": "folder"
},
"source_files": [
{
"id": "1358047520478",
"type": "file"
}
],
"signers": [
{
"email": "signer@example.com",
"role": "signer"
}
]
}'
手動による通知
ここまでで、署名リクエストでは、デフォルトで署名者にメール通知が送信されることがわかりました。このメールはbox.comドメインおよびメールシステムから送信されます。
embed_url_external_user_idパラメータに特定の署名者を表す任意の識別子を設定することで、通知プロセスを引き継ぐことができます。
このパラメータを設定すると、署名者にはメール通知が送信されず、署名リクエスト内でembed_urlとiframeable_embed_urlの両方が返されます。
embed_urlは直接開くことができるので、アプリからメールで送信したり、署名者が開く他の通知システムで送信したりするのに適しています。
iframeable_embed_urlは、Box Signクライアントの埋め込み機能との併用に適しており、ウェブアプリ内のiframeにBox Signクライアントを埋め込むことができます。
たとえば、次のリクエストを確認してください。
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer fN...dD' \
--data-raw '{
"is_document_preparation_needed": false,
"parent_folder": {
"id": "234102987614",
"type": "folder"
},
"source_files": [
{
"id": "1355143830404",
"type": "file"
}
],
"signers": [
{
"email": "signer@example.com",
"embed_url_external_user_id": "1234",
"role": "signer"
}
]
}'
結果は次のとおりです (簡略化されています)。
{
"is_document_preparation_needed": false,
"signers": [
{
"email": "sender@example.com",
"role": "final_copy_reader",
},
{
"email": "signer@example.com",
"role": "signer",
"embed_url_external_user_id": "1234",
"embed_url": "https://app.box.com/sign/document/22a990ce-4e24-463b-b2f4-124820fe161a/9331fe9ac85650d61645d4b0fd30fe3e0ebee7921720ab6ecca587654d3cd875/",
"iframeable_embed_url": "https://app.box.com/embed/sign/document/22a990ce-4e24-463b-b2f4-124820fe161a/9331fe9ac85650d61645d4b0fd30fe3e0ebee7921720ab6ecca587654d3cd875/"
}
],
"id": "22a990ce-4e24-463b-b2f4-124820fe161a",
}
これで、埋め込みURLを取得して、独自の通知プロセスを使用したり、自分のアプリ内に署名クライアントを埋め込んだりできるようになりました。