設定すること
- APIトークンとワークスペースIDを使った、ZapierとElidoワークスペースの接続。
- Gmailからのリンク短縮や、AirtableまたはTypeformからのリンク作成に使える、すぐに使えるZapパターン。
- どのレシピが予定されているか（クリックの記録とクリックしきい値のアラート）の明確な把握。
リンクを作成する以下のレシピは、Shorten URLアクションを使います。クリックイベントに依存するレシピは、予定として示しています。ZapierのWebhooks by ZapierとElidoのREST APIを使えば、現在でもどのレシピも構築できます。
まずElidoをZapierに接続する
- Elidoで、Settings → API Tokensからパーソナルアクセストークンを作成し、数値のワークスペースIDを控えます（ダッシュボードのURLに含まれています）。
- Zapierで、My Apps → Add Connection → 「Elido」を検索に進みます。
- APIトークンとワークスペースIDを貼り付けます。セルフホスト環境では、ベースURLも設定できます。
接続が完了しました。以下のすべてのレシピで、この接続を使います。
レシピ1：Gmailを送信したときにURLを短縮する
ユースケース： チームが長いURLを含むメールを送信します。送信前に自動で短縮します。
トリガー： Gmail → New Outbound Email
アクション： Elido → Shorten URL
| Zapierのフィールド | 値 |
|---|---|
| Destination URL | {{body_url}}（または件名/本文から抽出） |
| Custom Slug | 空欄のままにする（自動生成） |
| Tags | email-outbound |
注: Gmailは、メール本文のURLをそのままきれいなフィールドとして渡してくれません。トリガーとElidoアクションの間にZapierのFormatter → Text → Extract URLステップを入れて、メール本文から最初のURLを取り出してください。
レシピ2：すべてのクリックをGoogleスプレッドシートに記録する（予定）
ユースケース： 手動での分析や、Elidoにアクセスできないクライアントとの共有のために、フラットファイルのクリックログを保持します。
予定のトリガー： Elido → Link Clicked
フィルター（任意）： タグ = client-X のリンクのみ（ZapierのFilterステップを使用）。
アクション： Google Sheets → Append Row
| シートの列 | Elidoのフィールド |
|---|---|
| Timestamp | {{clicked_at}} |
| Slug | {{slug}} |
| Country | {{country}} |
| Device | {{device}} |
| Referrer | {{referrer}} |
クリックごとのイベントが提供されると、トラフィックの多いリンクはクリックごとに1件のイベントを発火し、多くのZapierタスクを消費します。フィルタリングやサンプリングを計画してください。
レシピ3：Airtableに行が追加されたら短縮リンクを作成する
ユースケース： マーケティングチームがAirtableでキャンペーンを管理しています。新しいキャンペーンの行ごとに、短縮リンクを自動生成します。
トリガー： Airtable → New Record（Campaignsテーブル内）
アクション： Elido → Shorten URL
| Zapierのフィールド | Airtableのフィールド |
|---|---|
| Destination URL | {{Campaign URL}} |
| Custom Slug | {{Slug}}（自動にする場合は空欄） |
| Tags | {{Campaign Name}} |
フォローアップアクション： Airtable → Update Record。Elidoの短縮URLを、Airtableの「Short Link」列に書き戻します。ZapierはShorten URLステップからスラッグを渡すので、それを使って短縮URLを組み立てます。
レシピ4：リンクがしきい値に達したらSlackに投稿する（予定）
ユースケース： ElidoのネイティブSlack連携を使わずに、キャンペーンのリンクが1,000クリックを超えたときにSlackでチームに知らせます。
予定のトリガー： Elido → Link Clicked（クライアント側でフィルターします。注を参照）
フィルター： Zapier Filter → {{click_count}} が 1000 より大きい場合のみ続行します。
アクション： Slack → Send Channel Message
メッセージのテンプレート：
:chart_with_upwards_trend: {{slug}} just hit {{click_count}} clicks! View analytics: {{analytics_url}}
ヒント: 使用量のアラートであれば、Webhooks by Zapierをトリガーにして、
usage.threshold_80とusage.threshold_100のWebhookイベントをすでに使えます。
レシピ5：Typeformの回答が届いたらリンクを作成する
ユースケース： チームがTypeformに入力して、キャンペーンのリンクを依頼します。フォームが送信されるたびに、自動でリンクを作成します。
トリガー： Typeform → New Entry
アクション： Elido → Shorten URL
| Zapierのフィールド | Typeformのフィールド |
|---|---|
| Destination URL | {{What is the destination URL?}} |
| Custom Slug | {{What slug do you want? (leave blank for auto)}} |
| Tags | {{Campaign name}} |
フォローアップアクション： Gmail → Send Email。作成された短縮URLを依頼者に通知します。
トラブルシューティング
新しいリンクでZapが起動しない。 Zapierの接続に入力したElidoワークスペースが、リンクを作成しているワークスペースと同じであることを確認してください。Zapは、入力したワークスペースIDに対してのみ起動します。
テスト時に「Authentication failed」と表示される。 ZapierでElidoアプリを再接続し（My Apps → Elido → Reconnect）、Elidoで古いトークンが失効している場合は新しいAPIトークンを貼り付けてください。
Shorten URLアクションが「slug taken」で失敗する。 上流のトリガーが重複して発火する可能性がある場合は、Shorten URLアクションの前にZapierのDelayステップ（1秒）を追加してください。または、一意に計算したスラッグを使います（Zapier Formatter → Date/Timeでタイムスタンプを付加）。
イベントが間違ったワークスペースで発火する。 各Zapier接続は、1つのElidoワークスペースにスコープされています。複数のワークスペースを対象にするには、それぞれにZapier接続を作成し、Zapを複製してください。