SMOC mit der REST API verbinden

Einfache Anleitung, wie Sie sich mit der SMOC REST API aus Ihrem eigenen Code, Synchronisationsjobs oder CRM-Pipelines verbinden. Kundenschlüssel sind standardmäßig unternehmensweit und schreibgeschützt. Schreibberechtigte Schlüssel erlauben eingeschränkte Schreibvorgänge, einschließlich dem Versenden aus dem Posteingang; sie können jedoch keine Ablaufdiagramme bearbeiten, Abläufe veröffentlichen oder LinkedIn-Outreach-Kampagnen starten. Super-User-Schlüssel können Entwürfe von Abläufen und Designs in denselben POST /api/v2/{toolName}-Aufrufen speichern; das Veröffentlichen erfordert weiterhin eine Person in Studio oder Console. Domain-Tools befinden sich auf REST v2 als POST /api/v2/{toolName} (gleiche Handler wie MCP). Vollständige Aufrufliste: REST v2 API-Referenz. GET /api/company/mongocontact bleibt für Zapier.

Ihren API-Schlüssel erhalten

1. Gehen Sie in der SMOC Console zu Einstellungen → Integrationen → API.
2. Optional können Sie dem Schlüssel einen Namen und ein Ablaufdatum (7, 30 oder 90 Tage) geben. Lassen Sie das Ablaufdatum auf Kein Ablauf, wenn Sie nicht möchten, dass der Schlüssel abläuft.
3. Generieren Sie den Schlüssel und kopieren Sie ihn sofort — er wird nur einmal angezeigt, also speichern Sie ihn sicher.

Ihr Schlüssel ist an Ihr Unternehmen gebunden. Jede Anfrage damit ist automatisch auf Ihre Daten beschränkt. Das Generieren eines neuen Schlüssels widerruft nicht bestehende Schlüssel. Ausgestellte Schlüssel werden auf derselben Seite angezeigt — widerrufen Sie dort nicht verwendete Schlüssel. Die MCP-Seite verwendet die gleichen Steuerelemente — siehe den Screenshot im MCP-Leitfaden.

Basis-URL

Basis-URL: https://api.smoc.ai

Vollständiger Kontakte-Endpunkt:

GET https://api.smoc.ai/api/company/mongocontact

Authentifizierung

Legacy-Kontakte: Senden Sie den Schlüssel in einem benutzerdefinierten HTTP-Header namens token. REST v2 akzeptiert Authorization: Bearer oder token.

GET /api/company/mongocontact HTTP/1.1
Host: api.smoc.ai
token: YOUR_SMOC_API_KEY

Verwenden Sie keine Clerk-Secret-Keys (sk_…) oder veröffentlichbare Schlüssel (pk_…).

Welche Funktionen existieren

REST v2 — POST /api/v2/{toolName}

Spiegelt die MCP-Domain-Tools wider (contacts_search, cpcs_overview, inbox_threads_list und die weiteren). OpenAPI: GET /api/v2 oder GET /api/v2/openapi.json. Siehe die REST v2 Referenz.

Firmenkontakte auflisten — GET /api/company/mongocontact (Zapier / kompatibel)

Gibt eine Seite mit Kontakten für das Unternehmen des Schlüssels zurück, plus aggregierte Zählungen.

Was zurückgegeben wird

• Kontakt-Datensätze: Name, E-Mail, Telefon, Status, Adresse, Datum des letzten Gesprächs, Besuchs-/UTM-Historie, Umfrageantworten, benutzerdefinierte Textfelder, Empfehlungs- und Promo-Daten, sofern erfasst. Positive Nachrichtenablauf-Smart-Leads sind Standard-Leads (status: "1") und enthalten zusätzlich leadSentiment, leadCapturedAt und tags, wenn vorhanden.
• leadsCount — Kontakte mit Status Lead (einschließlich nicht gesetzt)
• customerCount — Kontakte mit Status Kunde

Die Zählungen umfassen alle Unternehmenskontakte, nicht nur die aktuelle Seite.

Abfrageparameter

Parameter	Standard	Beschreibung
limit	100	Maximale Anzahl zurückzugebender Kontakte (1–500)
sortByField	(keiner)	Absteigend sortieren nach createdAt, updatedAt, lastConversationDate oder leadCapturedAt
status	(keiner)	Nach Kontaktstatus filtern. status=1 ist die Standard-Lead-Umfrage und schließt positive Nachrichtenablauf-Smart-Leads ein

Kontaktstatus-Werte: "1" Lead, "2" Kunde, "3" verloren, "4" konvertiert.

Kundenschlüssel können keine Kontakte erstellen, aktualisieren oder löschen. Es gibt kein Cursor-Paging auf mongocontact — verwenden Sie limit und verfolgen Sie gesehene IDs clientseitig, oder nutzen Sie das Zapier-Polling. Erweiterte Suche ist POST /api/v2/contacts_search.

Feldspezifische Antwortformate finden Sie in der Public Contacts API-Referenz.

Beispielanfrage

curl -s \
  -H "token: YOUR_SMOC_API_KEY" \
  "https://api.smoc.ai/api/company/mongocontact?status=1&limit=25&sortByField=leadCapturedAt"

Was nicht in der Kunden-API enthalten ist

Schreibberechtigte Schlüssel können weiterhin keinen Ablauf veröffentlichen, live schalten (flowcharts_set_active), Datensätze löschen oder eine LinkedIn-Outreach-Kampagne starten. Posteingang-Senden ist bei einem schreibberechtigten Schlüssel optional (inbox_threads_send, nur Text, erfordert idempotencyKey). Verwenden Sie SMOC MCP aus Claude, Cursor oder VS Code für die gleichen Tools über MCP.

Sicherheitshinweise

• Der Schlüssel wird nur einmal bei der Erstellung angezeigt — speichern Sie ihn in einem Passwort-Manager oder als Umgebungsvariable.
• Geben Sie den Schlüssel niemals in ein Git-Repository ein.
• Kundenschlüssel sind auf die Daten Ihres Unternehmens beschränkt. Standardschlüssel sind schreibgeschützt; Schreibvorgänge einschließlich Posteingang-Senden sind optional.
• Widerrufen Sie nicht verwendete Schlüssel in der ausgestellten Schlüsselliste unter Einstellungen → Integrationen → API.

Fehlerbehebung

• 401 Fehlender Token-Header: Senden Sie token: <key>, nicht Authorization: Bearer.
• 401 Ungültiger oder widerrufener Token: Überprüfen Sie, ob der Schlüssel korrekt ist und nicht widerrufen wurde.
• 422 Limit darf 500 nicht überschreiten: Verringern Sie den limit-Abfrageparameter.
• 422 Ungültiger Statuswert: Verwenden Sie 1, 2, 3 oder 4.

Siehe auch

• REST v2 API-Referenz — jeder POST /api/v2/{toolName}-Aufruf
• SMOC mit der REST API verbinden
• Public Contacts API
• MCP für Claude, Cursor und VS Code