Cord mit Make verbinden

Mit der Cord-App für Make starten Sie ein Szenario, wenn ein Angebot vorankommt, und erstellen oder aktualisieren Daten in Cord aus jeder anderen App heraus.

Verbinden

1. Öffnen Sie in Cord Einstellungen › Integrationen › Make und klicken Sie auf Cord in Make öffnen. Klicken Sie auf Install, wählen Sie Ihre Make-Organisation und bestätigen Sie. Make erlaubt die Installation von Apps nur Admins, Ownern oder App Developern dieser Organisation; wenn Sie keine dieser Rollen haben, bitten Sie jemanden, der sie hat.
2. Fügen Sie in Make innerhalb eines Szenarios ein Cord-Modul hinzu und klicken Sie auf Create a connection › Save.
3. Wählen Sie auf dem Bildschirm von Cord den Arbeitsbereich und klicken Sie auf Autorisieren. Es müssen keine Schlüssel erstellt oder eingefügt werden.

Zum Autorisieren benötigen Sie in diesem Arbeitsbereich Zugriff auf Einstellungen. Um den Zugriff zu entziehen, öffnen Sie den Tab Schlüssel der Entwickler-Workbench (der Link Autorisierte Verbindungen ansehen unter Einstellungen › Integrationen › Make führt Sie dorthin) und widerrufen die Verbindung von Make, die als Autorisierte Verbindung erscheint.

Was Sie tun können

• Sofort-Trigger: Watch Events, mit den Ereignissen von Cord, die Sie auswählen.
• Aktionen: Kunden erstellen, aktualisieren und abrufen; Angebote erstellen, abrufen und senden; sie als bezahlt markieren und Aufgaben erstellen.
• Suchen: Kunden und Angebote.
• Make an API Call: jede andere Operation der API von Cord.

Ohne die App zu installieren

Sie können Cord auch über zwei Module mit Make verbinden, die Make bereits mitbringt: Webhooks, um Ereignisse von Cord zu empfangen, und HTTP, um die API von Cord aufzurufen.

Ereignisse von Cord empfangen

1. Fügen Sie in Ihrem Make-Szenario das Modul Webhooks › Custom webhook hinzu, erstellen Sie einen Webhook und kopieren Sie die URL, die Make Ihnen gibt.
2. Aktivieren Sie in Cord den Entwicklermodus unter Ihr Konto › Präferenzen und öffnen Sie den Tab Webhooks der Workbench – die Schaltfläche Entwickler unten rechts.
3. Klicken Sie auf Endpoint hinzufügen, wählen Sie die Ereignisse aus, die Sie interessieren (z. B. quote.approved), fügen Sie die URL von Make ein und klicken Sie auf Endpoint erstellen.
4. Klicken Sie in Make auf Redetermine data structure und verwenden Sie in Cord die Schaltfläche Testen des Endpoints. Make lernt die Struktur des Ereignisses, und Sie können Felder wie data.folio, data.total oder data.cliente zuordnen.

Jedes Ereignis kommt mit id, event, created_at und data. Verwenden Sie die id, damit Sie dasselbe Ereignis nicht doppelt verarbeiten, wenn Cord die Zustellung wiederholt.

Make prüft die Signatur von Cord nicht für Sie. Behandeln Sie die URL des Webhooks als Geheimnis: Geben Sie sie nicht weiter, und wenn Sie vermuten, dass sie offengelegt wurde, löschen Sie den Endpoint in Cord und erstellen Sie einen neuen.

Jeder Endpoint zählt zum Webhook-Limit Ihres Tarifs.

Daten in Cord erstellen oder aktualisieren

1. Erstellen Sie in Cord im Tab Schlüssel der Entwickler-Workbench einen geheimen Schlüssel mit Schreibrecht.
2. Fügen Sie in Make das Modul HTTP › Make a request hinzu.
3. Konfigurieren Sie es so:
   • URL: den benötigten Endpoint, z. B. https://cordhq.app/api/v1/clientes.
   • Method: POST zum Erstellen, PATCH zum Aktualisieren.
   • Headers: Authorization mit dem Wert Bearer sk_live_... und Content-Type mit application/json.
   • Body type: Raw, Inhalt JSON, mit den Feldern der Ressource.
4. Wenn das Szenario Wiederholungen ausführen kann, fügen Sie den Header Idempotency-Key mit einem festen Wert pro Operation hinzu, z. B. die id des auslösenden Ereignisses. So legt eine Wiederholung den Datensatz nicht doppelt an.

Was Sie aus Make heraus tun können:

• Einen Kunden mit POST /api/v1/clientes erstellen oder mit PATCH /api/v1/clientes/{id} aktualisieren.
• Einen Kunden per E-Mail-Adresse mit GET /api/v1/clientes?email=... suchen.
• Ein Angebot mit POST /api/v1/cotizaciones erstellen.
• Es mit POST /api/v1/cotizaciones/{id} und action senden oder als bezahlt markieren.
• Eine Aufgabe mit POST /api/v1/tareas erstellen.

Die Felder jedes Endpoints finden Sie in der Dokumentation für Entwickler.