署名者へのリクエストの送信

署名リクエストを作成した後は、各署名者にリクエストを届けるための手段が必要になります。以下の方法を使用できます。

Boxから署名者にメールを送信する。必要に応じて件名や本文をカスタマイズする
Boxからのメール送信を無効にして、自分で署名用リンクを送信する
ウェブサイトに署名クライアントを埋め込む

これらはリクエストの作成時に設定します。リクエストをキャンセルする際に変更することはできません。

Boxのメールのカスタマイズ

デフォルトでは、Box Signは各署名者に対して汎用的な件名と本文を使用したメールをbox.comのアドレスから送信します。この内容を変更するには、リクエストの作成時にemail_subjectとemail_messageを設定します。どちらも文字列を受け付けます。email_messageでは、a、abbr、acronym、b、blockquote、code、em、i、ul、li、ol、strongなどのHTMLタグも使用できます。カスタムスタイルは使用できません。HTMLに対するテキストの比率が大きすぎると、メールがスパムフィルタに入ったり、一部が省略されたりする可能性があります。テンプレートからリクエストを作成する場合、テンプレート側であらかじめ件名と本文が定義されていることがあります。まだ署名していない署名者に対して3日後、8日後、13日後、18日後にメールを送信するには、are_reminders_enabledをtrueに設定します。すぐに再送信する方法については、Box Signリクエストの再送信を参照してください。

curl -i -X POST "https://api.box.com/2.0/sign_requests" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "email_subject": "All we need is your signature to get started",
       "email_message": "Please review and sign the attached agreement.",
       "parent_folder": {
         "type": "folder",
         "id": "0987654321"
       },
       "source_files": [
         {
           "type": "file",
           "id": "123456789"
         }
       ],
       "signers": [
         {
           "email": "signer@example.com",
           "role": "signer"
         }
       ]
     }'

独自の通知の送信

独自の通知を送信するには、リクエストの作成時に署名者に対して次の2つの両方を設定します。

suppress_notifications～true
embed_url_external_user_idに、その署名者用に選択したIDを設定する

これにより、Box Signはその署名者に対するデフォルトの署名用メールを送信しなくなります。レスポンスにはembed_urlが含まれ、このURLを独自のメール、プッシュ通知、テキストメッセージで使用できます。独自のドメインから通知を送信したり、すでに運用しているチャンネルを使用したりできます。署名ログには、Box通知を抑制したことと、embed_url_external_user_idで渡した署名者IDが記録されます。

Boxのメールを抑制する場合、組織は、必要な通知を適切な内容で適切なタイミングで署名者へ送信し、該当する場合は送信方法に対して同意を得ることを含め、適用される法律を遵守する責任を負うことになります。

curl -i -X POST "https://api.box.com/2.0/sign_requests" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "parent_folder": {
         "type": "folder",
         "id": "0987654321"
       },
       "source_files": [
         {
           "type": "file",
           "id": "123456789"
         }
       ],
       "signers": [
         {
           "role": "signer",
           "email": "signer@example.com",
           "suppress_notifications": true,
           "embed_url_external_user_id": "1234"
         }
       ]
     }'

簡略化したレスポンスには、その署名者向けのembed_urlとiframeable_embed_urlの両方が含まれています。

{
  "id": "22a990ce-4e24-463b-b2f4-124820fe161a",
  "signers": [
    {
      "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/"
    }
  ]
}

独自の通知にはembed_urlを使用します。iframeable_embed_urlは、この後で説明するように、クライアントを埋め込むために使用します。

署名クライアントの埋め込み

Box Embedを使用すると、自分のウェブサイト内でリクエストを完了できるようにして、署名者がBox Signに移動して戻ってくる手間を減らすことができます。リクエストの作成時に各署名者のembed_url_external_user_idを渡します。レスポンスに、その署名者の一意のiframeable_embed_urlが含まれます。

https://app.box.com/embed/sign/document/f14d7098-a331-494b-808b-79bc7f3992a3/f14d7098-a331-494b-808b-79bc7f3992a4

そのURLをiframeに入力します。

<iframe
  src="https://app.box.com/embed/sign/document/f14d7098-a331-494b-808b-79bc7f3992a3/f14d7098-a331-494b-808b-79bc7f3992a4"
  width="{pixels}"
  height="{pixels}"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  msallowfullscreen
></iframe>

リクエスト送信者のデバイスを使用して対面での署名を行う場合は、さらにis_in_personをtrueに設定します。詳細については、対面での署名を参照してください。 Box Embedの詳細については、プログラムによるBox要素の埋め込みを参照してください。

はじめに

アプリケーションと統合

IDとアクセス

APIの利用

トラブルシューティング

コンテンツ

コラボレーション

メタデータと検索

イベントとWebhook

ユーザー

インテリジェントなワークフロー

電子サイン

セキュリティとコンプライアンス

署名者へのリクエストの送信

Boxのメールのカスタマイズ

独自の通知の送信

署名クライアントの埋め込み

​Boxのメールのカスタマイズ

​独自の通知の送信

​署名クライアントの埋め込み

Boxのメールのカスタマイズ

独自の通知の送信

署名クライアントの埋め込み