Zapier

Zapier nutzt dieselbe REST API wie deine eigenen Skripte. Du brauchst einen Growth- oder Ultimate-Workspace und ein API-Token aus Integrationen → Zapier (oder API – es ist dasselbe Token).

App verbinden

1. Füge in Zapier die Letlink-Verbindung hinzu und füge das API-Token ein, wenn du danach gefragt wirst.
2. Zapier ruft GET /api/v1/auth/me auf, um es zu prüfen.
3. Wenn der Test mit 403 fehlschlägt, enthält der Tarif des Workspace die API noch nicht — upgrade auf Growth.

Trigger: Ein Link wird besucht

Das ist ein REST Hook für das Event link_visited. Wenn du den Zap aktivierst, sendet Zapier einen POST mit seiner Catch-URL an /api/v1/hooks/subscribe. Danach wird jeder erfasste Klick im Webhook-Payload-Format per POST gesendet (siehe Webhooks). Während du Felder zuordnest, ruft Zapier eventuell auch GET /api/v1/visits auf, um Beispielzeilen abzurufen – dieser Endpunkt liefert die letzten 50 Klicks im selben Format.

Nützliche Felder im Zap: link_shortcode, link_destination_url, visitor_device_type, visitor_browser, visitor_referrer, visitor_variation, utm_source, utm_campaign, instagram_username.

Aktion: einen Link erstellen

Entspricht POST /api/v1/links. Du kannst type, destination, short_code, title, domain und die Felder der Smart-Typen (ios_url, android_url usw.) übergeben. Smart-Typen im Free-Tarif und Workspaces über dem Limit geben einen Fehler im Ausführungsprotokoll des Zaps zurück.

Hinweise zum Betrieb

• Wenn du das Token in Letlink neu generierst, ist die Zapier-Verbindung unterbrochen, bis du den neuen Wert einfügst.
• Wenn du einen Zap ausschaltest, sollte der Hook abbestellt werden. Bleibt eine Catch-URL zurück, lösche sie unter Integrationen → Webhooks.
• Links mit viel Traffic lösen pro erfasstem Klick einen Zap-Lauf aus. Filtere in Zapier (zum Beispiel nur visitor_variation = qr), statt einen zweiten Kurzcode anzulegen.