Setup

電子署名(Clicksign)

ご自身のClicksignアカウントを使って(BYOモデル)、見積書を電子署名用に送信します。

Clicksignとの電子署名連携は、あなた自身のClicksignアカウント(BYOモデル:自分のアカウントを持ち込む方式)を使用します。文書はあなたのClicksignアカウント内で作成され、課金もそちらで行われます。当社側でのコスト、マージン、仲介は一切発生しません。当社は項目と見積書を署名用に送信するボタンを接続するだけです。

この連携は最初は非活性の状態です。項目を入力して有効化するまで何も起こりません。アクセストークンとwebhookシークレットはCRM内で暗号化して保存され、再表示されることはありません。

前提条件

API権限を持つClicksignアカウント(テスト用のSandbox、または本番用のProduction)。
Clicksignダッシュボードへのアクセス権限(アクセストークンの生成:設定 → API)と、HMACシークレット付きのwebhookの作成。
Sellioにおいて、認証情報を保存し、設定 → 連携でこの連携を有効化するための管理者権限。

入力が必要な項目

環境:Sandbox(テスト用、sandbox.clicksign.com)またはProduction(本番用、app.clicksign.com)。環境ごとに固有のアクセストークンがあります。
アクセストークン:ClicksignダッシュボードのSettings → APIで生成されるAPIアクセストークン。呼び出しの認証に使われます(?access_token= 経由)。CRM内で暗号化して保存されます。
Webhookシークレット(HMAC):Clicksignでwebhookを作成する際に自分で設定するシークレット。Clicksignが送信するイベントのHMAC-SHA256署名を検証するために使用されます。CRM内で暗号化して保存されます。

設定方法

設定 → 連携を開き、「電子署名(Clicksign)」カードを見つけます。
環境を選択し、アクセストークンとWebhookシークレットを貼り付けて「認証情報を保存」をクリックします。
表示された「Webhook URL(Clicksign)」をコピーし、Clicksignの Settings → API/Webhooks で、そのURLを指定するwebhookを、まったく同じシークレットを使って作成します。
CRMに戻り、「有効化」をクリックします。

見積書を署名用に送信する方法

商談を開き、見積書セクションに移動します。
対象のバージョンで「署名」をクリックし、署名者のメールアドレス(任意で氏名も)を入力します。
DocuSignとClicksignの両方が同時に有効な場合は、2つのボタン(「DocuSignで送信」と「Clicksignで送信」)が表示されるので、Clicksignを選びます。Clicksignのみ有効な場合は、1つのボタンがそのまま使用されます。
CRMがClicksign上で文書を作成し、署名者を追加して署名を依頼します。Clicksignが署名者に署名依頼メールを送信します。
署名者の進捗に応じて、見積書の「署名」一覧にステータスが表示されます(送信済み → 到達済み → 署名済み)。

💡 文書が完全に署名されると(Clicksignの完了イベント)、そのリクエストが見積書に紐づいている場合、見積書は自動的に承諾済みとしてマークされます。Webhookの検証はHMAC-SHA256署名(Content-Hmacヘッダー)で行われ、シークレットが一致しない場合、イベントは拒否されます。Clicksignの設定が完了していない状態で送信しようとすると、CRMがはっきりと警告し、認証情報が設定されるまでこの機能は非活性のままです。

テスト方法

サンドボックス用のアクセストークンを使い、Sandbox環境を利用します。
ある見積書で「署名」をクリックし、署名者として自分自身のメールアドレスを入力して確定します。
Clicksignからのメールを受信し、「署名」一覧に「送信済み」と表示されることを確認します。
文書に署名し、ステータスが「署名済み」に進み、見積書が承諾済みとしてマークされることを確認します。これはwebhook(有効なHMAC付き)が到達したことの証拠です。

トラブルシューティング

送信時に401エラー:アクセストークンが間違っているか、別の環境のものです(サンドボックス用トークンを本番で使用している、またはその逆)。環境を確認し、その環境用のトークンを貼り直してください。
見積書のステータスが更新されない:webhookが到達していないか、署名検証に失敗しています。Clicksignのwebhookが「Webhook URL(Clicksign)」を指しており、CRMに保存されているものと完全に同じシークレットを使用しているか確認してください(Content-Hmacヘッダー、HMAC-SHA256)。
イベントが拒否される(無効な署名):ClicksignとCRMでwebhookシークレットが一致していません。両方に同じ値を保存してください。
送信しても何も起こらない:認証情報が不足しているため、連携が非活性か、有効化されていません。環境+トークン+シークレットを入力し、「有効化」をクリックしてください。

この記事をシステム内で開く →