クラウドサインの API で、締結済みの契約書をチャットから検索する方法|書類情報の更新まで

クラウドサインで契約を結ぶのは早くなっても、結んだあとの「あの契約はいつまでだったか」「金額はいくらだったか」を調べるには、管理画面で書類を 1 件ずつ開くことになります。書類情報(契約相手、契約期間、取引金額など)が空のままの書類も残りがちです。この記事はクラウドサインを使っている総務・法務・営業管理の人に向けて、締結済みの書類をチャットから検索し、書類情報を確認して直す手順を説明します。

結論

  • クラウドサインには公式の Web API があります。 使うにはクライアント ID が要り、公式ヘルプでは発行できるプランはスタンダード・コーポレート・ビジネス・エンタープライズです
  • Samurai App のクラウドサイン連携は、この Web API を各メンバーが自分のクライアント ID で呼びます。見られる書類はクラウドサインでの本人の権限と同じです
  • チャットからできるのは、書類の一覧と中身(宛先・状態・ファイル名)を見ることと、書類情報を見て更新すること です
  • 書類の送信・リマインド・却下・取消、書類やファイルの作成とダウンロードはできません。 契約を動かす操作はこれまでどおりクラウドサインの画面で行います

クラウドサインの書類を調べる 3 つの方法

クラウドサインの画面 Web API を自社で呼ぶ AI のチャットから呼ぶ
使える人 アカウントを持つ人 クライアント ID を発行できるプランの会社 同上。Samurai App で連携を有効にした会社
検索の仕方 画面の検索と絞り込み プログラムを書く 言葉で頼む
結果のまとめ方 人が書き写す プログラムで整える 表や文章で返る
手間 件数に比例する 作る手間と保守 設定は最初だけ

クラウドサインの画面で調べるのが基本です。件数が少ないうちはこれで足ります。

Web API を自社で呼ぶ と、書類の作成から送信までの操作をプログラムから実行できます。クラウドサインの公式ヘルプは Web API を「クラウドサインのサイト上でウェブブラウザを使って行ってきた書類の作成から送信までの操作を、プログラムから実行できるように用意したもの」と説明しています。仕様は SwaggerHub で公開されていて、呼ぶにはクライアント ID を管理画面で発行する必要があります。「クライアントID」の項目が表示されない場合は、対象のプランで Web API の利用設定が必要です。

AI のチャットから呼ぶ のは 2 つ目と同じ Web API を、プログラムを書かずに使う形です。Samurai App はこちらにあたります。

Samurai App でできること・できないこと

設定画面の「チャットからできること」に並ぶ 6 つの操作がすべてです。

見る(自分が閲覧できる書類だけ)

  • 自分がどのクラウドサインのユーザーとして操作するかを確認する
  • 自分の書類を一覧する。下書き・先方確認中・締結済などの状態で絞れます。1 ページは 100 件で、続きはページを指定して読みます。最後に処理された日で期間も絞れます
  • チームの書類を一覧する。クラウドサインの書類管理権限が必要です
  • 書類を 1 件開いて、宛先(名前・会社名・メールアドレス・順番・処理した日時・状態)、状態、ファイルの一覧を見る
  • 書類の書類情報を見る。管理用のタイトル、契約相手、締結日、契約開始日・終了日、解約通知期限、自動更新の有無、管理番号、取引金額です

更新する(既定では実行する前に確認が出ます)

  • 書類の書類情報を更新する。変える欄だけを送り、ほかの欄はそのまま残ります

できないこと

  • 書類の送信、リマインド、却下、取消
  • 書類やファイルの作成、PDF と合意締結証明書のダウンロード
  • 宛先のアクセスコード、電話番号、署名用の URL を読むこと。チャットには返しません
  • 他の人のクライアント ID で操作すること

ファイルの中身(契約書の本文)は読めません。読めるのはファイル名とページ数までです。

契約の期限と金額を、書類情報から調べる使い方

締結済みの書類は、書類情報に契約期間や解約通知期限が入っていれば、チャットで並べ替えて読めます。

  • 期限が近い契約を拾う。 「締結済の書類の書類情報を読んで、解約通知期限が来月までのものを、契約相手と自動更新の有無と一緒に表にして」と頼むと、書類ごとの書類情報を読んで表にします
  • 相手ごとに取引金額を足す。 「今年締結した書類のうち、契約相手が〇〇株式会社のものの取引金額を合計して」のように頼めます。書類情報に金額が入っていない書類は合計に入らないので、件数も一緒に出させると漏れに気づけます
  • 空欄を埋める。 「書類情報の契約相手が空の書類を一覧して。宛先の会社名を候補として横に並べて」と頼み、候補を確認してから更新を頼みます

書類が多いと、1 件ずつ書類情報を読む分だけ時間がかかります。「今年」「先月」のように期間を絞って頼むと、読む件数が減ります。

用意するもの

  • クラウドサインのクライアント ID を発行できるプランの契約(公式ヘルプではスタンダード・コーポレート・ビジネス・エンタープライズ)
  • Samurai App の管理者かマネージャー(クラウドサインを有効にする人)
  • チャットから使う各メンバーのクラウドサインのアカウント。Samurai App にサインインしているメールアドレスと同じメールアドレスのものです
  • チームの書類を一覧したい人は、クラウドサインの書類管理権限

手順

1. 管理者がクラウドサインを有効にする

「コネクタ」の画面(/settings/connections)を開き、「API 連携」タブの「API 連携を追加」からクラウドサインを選びます。環境(「本番」か「サンドボックス」)を選び、自分のクライアント ID を入れて「クラウドサインを有効にする」を押します。

ここで入れたクライアント ID は保存されません。つながるかどうかと、どのチームかを確認するためだけに使います。管理者もチャットから使うには、次の手順で自分のクライアント ID を登録します。

2. 各メンバーが自分のクライアント ID を登録する

  1. クラウドサインの管理画面で「クライアントID」を開き、「新しいクライアントIDを発行する」を押す
  2. Samurai App の「API 連携」タブでクラウドサインを開き、「自分のクライアント ID」の欄に貼って「自分のクライアント ID を登録する」を押す
  3. 「クラウドサインでは 〇〇 として操作します」と出れば完了です

登録できるのは、そのクライアント ID のクラウドサインのユーザーのメールアドレスが、Samurai App にサインインしているメールアドレスと同じときだけです。ほかのチームのクライアント ID も受け付けません。

クライアント ID は、それだけで本人になりすませる値です。 他の人のものを使わず、チャットの入力欄にも貼りません。クラウドサインの公式ヘルプも連携するサービスごとに別のクライアント ID を発行するよう勧めています。

3. チャットで頼む

まず、どのユーザーとして動いているかと、権限を確認します。

クラウドサインで、私がどのユーザーとして操作しているかと、持っている権限を教えて

次に、調べたいことを期間と一緒に頼みます。

今年締結した書類の一覧を出して、書類ごとに契約相手・契約終了日・解約通知期限・取引金額を表にして。
書類情報が空の欄は「未入力」と書いて

書類情報を直すときは、どの書類のどの欄を何にするかを書きます。

さっきの表の 3 行目の書類、契約相手を「株式会社サンプル」、管理番号を「2026-041」にして

既定では、更新の前に承認カードが出ます。書類名と変える欄を確認してから許可します。

注意点

書類情報の正しさは元の契約書で確認する。 チャットが読むのは書類情報の欄で、契約書の本文ではありません。空欄を埋めるときは、クラウドサインの画面で PDF を開いて確認してから更新を頼みます。

チームの書類の一覧には、クラウドサインの書類管理権限が必要です。 権限が無いと、自分の書類だけが対象です。どの権限を持っているかは、最初の確認で分かります。

エンタープライズプランでは、一部の操作が使えません。 クラウドサインの公式ヘルプでは、エンタープライズプランでは自分とチームの情報を返す操作(/me)と、チーム全員の書類の一覧(/team_documents)が使えないとされています。Samurai App は登録のときに /me で本人を確認するので、この操作が断られるアカウントは登録できず、「複数部署管理機能を使っているアカウントは、この連携に対応していません」と表示されます。

クライアント ID を削除すると、チャットから使えなくなります。 クラウドサインの公式ヘルプのとおり、連携中のクライアント ID を削除するとその連携も切れます。発行し直したときは、手順 2 で登録し直してください。自分の登録は「クライアント ID の登録を削除する」で外せます。管理者がクラウドサインを無効にすると、メンバー全員が登録したクライアント ID が破棄されます。この場合も、クラウドサインの書類はそのまま残ります。

よくある質問

チャットから契約書を送信できますか

できません。クラウドサインの Web API では、同じ呼び出しが下書きなら送信、先方確認中ならリマインドになるため、取り違えを事前に防げないからです。送信とリマインドは、クラウドサインの画面で行います。

契約書の本文を AI に読ませられますか

この連携ではできません。読めるのは書類情報と、ファイル名とページ数までです。本文を AI で読んで検索したい場合は、契約書の管理に LegalOn を使っていれば、LegalOn の API で契約書をチャットから検索する方法で説明している連携で本文を読めます。

サンドボックスで試せますか

管理者が有効にするときに、環境で「本番」か「サンドボックス」を選びます。選んだ環境のチームとして動きます。

他の人の書類も見られますか

クラウドサインで本人が見られる書類だけです。チームの書類を一覧するには、クラウドサインの書類管理権限が必要です。

出典

2026 年 11 月 9 日時点で、クラウドサイン ヘルプセンターの上の 2 ページを確認したものです。

関連する機能業務ツールとAIの連携 —— MCP接続と外部チャットSamurai App は業務ツールと AI を MCP 接続でつなぎます。会計や人事の SaaS を、チャットからその人の権限で操作できます。Slack や Teams から呼べて、外部の AI からも MCP で使えます。

ほかの自動化の例

    活用術の記事一覧へ

    日々の仕事が集まり、つながり、会社の力になる。

    資料請求Samurai App を開く

    デモを見る資料請求