Make und Zapier verbinden Programme, die nichts voneinander wissen. Livo spricht mit beiden über zwei Wege: Webhooks (Livo meldet sich, sobald etwas passiert) und die Schnittstelle (Make oder Zapier fragt Livo oder legt etwas an). Beides gehört zum Zubuchmodul „Schnittstelle/API“; einrichten kann es nur der Inhaber unter Einstellungen → Schnittstellen. Livo steht nicht im App-Verzeichnis von Make oder Zapier — Sie benutzen dort die allgemeinen Bausteine für Webhooks und HTTP-Aufrufe.
Was Livo meldet
- anfrage.neu, angebot.angenommen, angebot.abgelehnt, rechnung.bezahlt, termin.verschoben
- kunde.neu, auftrag.neu, angebot.erstellt (festgeschrieben, mit Nummer), rechnung.erstellt, termin.neu
Massenvorgänge (Kunden-Import, Umzug aus einer anderen Software, Serientermine) melden nichts — sonst kämen tausend Aufrufe auf einmal.
Vorlage 1 (Make): Neuer Auftrag → Zeile in einer Tabelle
- In Make ein neues Szenario anlegen, erster Baustein „Webhooks“ → „Custom webhook“, „Add“, die angezeigte Adresse kopieren.
- In Livo unter Einstellungen → Schnittstellen → Webhooks ein Ziel anlegen: diese Adresse eintragen, Ereignis „auftrag.neu“ wählen, speichern.
- In Make „Redetermine data structure“ klicken und in Livo einen Probe-Auftrag anlegen. Make erkennt jetzt die Felder (titel, status, kunde, auftrag_id).
- Zweiter Baustein: Ihre Tabelle (z. B. „Add a row“) — die Felder aus „daten“ zuordnen, Szenario einschalten.
Vorlage 2 (Zapier): Rechnung festgeschrieben → Nachricht ans Büro
- Neuer Zap, Auslöser „Webhooks by Zapier“ → „Catch Hook“, Adresse kopieren.
- In Livo ein Webhook-Ziel mit dieser Adresse und dem Ereignis „rechnung.erstellt“ anlegen.
- Eine Rechnung festschreiben, in Zapier „Test trigger“ — die Felder nummer, kunde, brutto_cent und faellig stehen bereit.
- Aktion wählen (Mail, Chat, Tabelle). Beträge kommen in Cent: 458900 sind 4.589,00 €.
Vorlage 3: Anfragen von einem anderen Formular anlegen
- In Livo einen Schlüssel mit dem Recht „Anfragen“ anlegen (er kann nichts lesen).
- Make: Baustein „HTTP“ → „Make a request“; Zapier: „Webhooks by Zapier“ → „POST“ bzw. „Custom Request“.
- Adresse https://livogroup.de/api/v1/handwerk/anfragen, Methode POST, Kopfzeile Authorization: Bearer livo_hw_…, Inhalt JSON mit name und email oder telefon (dazu betreff, nachricht, strasse, plz, ort).
- Eine Kopfzeile Idempotency-Key mit einer festen Kennung je Formulareingang verhindert doppelte Aufträge, wenn Make oder Zapier wiederholt.
Vorlage 4 (Zapier): Neue Kunden regelmäßig abfragen
- Schlüssel mit dem Recht „Lesen“ anlegen.
- Auslöser „Webhooks by Zapier“ → „Retrieve Poll“: Adresse https://livogroup.de/api/v1/handwerk/kunden?neueste=1, Kopfzeile Authorization: Bearer livo_hw_…, als Schlüssel der Liste „daten“, zum Erkennen neuer Einträge „id“.
- Für Termine dasselbe mit /api/v1/handwerk/termine?neueste=1.
Verbindung prüfen
GET https://livogroup.de/api/v1/handwerk/ich mit Ihrem Schlüssel antwortet mit dem Namen Ihres Betriebs und dem Recht des Schlüssels — ohne Kundendaten. Die vollständige Beschreibung aller Aufrufe und Meldungen liegt als OpenAPI-Datei unter https://livogroup.de/api/v1/handwerk/openapi.json; viele Werkzeuge lesen sie direkt ein.
Sicherheit und Wiederholung
Jede Meldung trägt die Kopfzeile X-Livo-Signatur (HMAC-SHA256 über den Inhalt mit dem Geheimnis des Ziels) und X-Livo-Zustellung (bleibt bei einer Wiederholung gleich). Make und Zapier prüfen die Signatur nicht von selbst; behandeln Sie die Webhook-Adresse deshalb wie ein Passwort. Antwortet das Ziel nicht binnen 5 Sekunden mit Erfolg, versucht Livo es mit wachsendem Abstand bis zu sechsmal; danach steht die Meldung im Lieferprotokoll und lässt sich von Hand neu senden.