Pipedrive リンククリックトラッキング: 短縮リンクのヒットからディールを作成する

Elido における Pipedrive リンククリックトラッキングは、短縮リンクのマイルストーンをパイプラインのイベントに変換します。あなたのリンクのいずれかが100、1,000、10,000クリックを超えると、5分ごとの cron が、選択した Pipedrive パイプラインに、リンクのスラッグとマイルストーンをタイトルとしたディールを作成します。UTM ソースと Elido へのディープリンクを含むディールのノートは計画中です。間に Zapier を挟む必要はなく、手動でのエクスポートも、リンクレポートを確認するためのカレンダーリマインダーも不要です。

これが要点です。ですが、実際の仕組みの方が重要なので、この記事ではセールスオペレーションチームがこれを有効にする前に信頼できるようになっておくべき3つのことを順に説明します。まず、Connect フローが実際にどう動くか。Personal API トークンがどこに保存されるか、パイプライン選択画面が何を読み取っているか、貼り付け後にトークンがどう保存されるか。次に、しきい値の cron が実行のたびに何をしているか、そしてリンクが一晩でバズったときに重複したディールが作られないようにどう防いでいるか。最後に、3つのデフォルトのしきい値を超えて何を変更でき、何を変更できないか、そして今後何が計画されているかです。

Pipedrive は Elido において2026年5月22日に Live になりました。それ以前は2週間 Beta 状態にあり、ステージ ID やトークンのローテーション周りのエッジケースを洗い出していました。セルフホストしていてソースコードを読みたい場合、インテグレーションのコードは services/api-core/internal/integrations/pipedrive/ にあります。以下で計画段階であって未リリースのものについては、その都度そう明記します。

2分で Pipedrive を接続する

Elido ワークスペースでインテグレーションカタログを開き、Pipedrive のカードをクリックします。Connect モーダルはまず1つだけ、Personal API トークンを尋ねます。トークンは Pipedrive アカウントのプロフィールメニューを開き、Personal preferences、次に API タブから取得できます。Pipedrive の UI はおよそ四半期ごとに変わるため、Personal API トークンの見つけ方という Pipedrive 自身のガイドに、スクリーンショット付きの正確な手順が載っています。

トークンを貼り付けます。Elido は裏で2つのことを行います。Pipedrive API に対して GET /users/me を呼び出してトークンを検証し、トークンが有効であることと、そのトークンがどの Pipedrive 会社に属するかを確認します。またその会社のアクティブなパイプラインの一覧も取得するため、モーダルの次のステップには自由入力欄ではなく実際の選択肢が表示されます。

モーダルはさらにもう1つ、新しいディールをどのパイプラインに入れるかを尋ねます。ドロップダウンは実際の Pipedrive データから生成されます。Inbound、Outbound、Partners という3つのパイプラインがあれば、その3つが表示されます。用途に合ったもの、たいていはマーケティング由来のシグナルなら Inbound を選び、Connect をクリックします。ディールはそのパイプラインの最初のステージに入ります。別のターゲットステージを選べるようにする機能は計画中です。

Connect した後、トークンに何が起きるか。Elido は Postgres に触れる前にトークンを暗号化します。ワークスペースの KMS キーでラップされたテナントごとのデータ暗号化キーを使ったエンベロープ暗号化です。integration_credentials テーブルに保存されるのは、そのラップされたブロブです。平文のトークンは、1回の API 呼び出しの間だけメモリ上に存在し、デバッグレベルであってもログに記録することは決してありません。Pipedrive でトークンをローテーションすると、次の cron の実行は401を受け取り、Elido はインテグレーションを再認証が必要な状態としてマークします。これはワークスペースにバナーとして表示され、サイレントな失敗にはなりません。ローテーションの管理は利用者側の責任ですが、壊れたときはきちんと目立ちます。

パイプライン選択機能は、小さいながら重要な仕組みです。CRM インテグレーションにありがちな失敗パターンは、インテグレーションを構築した当時は会社にパイプラインが1つしかなかったのに、今では6つになっているせいで、間違ったパイプラインにディールが作成されてしまうことです。Connect 時にユーザー自身に選ばせ、1か月前にキャッシュした一覧ではなく現在の一覧を表示することで、このタイプのミスをまるごと排除できます。しきい値の履歴を失うことなく、いつでも再接続して選択先を変更することもできます。

5分ごとの cron が実際に行っていること

services/api-core の中に click_threshold_hook というジョブがあります。これは5分ごとに実行されます。ティックのたびに、Pipedrive が接続されている各ワークスペースについて、順番に3つのことを行います。

まず、ワークスペースのアクティブなリンクを一覧取得し、それぞれの累積クリックカウンター、つまりリダイレクトサービスがクリックのたびにインクリメントしているのと同じカウンターを読み取ります。削除済みおよび無効なリンクはスキップされます。

次に、各リンクの新しい合計値を、記録済みのしきい値と比較します。デフォルトのしきい値は100、1,000、10,000です。リンクごとに、すでにディールを作成済みのしきい値はすべて、ワークスペース、リンク、しきい値をキーとする integration_pipedrive_deals の行に記録されます。前回の実行時に80クリックだったリンクが今は240クリックになっている場合、差分は100のしきい値を超えたが1,000にはまだ達していないことを示します。この場合100を到達済みとしてマークし、ディール作成を1件キューに入れます。もしリンクが80から1,200にジャンプしていれば、100と1,000の両方を超えているので、2件のディール作成をキューに入れます。

3つ目に、キューに入った各ディールについて、Elido は Pipedrive のDeals APIに対して /deals への POST を呼び出します。リクエストボディには Connect の選択画面で選んだパイプライン ID を設定し、ディール名を Engagement: <slug> (<threshold> clicks) とし、値はゼロのままにします。UTM のソース、メディア、キャンペーンを Elido の分析ビューへのリンクとともにディールのノートに書き込むことは計画されており、リンク ID を Pipedrive のカスタムフィールドに保存することも同様に計画されています。

この cron が行わないことがいくつかあります。1回のティック内でのリトライは行いません。Pipedrive がエラーを返した場合、そのしきい値については何も記録されず、次のティックが単純に再試行します。Pipedrive のレート制限は実際には会社トークンあたり2秒間に100リクエストで、ほとんどのチームが到達するであろう量に対しては十分な余裕があります。また、アクティブなリンクしか見ないため、削除済みや無効なリンクがディールを作ることは決してありません。

重複防止はそのテーブルによって成り立っています。各作成の前に、cron は既存の (workspace_id, link_id, threshold_bucket) の行を確認し、その後の挿入は同じ3つの列に対するユニーク制約で保護されているため、クラッシュと再実行が同じマイルストーンに対して2つ目のディールを生み出すことはありません。

3つのデフォルトを超えて拡張する

リリース済みのしきい値は100、1,000、10,000です。多くのチームはこれらをそのまま使っています。営業のストーリーに自然に対応しているためです。100クリックはひと目見る価値のある弱いシグナルです。1,000は電話をかける価値のあるキャンペーンです。10,000は、すでに担当者が動き出しているべきほど強いシグナルです。とはいえ、別の数値を使いたい場合もあるでしょうが、現状は設定できません。

Elido のPipedrive インテグレーションは、すべてのワークスペースで同じ3つのバケットを使用しており、カスタムのしきい値リスト用のエンドポイントや設定はまだありません。

より高度なトリガーはリリース済みではなくロードマップ上にあります。インテグレーションの計画には、ディール候補の UTM を持つキャンペーンに絞ったしきい値トリガーや、取得した注文金額を持つディールを作成するコンバージョントリガーが含まれています。ユーザーが設定可能なターゲットステージや、Deal Source や Lead Channel のような Pipedrive のカスタムフィールドも、次のバージョンで計画されています。それらがリリースされるまでは、UTM フィルターやフォルダのロールアップが必要な場合、自分のジョブから Elido の analytics API をポーリングし、Pipedrive の API を通じて自分でディールを作成してください。

トークンはどこに保存され、どうローテーションするか

セキュリティレビューのたびに必ず聞かれる話なので、ここで短くまとめておきます。Personal API トークンは、テナントごとのデータ暗号化キーを使った AES-256-GCM で保存時に暗号化されます。その DEK 自体も、私たちの KMS 内のワークスペースレベルのキーでラップされており、アンラップできるのは api-core プロセスだけです。トークンが平文のままログ、バックアップ、エラートレースのいずれかに残ることはありません。リクエストの途中で強制的に Pipedrive の401を発生させるフォールトインジェクションでこれをテストしており、エラー経路はレスポンスが Sentry に届く前にトークンを取り除きます。

ローテーションの手順です。Pipedrive で新しい Personal API トークンを生成し、古いものを取り消してから、新しいトークンを再度 Elido の Connect モーダルに貼り付けます。インテグレーションは新しいトークンを検証してその場で入れ替え、次の cron のティックからそれを使います。古いトークンを取り消した後に Elido の更新を忘れると、次の cron のティックは401を受け取り、インテグレーションはワークスペースのダッシュボードに黄色いバナーとして表示される Needs Reauth 状態になります。サイレントに死んだトークンが残ることはありません。

セルフホストの場合、KMS はプラグイン可能です。デフォルトはファイルベースで、HashiCorp Vault や自社のクラウド KMS に差し替えることもできます。詳しい内容は ADR-0036 にまとめられています。

より大きなファネルにおける位置付け

クリックから発生する Pipedrive のディールトリガーは、より大きなパターンの一部にすぎません。クリック数は先行指標であり売上の数字そのものではないため、通常は残りの営業コンテキストが存在する CRM へ流し込みたいものです。ディールは引き継ぎのポイントです。マーケティングが仕事を終え、営業がそれを受け取ります。そこから先は、担当者へのディールの割り当て、スコアリング、ステージの移動、クローズといった、通常の Pipedrive のワークフローが引き継ぎます。

コンバージョンを広告プラットフォームにも転送している場合、同じクリックデータが両方のフローに供給されます。コンバージョントラッキング機能が広告側を、Pipedrive インテグレーションが CRM 側を担当し、両者が同じイベントを取り合うことはありません。この組み合わせは、有料獲得からブランド化されたリンク、そして CRM ファネルへと続く一連のスタック全体が使われているマーケター向けソリューションページで最もよく見られます。

数字を正確に保ちたいアナリストのために、上流の懸念を扱った以前の記事が2つあります。短縮リンク分析: 何を測定すべきかは、どのクリック指標が実際に売上と相関するかを扱い、UTM をエンドツーエンドで追跡するは、ディールのノートをノイズではなく有用なものにする UTM の衛生管理を扱います。Pipedrive が作成するディールは、そこに含まれる UTM データの質と同じだけしか役に立たないため、どちらもこのインテグレーションとよく組み合わさります。

プランについて最後に1点。Pipedrive インテグレーションはすべての Elido の有料ティアに含まれており、14日間のトライアルにも含まれているため、契約前にしきい値のリストを検証できます。無料ワークスペースでもテスト用に接続を作成できますが、無料リンクに対して cron は発火しません。ティアごとの内訳は料金ページにあります。

セットアップチェックリスト

これを印刷して、一度だけ実行してください。

1. Pipedrive で: プロフィールメニュー、Personal preferences、API タブの順に進み、トークンをコピーする。
2. Elido で: Integrations、Pipedrive のカード、Connect の順に進む。
3. トークンを貼り付ける。検証が終わるのを待つ。
4. パイプラインを選ぶ。デフォルトは Inbound で、ディールはその最初のステージに入る。
5. Connect をクリックする。
6. 5分待つ。テストのクリックをいくつか送る。最初のディールが作成されるのを確認する。

以上です。セルフホストしている場合、cron は別のジョブとしてではなく api-core プロセス内で実行され、Redis の接続とシークレットのマスターキーの設定が必要です。どちらか一方でも欠けていると、静かにスキップされます。Elido Cloud ではこの cron は管理された状態で提供されます。