PipedriveをElidoに接続する

Pipedrive連携は、Elidoがコンバージョンイベントまたはリンクがクリックしきい値を超えた際に、取引を作成してステージを更新します。APIトークンベース — OAuthもアプリ登録も不要です。

PipedriveのAPIトークンを取得する#

1. Pipedriveにログインします。
2. アバターをクリック → Personal preferences → API。
3. 表示されているトークンをコピーします。40文字の16進数文字列です。OAuthクライアントシークレットと混同しないでください。これはアカウントに紐付いた個人トークンです。

Elidoで設定する#

1. Dashboard → Webhooks → Add Pipedrive に移動します。
2. APIトークンを貼り付けます。Fetch pipelines をクリックします — ElidoはPipedrive APIにクエリを送り、アカウントで見られるすべてのパイプラインを一覧表示します。
3. 対象パイプラインと新規取引のデフォルト取引ステージを選択します。
4. （任意）自動作成された取引の担当者ユーザーを選択します。
5. Save をクリックします。

トリガーを設定する#

Dashboard → Webhooks → Pipedrive → Triggers で、Pipedriveアクションを発火させるものを設定します：

• Conversion recorded → 新しい取引を作成します。取引タイトルはリンクのスラグとUTMキャンペーン（存在する場合）に設定されます（例：spring-2026 / newsletter）。値フィールドはコンバージョンで宣言された value と currency から設定されます。
• Threshold exceeded → 既存の取引を次のステージに移動します。Elidoは取引のカスタムフィールドに保存されたリンクの click_id で照合します（以下のステップ3で設定します）。
• Scan failure → 「Needs review」ラベル付きの取引を作成します。フラグが立てられたリンクが手動フォローアップが必要な営業資産である場合に使用します。

click_idカスタムフィールドを追加する（しきい値トリガー用）#

しきい値からステージへの移動を機能させるには、PipedriveがElido click_id を取引に保存して、Elidoが後で検索できるようにする必要があります。

1. Pipedriveで Settings → Data fields → Deals → Add custom field に移動します。
2. タイプ：Text、ラベル：Elido Click ID。
3. フィールドキーをコピーします（Pipedriveはフィールドリストに表示します、例：8b2a4c...）。
4. Dashboard → Webhooks → Pipedrive → Click ID field key に貼り付けます。

同期されないもの#

• 過去の取引 — Elidoは接続後に発生するイベントからのみ取引を作成します。
• Pipedrive → Elido — 一方向のみ。Pipedriveでの取引ステージ変更はElidoのリンクに影響しません。

トラブルシューティング#

「401 Unauthorized」 — APIトークンが間違っています。ブラウザで https://api.pipedrive.com/v1/users/me?api_token=TOKEN を呼び出して確認してください。ユーザープロフィールが表示されれば、トークンは有効です。

パイプラインがリストに表示されない — Pipedriveユーザーがそのパイプラインへのアクセスがない可能性があります。Pipedriveの表示設定でチームごとにパイプラインアクセスを制限できます。Pipedriveの管理者に確認してください。

所有者なしで取引が作成される — ElidoのコンフィギュレーションでOwnerフィールドが空白の場合、取引はAPIトークンを使用したユーザーにデフォルトで割り当てられます。他の場所に割り当てたい場合は明示的に所有者を設定してください。

重複した取引 — 各コンバージョンイベントが1つの取引を作成します。重複が表示される場合は、同じElidoワークスペースが2つのPipedrive接続で設定されているか確認してください（統合を再追加した場合はまれに発生）。