---
title: Webhook実行時の挙動
description: クラウドサインWebhookの設定と挙動について解説します。HTTPリクエストのプロトコル、IPアドレス、リクエストメソッド、レスポンス、エラー時の挙動などを詳細に説明しています。Webhookによる書類締結完了や取り消しなどの通知方法を理解し、スムーズなシステム連携を実現しましょう。
---

[コンテンツまでスキップ](https://help.cloudsign.jp/ja/articles/9977727#main-content)

日本語

翻訳のサブメニューを表示

[![クラウドサイン ヘルプセンター](https://help.cloudsign.jp/hs-fs/hubfs/%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89%E3%82%B5%E3%82%A4%E3%83%B3_logo_horizontal_white_RGB@4x-1.png?width=170&height=40&name=%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89%E3%82%B5%E3%82%A4%E3%83%B3_logo_horizontal_white_RGB@4x-1.png)](https://help.cloudsign.jp/ja/?hsLang=ja)

メインナビゲーションを開く

メインナビゲーションを閉じる

- 日本語
  
  翻訳のサブメニューを表示
- [クラウドサインはこちら](https://www.cloudsign.jp/)

[クラウドサインはこちら](https://www.cloudsign.jp/)

 どんなことにお困りですか？

- 検索フィールドが空なので、候補はありません。

1. [クラウドサイン ヘルプセンター](https://help.cloudsign.jp/ja?hsLang=ja)
2. [プラン](https://help.cloudsign.jp/ja/%E3%83%97%E3%83%A9%E3%83%B3?hsLang=ja)
3. [有料プラン](https://help.cloudsign.jp/ja/%E3%83%97%E3%83%A9%E3%83%B3?hsLang=ja#%E6%9C%89%E6%96%99%E3%83%97%E3%83%A9%E3%83%B3)

# Webhook実行時の挙動

書類が、Webhookの追加時に設定した「通知する条件」の状態になると、指定された URL に対してHTTP リクエストを行います。

 

### HTTP リクエスト

このセクションでは指定された URL に対してクラウドサインが行う HTTP リクエストについて説明します。

 

### 前提

クラウドサインの Webhook によるリクエストは以下の前提です。

- プロトコル

    - HTTPS
    - HTTP（非推奨です。今後廃止される可能性があります）

- SSL/TLSのバージョン

    - TLS1.3
    - TLS1.2
- 暗号スイート

    - TLS\_RSA\_WITH\_AES\_128\_CBC\_SHA（非推奨です。今後廃止される可能性があります）
    - TLS\_RSA\_WITH\_AES\_256\_CBC\_SHA（非推奨です。今後廃止される可能性があります）
    - TLS\_RSA\_WITH\_AES\_128\_GCM\_SHA256（非推奨です。今後廃止される可能性があります）
    - TLS\_RSA\_WITH\_AES\_256\_GCM\_SHA384（非推奨です。今後廃止される可能性があります）
    - TLS\_AES\_128\_GCM\_SHA256
    - TLS\_AES\_256\_GCM\_SHA384
    - TLS\_CHACHA20\_POLY1305\_SHA256
    - TLS\_ECDHE\_ECDSA\_WITH\_AES\_128\_CBC\_SHA
    - TLS\_ECDHE\_ECDSA\_WITH\_AES\_256\_CBC\_SHA
    - TLS\_ECDHE\_RSA\_WITH\_AES\_128\_CBC\_SHA
    - TLS\_ECDHE\_RSA\_WITH\_AES\_256\_CBC\_SHA
    - TLS\_ECDHE\_ECDSA\_WITH\_AES\_128\_GCM\_SHA256
    - TLS\_ECDHE\_ECDSA\_WITH\_AES\_256\_GCM\_SHA384
    - TLS\_ECDHE\_RSA\_WITH\_AES\_128\_GCM\_SHA256
    - TLS\_ECDHE\_RSA\_WITH\_AES\_256\_GCM\_SHA384
    - TLS\_ECDHE\_RSA\_WITH\_CHACHA20\_POLY1305\_SHA256
    - TLS\_ECDHE\_ECDSA\_WITH\_CHACHA20\_POLY1305\_SHA256

 

#### 送信元

クラウドサインの Webhook は環境ごとに以下のIPアドレスから HTTP リクエストを行います。

本番環境の場合

```
52.68.17.229/32 または 52.198.144.82/32 または 3.112.114.42/32
```

 

sandbox環境の場合

```
52.197.119.179/32
```

 

#### リクエストメソッド

クラウドサインの Webhook は POST メソッドで送信します。

 

#### リクエストヘッダ

クラウドサインの Webhook は以下のヘッダを送信します。

- Content-Type: application/json
- User-Agent: CloudSignWebHook
- Body: {JSON}

 

#### リクエストボディ

クラウドサインの Webhook は HTTP リクエストボディとしてJSON形式のテキストデータを送信します。

JSON の内容はたとえば以下のようになります。なお、見やすくするように改行を入れていますが、実際には1行で、プロパティ名と値の間には空白は入りません。  
​

```
{"documentID": "{documentID}","status": 2,"userID": "{userID}","email": "user@example.com","text": "COMPLETED : 業務委託契約 sent by Jane Doe\n<https://www.cloudisign.jp/document/{documentID}/summary>"}
```

 

---

JSONの各プロパティの詳細

2024年12月時点での JSON のプロパティは以下です。

プロパティは予告なく追加される可能性がありますのでご了承ください。

documentID:

- `documentID` は書類を一意に識別する ID です。書類の詳細を取得するには、書類取得 API GET /documents/{documentID} をご利用ください。

 

status:

- `status` は書類の状態を示す1桁の整数値です。以下の3種のいずれかの値をとります。  
  ​

    - **1**: 先方確認中
    - **2**: 締結完了
    - **3**: 取り消し・却下

 

userID:

- `UserID` は、クラウドサイン内でユーザーを一意に識別するための ID です。ここでは書類の送信者の ID が記されます。

 

email:

- `email` は、書類の送信者のメールアドレスです。

text:

- `text` は、Webhookメッセージの本体となる部分です。書類に関する以下のような情報が記されます。

    - Webhookメッセージの種類

          - COMPLETED: 書類の締結完了時
          - CANCELED: 書類の取り消し・却下時
          - BOUNCED: 確認依頼メール、転送メール、締結完了メールの不達時

                  - ※どの種類のメールが不達になったかは、上記statusプロパティの値によってご確認いただけます。

                            - statusが「1」：確認依頼メール or 転送メール
                            - statusが「2」：締結完了メール

    - 書類のタイトル
    - 送信者の名前
    - クラウドサイン上の書類確認用 URL

 

---

HTTP レスポンス

このセクションでは指定された URL からクラウドサインへの HTTP レスポンスについて説明します。

#### ステータスコード 

クラウドサインの Webhook では、以下のHTTPステータスコードに応じて動作します。

- 200番台（成功）: 送信成功として扱われます。再送は行われません。
- 400番台（クライアントエラー）: 現行仕様では送信成功として扱われます。再送は行われません。
- 500番台（サーバーエラー）: 送信失敗として扱われ、自動再送の対象となります（詳細は「エラー時の挙動」を参照）。

Webhookを正常に受信できた場合は、200-299のステータスコードを返すことを推奨します。

レスポンスヘッダ

クラウドサインの Webhook は HTTP レスポンスヘッダを参照しません。

#### レスポンスボディ

クラウドサインの Webhook は HTTP レスポンスボディを参照しません。

---

エラー時の挙動

 

クラウドサインの Webhook では、接続先URLから500番台のHTTPステータスコードが返された場合、10分間隔で最大3回まで自動再送を行います。

---

Webhookの実行に失敗する場合

Webhookの実行が失敗する場合はいくつかの原因が考えられます。下記をご確認ください。

- Webhook URLの設定

    - Webhook URLが設定されていることや設定したWebhook URLに誤りがないかをご確認ください。
    - Webhook URLの設定方法は「[Webhook 機能](https://help.cloudsign.jp/ja/articles/417935?hsLang=ja)」をご確認ください。
- サーバーの証明書

    - Webhookを受信するサーバーに証明書(中間CA証明書等)が正しく導入されているかをご確認ください。

 

- [よくある質問](https://help.cloudsign.jp/ja/%E3%82%88%E3%81%8F%E3%81%82%E3%82%8B%E8%B3%AA%E5%95%8F?hsLang=ja#main-content)

    - [クラウドサインについて](https://help.cloudsign.jp/ja/%E3%82%88%E3%81%8F%E3%81%82%E3%82%8B%E8%B3%AA%E5%95%8F?hsLang=ja#%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89%E3%82%B5%E3%82%A4%E3%83%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)
    - [書類について](https://help.cloudsign.jp/ja/%E3%82%88%E3%81%8F%E3%81%82%E3%82%8B%E8%B3%AA%E5%95%8F?hsLang=ja#%E6%9B%B8%E9%A1%9E%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)
    - [操作方法について](https://help.cloudsign.jp/ja/%E3%82%88%E3%81%8F%E3%81%82%E3%82%8B%E8%B3%AA%E5%95%8F?hsLang=ja#%E6%93%8D%E4%BD%9C%E6%96%B9%E6%B3%95%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)
    - [通知メールについて](https://help.cloudsign.jp/ja/%E3%82%88%E3%81%8F%E3%81%82%E3%82%8B%E8%B3%AA%E5%95%8F?hsLang=ja#%E9%80%9A%E7%9F%A5%E3%83%A1%E3%83%BC%E3%83%AB%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)
- [プラン](https://help.cloudsign.jp/ja/%E3%83%97%E3%83%A9%E3%83%B3?hsLang=ja#main-content)

    - [無料プラン](https://help.cloudsign.jp/ja/%E3%83%97%E3%83%A9%E3%83%B3?hsLang=ja#%E7%84%A1%E6%96%99%E3%83%97%E3%83%A9%E3%83%B3)
    - [有料プラン](https://help.cloudsign.jp/ja/%E3%83%97%E3%83%A9%E3%83%B3?hsLang=ja#%E6%9C%89%E6%96%99%E3%83%97%E3%83%A9%E3%83%B3)
    - [無料オプション](https://help.cloudsign.jp/ja/%E3%83%97%E3%83%A9%E3%83%B3?hsLang=ja#%E7%84%A1%E6%96%99%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3)
    - [有料オプション](https://help.cloudsign.jp/ja/%E3%83%97%E3%83%A9%E3%83%B3?hsLang=ja#%E6%9C%89%E6%96%99%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3)
    - [連携プラン](https://help.cloudsign.jp/ja/%E3%83%97%E3%83%A9%E3%83%B3?hsLang=ja#%E9%80%A3%E6%90%BA%E3%83%97%E3%83%A9%E3%83%B3)
- [メールアドレス・ログイン関連](https://help.cloudsign.jp/ja/%E3%83%A1%E3%83%BC%E3%83%AB%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9-%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E9%96%A2%E9%80%A3?hsLang=ja#main-content)

    - [ログイン関連](https://help.cloudsign.jp/ja/%E3%83%A1%E3%83%BC%E3%83%AB%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9-%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E9%96%A2%E9%80%A3?hsLang=ja#%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E9%96%A2%E9%80%A3)
- [書類を送信する](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E9%80%81%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#main-content)

    - [書類のアップロード・編集](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E9%80%81%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#%E6%9B%B8%E9%A1%9E%E3%81%AE%E3%82%A2%E3%83%83%E3%83%97%E3%83%AD%E3%83%BC%E3%83%89-%E7%B7%A8%E9%9B%86)
    - [宛先設定](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E9%80%81%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#%E5%AE%9B%E5%85%88%E8%A8%AD%E5%AE%9A)
    - [一括送信](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E9%80%81%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#%E4%B8%80%E6%8B%AC%E9%80%81%E4%BF%A1)
    - [送信時の設定](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E9%80%81%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#%E9%80%81%E4%BF%A1%E6%99%82%E3%81%AE%E8%A8%AD%E5%AE%9A)
    - [送信後の操作](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E9%80%81%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#%E9%80%81%E4%BF%A1%E5%BE%8C%E3%81%AE%E6%93%8D%E4%BD%9C)
    - [テンプレート](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E9%80%81%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88)
- [書類を受信する](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E5%8F%97%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#main-content)

    - [受信者ガイド](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E5%8F%97%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#%E5%8F%97%E4%BF%A1%E8%80%85%E3%82%AC%E3%82%A4%E3%83%89)
    - [書類の受信](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E5%8F%97%E4%BF%A1%E3%81%99%E3%82%8B?hsLang=ja#%E6%9B%B8%E9%A1%9E%E3%81%AE%E5%8F%97%E4%BF%A1)
- [書類を管理する](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B?hsLang=ja#main-content)

    - [書類の確認](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B?hsLang=ja#%E6%9B%B8%E9%A1%9E%E3%81%AE%E7%A2%BA%E8%AA%8D)
    - [書類情報の入力](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B?hsLang=ja#%E6%9B%B8%E9%A1%9E%E6%83%85%E5%A0%B1%E3%81%AE%E5%85%A5%E5%8A%9B)
    - [書類インポート](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B?hsLang=ja#%E6%9B%B8%E9%A1%9E%E3%82%A4%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%88)
    - [複数部署管理](https://help.cloudsign.jp/ja/%E6%9B%B8%E9%A1%9E%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B?hsLang=ja#%E8%A4%87%E6%95%B0%E9%83%A8%E7%BD%B2%E7%AE%A1%E7%90%86)
- [設定・権限](https://help.cloudsign.jp/ja/%E8%A8%AD%E5%AE%9A-%E6%A8%A9%E9%99%90?hsLang=ja#main-content)

    - [個人設定](https://help.cloudsign.jp/ja/%E8%A8%AD%E5%AE%9A-%E6%A8%A9%E9%99%90?hsLang=ja#%E5%80%8B%E4%BA%BA%E8%A8%AD%E5%AE%9A)
    - [管理者向け設定](https://help.cloudsign.jp/ja/%E8%A8%AD%E5%AE%9A-%E6%A8%A9%E9%99%90?hsLang=ja#%E7%AE%A1%E7%90%86%E8%80%85%E5%90%91%E3%81%91%E8%A8%AD%E5%AE%9A)
    - [高度な設定をする](https://help.cloudsign.jp/ja/%E8%A8%AD%E5%AE%9A-%E6%A8%A9%E9%99%90?hsLang=ja#%E9%AB%98%E5%BA%A6%E3%81%AA%E8%A8%AD%E5%AE%9A%E3%82%92%E3%81%99%E3%82%8B)
- [電子署名](https://help.cloudsign.jp/ja/%E9%9B%BB%E5%AD%90%E7%BD%B2%E5%90%8D?hsLang=ja)
- [API・外部サービス連携](https://help.cloudsign.jp/ja/api-%E5%A4%96%E9%83%A8%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E9%80%A3%E6%90%BA?hsLang=ja#main-content)

    - [Web API](https://help.cloudsign.jp/ja/api-%E5%A4%96%E9%83%A8%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E9%80%A3%E6%90%BA?hsLang=ja#web-api)
    - [外部連携](https://help.cloudsign.jp/ja/api-%E5%A4%96%E9%83%A8%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E9%80%A3%E6%90%BA?hsLang=ja#%E5%A4%96%E9%83%A8%E9%80%A3%E6%90%BA)
    - [クラウドサイン ペイメント](https://help.cloudsign.jp/ja/api-%E5%A4%96%E9%83%A8%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E9%80%A3%E6%90%BA?hsLang=ja#%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89%E3%82%B5%E3%82%A4%E3%83%B3-%E3%83%9A%E3%82%A4%E3%83%A1%E3%83%B3%E3%83%88)
    - [法律](https://help.cloudsign.jp/ja/api-%E5%A4%96%E9%83%A8%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E9%80%A3%E6%90%BA?hsLang=ja#%E6%B3%95%E5%BE%8B)
- [セキュリティ](https://help.cloudsign.jp/ja/%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3?hsLang=ja)
- [トラブルシューティング](https://help.cloudsign.jp/ja/%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0?hsLang=ja#main-content)

    - [ログイン関連](https://help.cloudsign.jp/ja/%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0?hsLang=ja#%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E9%96%A2%E9%80%A3)
    - [メール送受信関連](https://help.cloudsign.jp/ja/%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0?hsLang=ja#%E3%83%A1%E3%83%BC%E3%83%AB%E9%80%81%E5%8F%97%E4%BF%A1%E9%96%A2%E9%80%A3)
    - [入力項目・同意関連](https://help.cloudsign.jp/ja/%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0?hsLang=ja#%E5%85%A5%E5%8A%9B%E9%A0%85%E7%9B%AE-%E5%90%8C%E6%84%8F%E9%96%A2%E9%80%A3)
    - [PDF・署名関連](https://help.cloudsign.jp/ja/%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0?hsLang=ja#pdf-%E7%BD%B2%E5%90%8D%E9%96%A2%E9%80%A3)
    - [宛先設定・書類情報関連](https://help.cloudsign.jp/ja/%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0?hsLang=ja#%E5%AE%9B%E5%85%88%E8%A8%AD%E5%AE%9A-%E6%9B%B8%E9%A1%9E%E6%83%85%E5%A0%B1%E9%96%A2%E9%80%A3)
    - [Web API関連](https://help.cloudsign.jp/ja/%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0?hsLang=ja#web-api%E9%96%A2%E9%80%A3)
    - [その他](https://help.cloudsign.jp/ja/%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0?hsLang=ja#%E3%81%9D%E3%81%AE%E4%BB%96)

[![クラウドサイン ヘルプセンター](https://help.cloudsign.jp/hs-fs/hubfs/%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89%E3%82%B5%E3%82%A4%E3%83%B3_logo_horizontal_color_RGB@4x.png?width=170&height=40&name=%E3%82%AF%E3%83%A9%E3%82%A6%E3%83%89%E3%82%B5%E3%82%A4%E3%83%B3_logo_horizontal_color_RGB@4x.png "クラウドサイン ヘルプセンター")](https://www.cloudsign.jp/)

© 2015 Bengo4.com, Inc.