連携
Zapier
記録された訪問ごとにZapを起動し、他のアプリから短縮リンクを作成します。
Zapierは、ご自身のスクリプトと同じREST APIを使用します。GrowthまたはUltimateのワークスペースと、連携 → Zapier（またはAPI — 同じトークンです）で取得したAPIトークンが必要です。
アプリを接続
- ZapierでLetlinkの接続を追加し、求められたらAPIトークンを貼り付けます。
- Zapierは
GET /api/v1/auth/meを呼び出してこれを検証します。 - テストが403で失敗する場合は、ワークスペースのプランにまだAPIが含まれていません — Growthにアップグレードしてください。
トリガー：リンクが訪問されたとき
これはイベントlink_visitedに対するREST Hookです。Zapをオンにすると、ZapierはCatch URLを添えて/api/v1/hooks/subscribeにPOSTします。その後、記録されたクリックはそれぞれWebhookのペイロード形式（Webhookを参照）でPOSTされます。フィールドのマッピング中、Zapierはサンプル行を取得するためにGET /api/v1/visitsを呼び出すこともあります — このエンドポイントは同じ形式で最新50件のクリックを返します。
Zapで便利なフィールド：link_shortcode、link_destination_url、visitor_device_type、visitor_browser、visitor_referrer、visitor_variation、utm_source、utm_campaign、instagram_username。
アクション：リンクを作成
POST /api/v1/linksに対応します。type、destination、short_code、title、domain、スマートタイプのフィールド（ios_url、android_urlなど）を渡せます。Freeプランでのスマートタイプや上限超過のワークスペースでは、Zapの実行ログにエラーが返されます。
運用上の注意
- Letlinkでトークンを再生成すると、新しい値を貼り付けるまでZapierの接続が切れます。
- Zapをオフにするとフックの購読も解除されるはずです。Catch URLが残っている場合は、連携 → Webhookで削除してください。
- トラフィックの多いリンクでは、記録されたクリックごとにZapが1回実行されます。2つ目の短縮コードを作るのではなく、Zapier側で絞り込んでください（例：
visitor_variation=qrのみ）。