Zapier, Make und n8n anbinden

Eigene Apps für Zapier, Make oder n8n bietet scoco nicht an. Sie verbinden diese Werkzeuge über einen Webhook: scoco schickt jedes gewählte Ereignis als signiertes JSON an eine Adresse, die Ihr Werkzeug für Sie erzeugt. Danach wissen Sie, wie Sie den Endpunkt anlegen, die passenden Ereignisse wählen und die Verbindung in jedem der drei Werkzeuge herstellen.

Den Endpunkt in scoco anlegen

Erzeugen Sie zuerst in Ihrem Werkzeug eine Empfangsadresse, wie unten beschrieben. Dann:

1. Öffnen Sie Einstellungen›Integrationen und gehen Sie zur Karte Automatisierung.
2. Klicken Sie auf Webhook-Endpunkt. Das Fenster Webhook-Endpunkt anlegen öffnet sich.
3. Fügen Sie unter Adresse die Adresse aus Ihrem Werkzeug ein. Sie muss mit https:// beginnen.
4. Haken Sie unter Ereignisse an, was Sie brauchen. Ohne Auswahl schickt scoco alle Ereignisse.
5. Klicken Sie auf Anlegen.
6. Das Fenster Signaturschlüssel zeigt den Schlüssel genau einmal. Sichern Sie ihn mit Schlüssel kopieren und schließen Sie mit Ich habe den Schlüssel gesichert.
7. Klicken Sie beim neuen Endpunkt auf Testen. scoco schickt sofort ein signiertes Testereignis und zeigt, ob es angenommen wurde.

Welche Ereignisse Sie brauchen

• Zusammenfassung fertig: die Zusammenfassung eines Anrufs mit Name, Firma, Anliegen, Dringlichkeit und Rückrufnummer. Der übliche Auslöser für eine Tabelle, ein Ticket oder eine Nachricht an Ihr Team.
• Anruf beendet: kommt früher, aber ohne Zusammenfassung, mit Nummer, Dauer und Ergebnis.
• Termin gebucht, Termin abgesagt, Termin verschoben: Termine, die Ihre Assistenz gebucht hat, und Änderungen daran.
• Kontakt angelegt, Status geändert, Zugewiesen, SMS empfangen, SMS gesendet.

Wann jedes Ereignis kommt, steht in der Webhook-Dokumentation. Welche Felder es trägt, zeigt Ihr Werkzeug, sobald das erste echte Ereignis ankommt.

Zapier

1. Legen Sie einen Zap an und wählen Sie als Auslöser „Webhooks by Zapier" mit „Catch Hook".
2. Kopieren Sie die Webhook-Adresse, die Zapier anzeigt, und legen Sie damit den Endpunkt in scoco an.
3. Lösen Sie ein Ereignis aus und lassen Sie Zapier es im Testschritt abholen. Danach fügen Sie Ihre Aktionen hinzu.

„Webhooks by Zapier" gibt es laut Zapier nur in den bezahlten Tarifen, nicht im kostenlosen.

Make

1. Legen Sie ein Szenario an und wählen Sie als erstes Modul „Webhooks" mit „Custom webhook".
2. Legen Sie einen neuen Webhook an, kopieren Sie seine Adresse und legen Sie damit den Endpunkt in scoco an.
3. Make wartet auf die erste Nachricht und erkennt daraus die Felder. Lösen Sie dafür ein Ereignis aus.

n8n

1. Beginnen Sie den Workflow mit einem „Webhook"-Knoten und stellen Sie die HTTP-Methode auf POST. scoco sendet jedes Ereignis als POST.
2. Tragen Sie in scoco die Production-URL des Knotens ein und veröffentlichen Sie den Workflow (in älteren n8n-Versionen: aktivieren). Erst dann empfängt die Production-URL. Die Test-URL empfängt nur, solange Sie im Editor auf ein Testereignis warten.

Echte Daten für die Feldzuordnung

Testen schickt nur ein Testereignis vom Typ ping mit einer kurzen Textnachricht, ohne Anrufdaten. Damit Ihr Werkzeug die echten Felder kennt, lösen Sie ein echtes Ereignis aus: Rufen Sie Ihre scoco-Nummer von einem Telefon aus an. Testanrufe aus dem Dashboard lösen keine Ereignisse aus.

Signatur prüfen

Jede Nachricht trägt den Header X-Scoco-Signature mit Zeitstempel und HMAC-SHA256-Signatur, gebildet mit Ihrem Schlüssel. Wenn Ihr Werkzeug einen Code- oder Krypto-Schritt erlaubt, prüfen Sie sie dort. Rechnen Sie über den unveränderten Body, nicht über das bereits ausgelesene JSON, und lehnen Sie Nachrichten ab, die älter als etwa 5 Minuten sind. Formel und Beispielcode: Webhook-Dokumentation.

Häufige Probleme

Anlegen lässt sich nicht anklicken. Die Adresse beginnt nicht mit https://.

Der Test schlägt fehl. Die Meldung nennt den Grund, etwa eine HTTP-Antwort oder eine Zeitüberschreitung. Ihr Werkzeug muss innerhalb von 10 Sekunden antworten. Bei n8n prüfen Sie, ob die Production-URL eingetragen und der Workflow veröffentlicht ist.

Der Schlüssel ist verloren. scoco kann ihn nicht noch einmal anzeigen. Wählen Sie im Menü des Endpunkts Entfernen und legen Sie ihn neu an.

Es kommt nichts mehr an. Schlägt eine Zustellung fehl, versucht scoco es insgesamt bis zu 5-mal. Schlagen 20 Zustellungen in Folge über mindestens 24 Stunden fehl, wird der Endpunkt Deaktiviert, und der Inhaber bekommt eine E-Mail. Beheben Sie die Ursache und wählen Sie im Menü Aktivieren. Ereignisse aus der Zwischenzeit werden nicht nachgeliefert. Was zugestellt wurde, zeigt das Protokoll der letzten 30 Tage.