Zum Inhalt springen
MarcommAI

Zapier mit einem persönlichen API-Schlüssel verbinden

Mit der Marcomm-AI-App für Zapier starten Sie Zaps aus Pressemitteilungen, Blogbeiträgen und Presse-Events und erstellen, veröffentlichen und versenden sie. Die App ist nur auf Einladung nutzbar.

  1. 1
    Öffnen Sie in Marcomm Einstellungen → Integrationen → Zapier, um den Status und die benötigten Werte zu sehen.
    Einstellungen, Integrationen, Zapier, mit Status, Verbindungsschritten, zu aktivierenden Scopes und dem Stand des API-Zugangs
    Die Seite Zapier zeigt den aktuellen Status, die Schritte, die zu kopierenden Werte und ob der API-Zugang für diesen Workspace freigegeben ist.
  2. 2
    Öffnen Sie Einstellungen → API. Hat der Workspace noch keinen API-Zugang, füllt ein Owner oder Admin API-Zugang beantragen aus und wählt Antrag senden.
  3. 3
    Nach der Freigabe öffnen Sie Schlüssel erstellen, wählen Persönlicher Schlüssel, haken die nötigen Bereiche an und wählen Schlüssel erstellen. Kopieren Sie den Schlüssel sofort, er wird nur einmal angezeigt.
  4. 4
    Öffnen Sie den Einladungslink von Marcomm AI und fügen Sie die Marcomm-AI-App Ihrem Zapier-Konto hinzu.
  5. 5
    Erstellen Sie einen Zap, wählen Sie Marcomm AI als Trigger oder Aktion und fügen Sie den Schlüssel bei API Key (API-Schlüssel) ein, wenn Zapier nach der Verbindung fragt.

Testen Sie Schritte zum Veröffentlichen und Versenden zuerst mit einem Entwurf, denn sie lassen sich nicht rückgängig machen.

Die App ist noch nicht im öffentlichen Zapier-Verzeichnis, daher brauchen Sie einen Einladungslink von Marcomm AI. Sie hat sieben Trigger: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event und RSVP Invite Updated. Ihre Aktionen erstellen, aktualisieren, veröffentlichen und versenden Pressemitteilungen und fordern deren Freigabe an, erstellen und veröffentlichen Blogbeiträge, erstellen Presse-Events und erstellen, befüllen und versenden RSVP-Einladungen. Zwei Suchen finden eine Pressemitteilung oder einen Blogbeitrag.

Bereiche legen fest, was ein Schlüssel darf. Inhalte (content) liest Pressemitteilungen, Blogbeiträge und Presse-Events, Inhalte schreiben (content:write) erstellt und bearbeitet Entwürfe, Veröffentlichen und senden (distribution) veröffentlicht und versendet per E-Mail, und Freigaben (approvals) deckt Freigabeschritte ab. Die letzten drei funktionieren nur mit dem Schlüsseltyp Persönlicher Schlüssel, weil die Aktion unter der Person gespeichert wird, die den Schlüssel erstellt hat. Ein Workspace-Schlüssel kann nur lesen, und jeder Schlüssel handelt mit der Rolle und den Rechten seiner Erstellerin oder seines Erstellers.

Veröffentlichen und Versenden lassen sich nicht rückgängig machen. Die API führt sie nur aus, wenn die Anfrage confirm: true oder einen Idempotency-Key-Header enthält, und sie veröffentlicht nichts und antwortet mit 409, solange noch eine Freigabe nötig ist oder der Inhalt geplant oder unter Sperrfrist ist. Eine Wiederholung mit demselben Idempotency-Key und derselben Anfrage liefert 24 Stunden lang das erste Ergebnis, statt erneut zu laufen. Jeder Schreibschritt sendet einen Idempotenzschlüssel aus dem Zap und seinen Eingaben. Soll ein Zap genau denselben Schritt innerhalb von 24 Stunden absichtlich wiederholen, tragen Sie bei Repeat Key einen Wert ein, der sich bei jedem Lauf ändert.

Die API ist ab dem Team-Tarif verfügbar. Das Team von Marcomm AI prüft jeden Antrag, und Schlüssel funktionieren erst nach der Freigabe. Ein Schlüssel kann nur die für den Workspace freigegebenen Bereiche nutzen, und jede Person kann bis zu 10 Schlüssel haben. Standardmäßig sind pro Workspace 60 Anfragen pro Minute und 10.000 pro Tag möglich; darüber antwortet die API mit 429 und einem Retry-After-Header. Für höhere Limits nutzen Sie Höhere Limits nötig? unter Einstellungen → API. Um Zapier zu trennen, wählen Sie Widerrufen neben dem Schlüssel; Systeme, die ihn nutzen, verlieren sofort den Zugriff.

FAQs

Rufen Sie GET https://marcomm.works/api/v1/me mit dem Header Authorization: Bearer und Ihrem Schlüssel auf. Das klappt mit jedem freigegebenen Schlüssel, unabhängig von seinen Bereichen, und liefert den Workspace, den Namen des Schlüssels und seine Bereiche.

Ein Schlüssel speichert nicht, welcher Dienst ihn nutzt, daher markiert Marcomm die Karte Zapier nicht als verbunden. Unter Einstellungen → API sehen Sie, wann jeder Schlüssel zuletzt genutzt wurde.

Nein. Die Zapier-App kann eine Freigabe anfordern, und die freigebende Person entscheidet in Marcomm. Über die API ist Freigeben oder Ablehnen mit einem persönlichen Schlüssel mit dem Bereich Freigaben möglich.

Integrationen