# REST-API für CRM mit signierten webhooks | AiCrm

> CRM mit öffentlicher REST-API: Erstelle und frage Kundenkontakte mit einem X-Api-Key-HTTP-Header ab, bis zu 20 Schlüssel pro Integration und ausgehende webhooks, signiert mit HMAC-SHA256. Lead-Erfassung von deiner Website ohne Duplikate.

- **Quelle (source):** https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/f/api-rest-crm-signierte-webhooks
- **Plattform (platform):** AIstoHire
- **Sprache (language):** de

## Zusammengefasst

- Öffentliche REST-API mit mehreren API keys und signierten Webhooks
- Registrieren Sie Kunden von Ihrer Website, Ihrem Formular oder Ihrem Backend mit einem HTTP-Aufruf und empfangen Sie jede Änderung auf Ihrem Server, signiert mit HMAC-SHA256.
- Kontakterfassung mit einem einzigen Aufruf
- Keine Duplikate durch Design
- Bis zu 20 benannte API-Keys

## Öffentliche REST-API mit mehreren API keys und signierten Webhooks

AiCrm, die CRM-App von AIsToHire, stellt eine öffentliche REST-API für Ihre eigenen Kontakte bereit. Mit einem Schlüssel im HTTP-Header `X-Api-Key` können Sie Kontakte erstellen, auflisten, abfragen, aktualisieren und löschen sowie Aktivitäten zu jedem von ihnen hinzufügen, vom Formular Ihrer Website, Ihrem Chatbot, einem Zap, einem Python-Skript oder Ihrem eigenen Backend aus. Die Antworten sind JSON im Format `{ success, data }`, und das Limit beträgt 100 Anfragen pro Minute und Schlüssel.

Die Erfassung per API führt nicht zu Duplikaten: Wenn die von Ihnen gesendete E-Mail bereits in Ihrer Datenbank existiert, aktualisiert AiCrm den bereits vorhandenen Datensatz (ergänzt fehlende Telefonnummer, Namen oder Firma, fügt Tags zusammen) und registriert eine neue Einreichung in seiner Timeline, wobei HTTP 200 zurückgegeben wird; wenn er neu ist, wird er erstellt und 201 zurückgegeben. Jeder Kontakt, der über die API erfasst wird, wird automatisch als `api-lead` getaggt, behält die von Ihnen gesendeten Tags bei und speichert die ursprüngliche `subId` sowie das Land, die IP und den Browser, von denen aus er kam.

Sie können bis zu 20 benannte API keys haben, zusätzlich zum internen Schlüssel der App. So geben Sie jeder Integration einen eigenen Schlüssel —der Website, dem Formular der Mai-Kampagne, dem Praktikanten, dem Lieferanten— und widerrufen diesen allein, wenn die Integration beendet ist, ohne die anderen zu beeinflussen. Der vollständige Wert eines Schlüssels wird nur einmal bei der Erstellung angezeigt; danach ist er in der Liste nur maskiert sichtbar.

In die andere Richtung benachrichtigen Webhooks Ihre Systeme. Sie konfigurieren bis zu 10 Ziele, wählen aus, welche Ereignisse jedes Ziel abonniert (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) und AiCrm sendet einen POST-Request an Ihre URL mit den HTTP-Headern `X-AiCrm-Event` und `X-AiCrm-Signature: sha256=…`, der HMAC-SHA256-Signatur des Bodys mit dem Geheimnis dieses Webhooks, damit Sie die Legitimität der Lieferung überprüfen können. Beim Speichern der URL lehnt eine Anti-SSRF-Schutzfunktion localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 und die Domänen `.local` und `.internal` ab.

## Was enthalten ist

- **Kontakterfassung mit einem einzigen Aufruf** — ein POST an `/api/apps/public/crm/customers` mit der E-Mail-Adresse und den gewünschten Tags, und der Lead ist bereits in Ihrem CRM klassifiziert.
- **Keine Duplikate durch Design** — Wenn die E-Mail bereits existiert, wird der Datensatz aktualisiert und die neue Einreichung in der Timeline vermerkt, anstatt einen zweiten Datensatz zu erstellen.
- **Bis zu 20 benannte API-Keys** — einer pro Integration, separat widerrufbar. Wenn ein API-Key kompromittiert wird, löschen Sie diesen, und nichts anderes hört auf zu funktionieren.
- **Mit HMAC-SHA256 signierte Webhooks** — Sie überprüfen den HTTP-Header «X-AiCrm-Signature» mit Ihrem Geheimnis und wissen, dass die Benachrichtigung von Ihrem CRM und nicht von einem Dritten stammt.
- **Inklusive Anti-SSRF-Schutz** — Die App weigert sich, Webhooks an localhost oder private Netzwerkbereiche zu liefern, sodass Ihr CRM nicht zum Scannen eines internen Netzwerks verwendet werden kann.
- **Vollständiges CRUD, nicht nur Erstellung** — Auflisten mit Paginierung und Filtern (Suche, Lifecycle-Status, Tags/Labels, Land), einen Customer mit seiner Aktivität abfragen, ihn aktualisieren, löschen und Aktivitäten für ihn registrieren.
- **Automatisch nachverfolgte Herkunft** — Jede Erstellung über die API speichert die von Ihnen gesendete «subId» plus Land, IP und Browser und wird als «api-lead» getaggt/gelabelt, um sie später in der App filtern zu können.
- **Tests ohne Rätselraten** — Die App enthält die Dokumentation der Endpunkte mit einem kopierbaren «curl»-Beispiel und einem Button, um eine Testlieferung an jeden Webhook zu senden, mit dem Lifecycle-Status und der Uhrzeit des letzten Versuchs.

## Häufig gestellte Fragen

### Wie erstelle ich einen Kontakt im CRM über meine Website?

Sie senden einen POST an `/api/apps/public/crm/customers` mit dem Header `X-Api-Key` und einem JSON, das mindestens die E-Mail-Adresse oder Telefonnummer enthält. Sie können auch Name, Telefon, Firma, Land, Status, Notizen, Tags und eine `subId` senden, um die Kampagne oder das Ursprungsformular zu identifizieren. AiCrm gibt 201 zurück, wenn es erstellt wird, und 200, wenn der Kontakt bereits existierte.

### Was passiert, wenn dieselbe E-Mail-Adresse zweimal über die API eingeht?

Es wird nicht dupliziert. AiCrm sucht nach der E-Mail-Adresse (oder der Telefonnummer, falls keine E-Mail gesendet wird) und, wenn sie gefunden wird, aktualisiert es den bestehenden Datensatz, füllt leere Felder aus, fügt neue Tags zu den bereits vorhandenen hinzu und registriert die neue Übermittlung in der Aktivitäts-Timeline. Die Antwort zeigt an, dass der Kontakt bereits existierte, und gibt dessen ID zurück.

### Wie viele API-Keys kann ich haben und kann ich einen einzelnen widerrufen?

Sie können bis zu 20 benannte Keys erstellen, zusätzlich zum internen Key der App, der nicht gelöscht werden kann. Jeder Key wird unabhängig gelöscht, sodass Sie jeder Integration einen anderen Key zuweisen und diesen widerrufen können, ohne die anderen zu beeinflussen. Der vollständige Wert wird nur zum Zeitpunkt der Erstellung angezeigt; danach erscheint er in der Liste maskiert. Alle Keys teilen sich das Limit von 100 Anfragen pro Minute pro Key.

### Wie überprüfe ich, ob ein Webhook wirklich von meinem CRM stammt?

Jede Lieferung enthält den HTTP-Header `X-AiCrm-Signature: sha256=<Signatur>`, der der HMAC-SHA256 des exakten Anfragetextes ist, unter Verwendung des Geheimnisses, das Ihnen die App beim Erstellen des Webhooks anzeigt. Berechnen Sie diesen HMAC auf Ihrem Server über den empfangenen Text und vergleichen Sie ihn. Zusätzlich wird der HTTP-Header `X-AiCrm-Event` mit dem Namen des Ereignisses übertragen: `customer.created`, `customer.updated`, `customer.deleted` oder `activity.created`.

### Was passiert, wenn mein Webhook-Endpunkt ausgefallen ist?

Die Zustellung erfolgt nach bestem Wissen und Gewissen (best-effort): AiCrm wartet bis zu 5 Sekunden und versucht es bei einem Fehler nach anderthalb Sekunden erneut. Es gibt keine persistente Warteschlange für Wiederholungsversuche, sodass ein längerer Ausfall Ihres Servers dazu führen kann, dass Sie Benachrichtigungen verlieren; in diesem Fall gleichen Sie die Daten mit einem GET an `/api/apps/public/crm/customers` ab. Die App zeigt Ihnen den Status und die Uhrzeit des letzten Versuchs jedes Webhooks an, und Sie können jederzeit eine Testzustellung auslösen.

- [AiCrm — Leichtes CRM mit API zum Anlegen von Kunden aus jedem System](https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109)

## Über die Plattform

**AiCrm — Leichtes CRM mit API zum Anlegen von Kunden aus jedem System** — eine App von AIstoHire. Verfügbar bei: https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/f/api-rest-crm-signierte-webhooks

### Andere Sprachen

- `es`: https://aistohire.com/es/aicrm-crm-ligero-con-api-109/f/api-rest-crm-webhooks-firmados
- `en`: https://aistohire.com/aicrm-lightweight-crm-with-api-109/f/api-rest-crm-signed-webhooks
- `fr`: https://aistohire.com/fr/aicrm-crm-leger-avec-api-109/f/api-rest-crm-webhooks-signes
- `it`: https://aistohire.com/it/aicrm-crm-leggero-con-api-109/f/api-rest-crm-webhook-firmati
- `pt`: https://aistohire.com/pt/aicrm-crm-leve-com-api-109/f/api-rest-crm-webhooks-assinados
- `bg`: https://aistohire.com/bg/aicrm-lesen-crm-s-api-za-upravlenie-na-klienti-i-liydove-109/f/rest-api-crm-podpisani-uebhukove
- `ja`: https://aistohire.com/ja/aicrm-lightweight-crm-with-api-109/f/crm-rest-api-signed-webhooks
- `nl`: https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/f/rest-api-crm-ondertekende-webhooks
- `ko`: https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109/f/crm-rest-api-seomyeong-webhook
- `sv`: https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/f/rest-api-crm-signerade-webhooks
- `da`: https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/f/rest-api-crm-signerede-webhooks
- `ar`: https://aistohire.com/ar/aicrm-nzam-crm-bsit-ma-api-lidara-alamla-walamla-almhtmlin-109/f/crm-rest-api-webhooks
- `no`: https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/f/rest-api-crm-signerte-webhooks
- `fi`: https://aistohire.com/fi/aicrm-yksinkertainen-crm-rajapinnalla-asiakkaille-ja-liideille-109/f/crm-rest-api-allekirjoitetut-webhookit
- `zh`: https://aistohire.com/zh/ai-crm-rest-api-webhooks-109/f/crm-rest-api-webhook
- `pl`: https://aistohire.com/pl/aicrm-prosty-crm-z-api-do-zarzadzania-klientami-i-leadami-109/f/api-rest-crm-podpisane-webhooki
- `he`: https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109/f/api-rest-crm-webhooks-chatumim
- `cs`: https://aistohire.com/cs/aicrm-jednoduche-crm-s-api-pro-spravu-klientu-a-leadu-109/f/rest-api-crm-podepsane-webhooky
- `id`: https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109/f/api-rest-crm-webhook-bertanda-tangan
