Zum Inhalt springen
DEEN

Make

Bringen Sie, was in Cord passiert, in jede App von Make, und legen Sie aus Ihren Szenarien Daten in Cord an.

Was es tut

Die Cord-App für Make hat einen Sofort-Trigger (Watch Events), Aktionen zum Anlegen und Ändern von Daten in Cord, Suchen mit Paginierung und ein universelles Modul für jede weitere Operation der API. Sie wird mit einem Klick auf einer Seite von Cord autorisiert, ohne Schlüssel, und funktioniert in allen Make-Zonen.

Voraussetzungen

Wo Was Sie brauchen
Cord Die Berechtigung Einstellungen in dem Arbeitsbereich, den Sie verbinden. Jeder Tarif.
Make Ein Make-Konto. Um die App zu installieren, müssen Sie Admin, Owner oder App Developer dieser Make-Organisation sein. Die Operationen, die Ihre Szenarien verbrauchen, rechnet Make nach Ihrem Make-Tarif ab.
Kontingent Jedes Aktions- oder Suchmodul verbraucht Aufrufe aus dem monatlichen API-Kontingent Ihres Cord-Tarifs. Siehe Limits.

Die Cord-App verbinden

Die Cord-App für Make wird per Einladung freigegeben. Unter Einstellungen › Integrationen › Make finden Sie die Schaltfläche Cord in Make öffnen, die direkt zur Einladung führt.

  1. Installieren Sie die App. Klicken Sie auf Cord in Make öffnen, dann 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.
  2. Legen Sie die Verbindung an. Fügen Sie in einem Szenario ein beliebiges Cord-Modul hinzu und klicken Sie auf Create a connection › Save.
  3. Autorisieren Sie in Cord. Es öffnet sich eine Seite von Cord, auf der Sie den Arbeitsbereich wählen und auf Autorisieren klicken. Sie müssen keine Schlüssel erstellen oder einfügen.

Wer autorisiert, braucht Zugriff auf Einstellungen in diesem Arbeitsbereich. Make erneuert den Zugriff selbstständig; um ihn zu beenden, widerrufen Sie die Verbindung im Tab Schlüssel der Cord Workbench, wo sie als Autorisierte Verbindung von Make erscheint.

Typ Module
Sofort-Trigger Watch Events: Sie wählen die Cord-Ereignisse, und das Szenario startet, sobald sie eintreten.
Aktionen Create a Client, Update a Client, Get a Client, Create a Quote, Get a Quote, Send a Quote, Mark a Quote as Paid und Create a Task.
Suchen Search Clients und Search Quotes, mit Paginierung.
Universell Make an API Call, für jede weitere Operation der Cord-API.

Jedes aktive Watch Events legt einen eigenen Webhook in Cord an, mit einem Kontingent, das nicht auf die Endpoints Ihres Tarifs angerechnet wird.

Make-Szenario mit drei verketteten Modulen: Cord › Watch Events, Cord › Get a Client und Google Sheets › Add a Row. Geöffnet ist der Webhook des Auslösers mit der Verbindung „Cord (Materiales del Valle)“ und dem Ereignis „Quotes: Quote approved“.

Was in welche Richtung fließt

Richtung Was übertragen wird Wann
Von Cord zu Make Das Ereignis, das Sie in Watch Events gewählt haben, mit den Daten des Objekts. Sofort, jedes Mal, wenn es in Cord eintritt.
Von Make zu Cord Was das Modul tut: einen Kunden anlegen oder aktualisieren, ein Angebot erstellen oder senden, es als bezahlt markieren oder eine Aufgabe anlegen. Wenn das Szenario ausgeführt wird.
Suchen und Abfragen Make liest Kunden oder Angebote, um sie im nächsten Modul zu verwenden. Dabei wird nichts geändert. Wenn das Szenario ausgeführt wird.

Was ein Modul in Cord tut, löst dieselben Ereignisse aus, als hätte es eine Person getan, mit Ausgelöst von: Die API.

Limits

Limit Wert
API-Aufrufe pro Monat Kostenlos 100, Starter 1.000, Professional 5.000, Scale 10.000, Developer 50.000
Bei Überschreitung des Kontingents Im kostenlosen Tarif werden Aufrufe bis zum nächsten Monat abgelehnt; ab Starter werden sie als Mehrverbrauch berechnet, mit einer Sicherheitsgrenze beim Zehnfachen des enthaltenen Volumens
Webhooks, die Ihre Szenarien anlegen 100 pro Organisation, unabhängig von den Webhook-Endpoints Ihres Tarifs
Aktive autorisierte Verbindungen 25 pro App und Organisation
  • Was Kontingent verbraucht: jedes Aktions- oder Suchmodul und jedes Make an API Call sowie das Registrieren oder Löschen des Webhooks von Watch Events. Ereignisse zu empfangen verbraucht kein Kontingent.
  • Wie viel Sie verbraucht haben: unter Einstellungen › Tarif und Abonnement › Abonnement, Zeile API-Aufrufe.
  • Anfragen mit HTTP › Make a request und einem Schlüssel sk_live_… verbrauchen ebenfalls Kontingent; mit sk_test_… nicht.

Trennen

Ein Szenario ausschalten: Deaktivieren Sie es in Make. Damit Cord ihm keine Ereignisse mehr sendet, löschen Sie auch seinen Webhook im Bereich Webhooks von Make: Beim Löschen entfernt Make ihn aus Cord.

Den Zugriff von Make auf Cord beenden:

  1. Gehen Sie zu Einstellungen › Integrationen › Make und klicken Sie auf Autorisierte Verbindungen ansehen. Der Tab Schlüssel der Cord Workbench öffnet sich.
  2. Suchen Sie die Zeile Autorisierte Verbindung von Make mit dem Label OAuth.
  3. Klicken Sie auf Widerrufen und bestätigen Sie.

Ab diesem Moment kann Make mit dieser Verbindung die API nicht mehr aufrufen, und die Webhooks, die seine Szenarien angelegt hatten, empfangen keine Ereignisse mehr. In Make schlagen die Cord-Module mit einem Autorisierungsfehler fehl, bis Sie die Verbindung neu anlegen. Wenn Sie die Alternative mit Webhooks und HTTP verwendet haben, löschen Sie den Endpoint unter Webhooks und widerrufen Sie den Schlüssel unter API.

Alternative: Webhooks und HTTP

Wenn Sie die App lieber nicht installieren möchten, verbindet sich Make mit Cord über zwei Module, die Make bereits mitbringt:

Richtung Make-Modul Was Sie in Cord brauchen
Cord → Make: Ein Cord-Ereignis startet Ihr Szenario Webhooks › Custom webhook Einen Webhook-Endpoint mit der URL von Make
Make → Cord: Ihr Szenario legt Daten in Cord an oder aktualisiert sie HTTP › Make a request Einen geheimen API-Schlüssel mit Schreibberechtigung

Beides richten Sie in der Cord Workbench ein (Tabs Webhooks und Schlüssel): Wenn Sie sie nicht sehen, aktivieren Sie den Entwicklermodus unter Ihr Konto › Präferenzen.

Ereignisse von Cord empfangen

  1. Legen Sie den Webhook in Make an. Fügen Sie in Ihrem Szenario Webhooks › Custom webhook hinzu, klicken Sie auf Add, geben Sie einen Namen ein und kopieren Sie die URL, die Make Ihnen anzeigt.
  2. Registrieren Sie den Endpoint in Cord. Öffnen Sie Webhooks im Entwicklerbereich, fügen Sie die URL von Make ein und speichern Sie. Cord zeigt Ihnen ein Signatur-Secret nur einmal an; Make verwendet es nicht, aber bewahren Sie es auf, falls Sie Signaturen später prüfen möchten.
  3. Wählen Sie die Ereignisse. Markieren Sie nur die, die Ihr Szenario braucht, zum Beispiel quote.approved oder invoice.paid.
  4. Zeigen Sie Make die Struktur des Ereignisses. Klicken Sie in Make auf Redetermine data structure und in Cord beim Endpoint auf Testen. Make empfängt ein Beispielereignis und lernt seine Felder.
  5. Zuordnen und aktivieren. Verwenden Sie die Felder in den folgenden Modulen (zum Beispiel data.folio, data.total, data.cliente) und schalten Sie das Szenario ein.

Was jedes Ereignis enthält

Jedes Ereignis ist ein JSON mit vier Feldern:

Feld Bedeutung
id Eindeutige Kennung des Ereignisses. Sie bleibt gleich, wenn Cord die Zustellung wiederholt.
event Der Ereignistyp, zum Beispiel quote.paid.
created_at Wann es eingetreten ist.
data Die Daten des Objekts: bei einem Angebot id, folio, status, moneda, total, cliente, cliente_id und der öffentliche Link.

Die vollständige Liste der Ereignisse und ihrer Felder finden Sie unter Webhooks für Entwickler.

Ein Endpoint oder mehrere

Sie können pro Szenario einen Endpoint mit nur dessen Ereignissen registrieren oder einen mit mehreren Ereignissen und einem Router in Make, der nach event filtert. Ersteres ist leichter zu pflegen; Letzteres verbraucht weniger Endpoints.

Endpoints, die Sie manuell registrieren, zählen zum Webhook-Limit Ihres Tarifs: 16 im kostenlosen Tarif sowie in Starter und Professional; 32 in Scale; 100 in Developer.

Zustellungen und Wiederholungen

Jeder Endpoint führt ein Zustellungsprotokoll mit Status, Antwortzeit und der Antwort von Make. Wenn Make nicht antwortet, wiederholt Cord die Zustellung. Da sich die id zwischen Wiederholungen nicht ändert, fügen Sie in Make einen Filter oder einen Datenspeicher hinzu, damit dieselbe id nicht zweimal verarbeitet wird.

Behandeln Sie die URL des Make-Webhooks als Geheimnis. Make prüft die Signatur von Cord nicht, sodass jeder, der die URL kennt, Ihrem Szenario gefälschte Daten senden könnte. Geben Sie sie nicht weiter. Wenn Sie vermuten, dass sie bekannt geworden ist, löschen Sie den Endpoint in Cord, legen Sie in Make einen neuen Webhook an und registrieren Sie die neue URL.

Daten in Cord anlegen oder aktualisieren

  1. Erstellen Sie einen Schlüssel. Erstellen Sie unter API im Entwicklerbereich einen geheimen Schlüssel mit Schreib-Berechtigung. Er wird nur einmal angezeigt; speichern Sie ihn in der Make-Verbindung, nicht in einem Textfeld des Szenarios.
  2. Fügen Sie HTTP › Make a request zu Ihrem Szenario hinzu.
  3. Konfigurieren Sie es:
    • URL: der Endpoint, zum Beispiel https://cordhq.app/api/v1/clientes.
    • Method: POST zum Anlegen, PATCH zum Aktualisieren, GET zum Suchen.
    • Headers: Authorization mit Bearer, gefolgt von Ihrem Schlüssel, und Content-Type mit application/json.
    • Body type: Raw, mit Content type JSON und den Feldern der Ressource.
    • Parse response: aktiviert, um die Antwort in den folgenden Modulen zu verwenden.
  4. Vermeiden Sie Duplikate mit dem Header Idempotency-Key (siehe unten).

Was Sie tun können

Sie möchten Anfrage
Einen Kunden über die E-Mail-Adresse suchen, bevor Sie ihn anlegen GET /api/v1/clientes?email=client@example.com
Einen Kunden anlegen POST /api/v1/clientes mit mindestens empresa
Die Kontaktdaten eines Kunden aktualisieren PATCH /api/v1/clientes/{id} mit contacto, email, telefono usw.
Ein Angebot über die Nummer suchen GET /api/v1/cotizaciones?folio=COT-00104
Ein Angebot erstellen POST /api/v1/cotizaciones
Ein Angebot senden, bestätigen, ablehnen oder als bezahlt markieren POST /api/v1/cotizaciones/{id} mit action: send, resend, approve, reject oder mark_paid
Eine Aufgabe anlegen POST /api/v1/tareas mit titulo und optional due_date und cotizacion_id

Die Felder jedes Endpoints: Kunden, Angebote und Aufgaben.

Duplikate vermeiden

Make kann ein Modul wiederholen. Damit eine Wiederholung denselben Kunden nicht zweimal anlegt, fügen Sie den Header Idempotency-Key mit einem festen Wert für diesen Vorgang hinzu, zum Beispiel die id des auslösenden Ereignisses oder die Zeilen-ID Ihrer Tabelle. Hat Cord diesen Schlüssel mit derselben Anfrage bereits erhalten, gibt es das ursprüngliche Ergebnis zurück, statt einen weiteren Datensatz anzulegen.

Testschlüssel

Mit einem Schlüssel sk_test_… arbeitet Ihr Szenario in der Testumgebung Ihres Kontos, getrennt von Ihren echten Daten. Verwenden Sie ihn, während Sie das Szenario aufbauen, und ersetzen Sie ihn danach durch den Schlüssel sk_live_….

Beispielszenarien

  • Angebot bestätigt → Tabelle: Custom webhook mit quote.approved → Google Sheets › Add a row mit Nummer, Kunde und Gesamtbetrag.
  • Formular → Kunde in Cord: Typeform › Watch responses → HTTP GET /api/v1/clientes?email= → falls er nicht existiert, HTTP POST /api/v1/clientes.
  • Rechnung bezahlt → Buchhaltung: Custom webhook mit invoice.paid → Ihr Buchhaltungssystem.
  • Zahlung auf einer anderen Plattform → in Cord als bezahlt markieren: der Trigger Ihrer Plattform → HTTP GET /api/v1/cotizaciones?folio= → HTTP POST /api/v1/cotizaciones/{id} mit {"action":"mark_paid"}.

Häufige Fehler

Antwort von Cord Ursache Was zu tun ist
401 Der Schlüssel fehlt, wurde falsch kopiert oder widerrufen. Prüfen Sie den Header Authorization: Bearer sk_live_….
403 Der Schlüssel hat nur Leserechte. Erstellen Sie einen Schlüssel mit Schreibberechtigung.
404 Die ID existiert in Ihrer Organisation nicht. Prüfen Sie, ob Sie die richtige id zugeordnet haben und nicht die Angebotsnummer.
409 invalid_state Die Aktion passt nicht zum aktuellen Status, zum Beispiel das Bestätigen eines Entwurfs. Prüfen Sie den Status des Angebots vor der Aktion.
422 idempotency_key_reused Sie haben denselben Idempotency-Key für eine andere Anfrage verwendet. Verwenden Sie pro Vorgang einen anderen Schlüssel.
429 Sie haben das Limit pro Minute oder das monatliche API-Kontingent überschritten. Fügen Sie eine Pause zwischen den Modulen ein oder verringern Sie die Häufigkeit. Prüfen Sie Ihren Verbrauch unter Einstellungen › Tarif und Abonnement; warten Sie im kostenlosen Tarif bis zum nächsten Monat oder wechseln Sie in einen höheren Tarif.
„Sie können hier keine Apps verbinden“ beim Autorisieren Ihr Benutzer hat in diesem Arbeitsbereich keine Berechtigung für Einstellungen. Bitten Sie jemanden mit dieser Berechtigung, die Autorisierung vorzunehmen.

Mehr unter API-Fehler.

Verwandte Themen