NotionをElidoに接続する

Notion連携はベータ版のOAuth接続です。ワークスペースを接続し、Elidoが参照できるページとデータベースを選べます。Elidoはアクセストークンを保存します。行は作成されず、クリック数も書き込まれません。データベース同期は予定されています。以下では、現在動作する内容と、今すぐ組めるDIYの方法を紹介します。完全な手順はNotion database link syncをご覧ください。

現在できること

• Dashboard → Integrations → Notion → Connect からOAuthでワークスペースを接続する。
• Notionのページ選択画面で、Elidoがアクセスできるページとデータベースを選ぶ。選択していないものはElidoから見えません。
• 接続が有効かどうかを確認し、接続を解除する。解除するとElido側で失効済みになります。トークンを無効にするため、Notionの Settings → Connections でも接続を削除してください。

予定されていること

Notionのデータベースとあなたのリンクライブラリとの双方向同期です。スラッグ、宛先、タグ、クリック数を行として扱い、列のマッピングやNotionからのリンク作成に対応します。時期は決まっていません。

OAuthで接続する

1. Dashboard → Integrations → Notion → Connect を開きます。
2. NotionのOAuth画面が開きます。ワークスペースにアクセスできるアカウントでサインインします。
3. Notionのページ選択画面で、共有するページまたはデータベースを選びます。後から再認可なしで追加できます。
4. Allow access をクリックします。NotionからElidoに戻ります。

DIY：ElidoからNotionのテーブルを埋める

1. Notionで、タイトル列、URL列を2つ（短縮リンクと宛先）、数値列（クリック数）を持つデータベースを作成します。Notionで内部インテグレーションを作成し、データベースを共有します。
2. Elidoで Dashboard → Webhooks → Add → Generic を開き、link.created、link.updated、link.expired を有効にします。HMAC署名を検証し（Webhookガイドを参照）、その後Notion APIを呼び出して行を追加または更新する小さなスクリプトや自動化に向けます。
3. クリック数は、ElidoのアナリティクスAPIを読み取って数値列を更新する定期ジョブで反映します。クリックごとのWebhookはないため、リアルタイムでは反映できません。

NotionはAPIリクエストを1接続あたり毎秒約3件に制限しています。HTTP 429が返ったら、Retry-After ヘッダーの時間だけ待ってから再試行してください。

トラブルシューティング

データベースが選択画面に表示されない。 Notionには、明示的に許可したページしか表示されません。接続をやり直し、正しいページまたはデータベースを選択してください。

Notionに行やクリック数が表示されない。 想定どおりです。現時点では何も同期されません。上のDIYの方法をご利用ください。

OAuthが失効または期限切れ。 Notion側で接続を削除すると、トークンは使えなくなります。Dashboard → Integrations → Notion → Reconnect から再接続してください。