# REST-API voor CRM met ondertekende webhooks | AiCrm

> CRM met openbare REST-API: maak en raadpleeg contacten met een X-Api-Key-header, tot 20 sleutels per integratie en uitgaande webhooks ondertekend met HMAC-SHA256. Leads aanmaken vanaf je website zonder duplicaten.

- **Bron (source):** https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/f/rest-api-crm-ondertekende-webhooks
- **Platform (platform):** AIstoHire
- **Taal (language):** nl

## In het kort

- Openbare REST-API met meerdere API-sleutels en ondertekende webhooks
- Maak klanten aan vanaf je website, je formulier of je backend met één HTTP-aanroep en ontvang elke wijziging op je server, ondertekend met HMAC-SHA256.
- Contacten aanmaken met één aanroep
- Geen duplicaten door ontwerp
- Tot 20 benoemde sleutels

## Openbare REST-API met meerdere API-sleutels en ondertekende webhooks

AiCrm, de CRM-app van AIsToHire, stelt een openbare REST-API beschikbaar over je eigen contacten. Met een sleutel in de header `X-Api-Key` kun je contacten aanmaken, opsommen, opvragen, bijwerken en verwijderen en activiteiten aan elk van hen toevoegen, vanuit het formulier van je website, je chatbot, een Zap, een Python-script of je eigen backend. De antwoorden zijn JSON met de vorm `{ success, data }`, en de limiet is 100 verzoeken per minuut en sleutel.

Aanmaken via de API dupliceert niet: bestaat het e-mailadres dat je meestuurt al in je database, dan werkt AiCrm de kaart bij die je al had (vult het ontbrekende telefoonnummer, de naam of het bedrijf aan, voegt de labels samen) en registreert een nieuwe verzending in haar timeline, met HTTP 200 als antwoord; is het nieuw, dan maakt het het aan en geeft 201 terug. Elk contact dat via de API binnenkomt, wordt automatisch gelabeld als `api-lead`, behoudt de labels die jij meestuurt en bewaart de `subId` van herkomst, plus het land, het IP-adres en de browser waarvandaan het kwam.

Je kunt tot 20 API-sleutels met een eigen naam hebben, naast de interne sleutel van de app. Zo geef je elke integratie (de website, het formulier van de meicampagne, de stagiair, de leverancier) een andere sleutel en trek je die alleen in wanneer die integratie eindigt, zonder de andere aan te raken. De volledige waarde van een sleutel wordt maar één keer getoond, bij het aanmaken; daarna zie je ze alleen gemaskeerd in de lijst.

In de andere richting waarschuwen de webhooks je systemen. Je stelt tot 10 bestemmingen in, kiest op welke gebeurtenissen elk zich abonneert (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) en AiCrm doet een POST naar je URL met de headers `X-AiCrm-Event` en `X-AiCrm-Signature: sha256=…`, de HMAC-SHA256-handtekening van de body met het geheim van die webhook, zodat je kunt controleren of de levering legitiem is. Bij het opslaan van de URL weigert een anti-SSRF-beveiliging localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 en de domeinen `.local` en `.internal`.

## Wat erbij hoort

- **Contacten aanmaken met één aanroep** — een POST naar `/api/apps/public/crm/customers` met het e-mailadres en de labels die je wilt, en de lead staat al geclassificeerd in je CRM.
- **Geen duplicaten door ontwerp** — bestaat het e-mailadres al, dan wordt de kaart bijgewerkt en wordt de nieuwe verzending in haar timeline genoteerd in plaats van een tweede kaart aan te maken.
- **Tot 20 benoemde sleutels** — één per integratie, afzonderlijk in te trekken. Lekt een sleutel uit, dan verwijder je alleen die en stopt er verder niets met werken.
- **Webhooks ondertekend met HMAC-SHA256** — je controleert de header `X-AiCrm-Signature` met je geheim en weet dat de melding van je CRM komt en niet van een derde.
- **Anti-SSRF-beveiliging inbegrepen** — de app weigert webhooks af te leveren op localhost of op privénetwerkbereiken, zodat je CRM niet kan worden gebruikt om een intern netwerk af te tasten.
- **Volledige CRUD, niet alleen aanmaken** — lijsten met paginering en filters (zoeken, status, labels, land), een contact opvragen met zijn activiteit, bijwerken, verwijderen en er activiteiten aan registreren.
- **Herkomst automatisch vastgelegd** — elke aanmaak via de API bewaart de `subId` die je meestuurt plus het land, het IP-adres en de browser, en wordt gelabeld als `api-lead` om er later in de app op te filteren.
- **Testen zonder te gokken** — de app bevat de documentatie van de endpoints met een kopieerbaar `curl`-voorbeeld en een knop om een testlevering naar elke webhook te sturen, met de status en het tijdstip van de laatste poging.

## Veelgestelde vragen

### Hoe maak ik vanaf mijn website een contact aan in het CRM?

Je doet een POST naar `/api/apps/public/crm/customers` met de header `X-Api-Key` en een JSON met minstens het e-mailadres of het telefoonnummer. Je kunt ook naam, telefoon, bedrijf, land, status, notities, labels en een `subId` meesturen om de campagne of het formulier van herkomst te identificeren. AiCrm geeft 201 terug als het contact wordt aangemaakt en 200 als dat contact al bestond.

### Wat gebeurt er als hetzelfde e-mailadres twee keer via de API binnenkomt?

Het wordt niet gedupliceerd. AiCrm zoekt het e-mailadres (of het telefoonnummer, als je geen e-mailadres meestuurt) en werkt, als het dat vindt, de bestaande kaart bij door de lege velden in te vullen, de nieuwe labels samen te voegen met de bestaande en de nieuwe verzending in haar activiteitentimeline te registreren. Het antwoord geeft aan dat het contact al bestond en geeft je zijn id terug.

### Hoeveel API-sleutels kan ik hebben en kan ik er één intrekken?

Je kunt tot 20 sleutels met een eigen naam aanmaken, naast de interne sleutel van de app, die niet kan worden verwijderd. Elke sleutel wordt onafhankelijk verwijderd, dus je kunt aan elke integratie een andere geven en die intrekken zonder de rest te raken. De volledige waarde wordt alleen getoond op het moment dat je ze aanmaakt; daarna verschijnt ze gemaskeerd in de lijst. Alle sleutels delen de limiet van 100 verzoeken per minuut per sleutel.

### Hoe controleer ik dat een webhook echt van mijn CRM komt?

Elke levering draagt de header `X-AiCrm-Signature: sha256=<firma>`, de HMAC-SHA256 van de exacte body van het verzoek met het geheim dat de app je toont wanneer je de webhook aanmaakt. Bereken die HMAC op je server over de ontvangen body en vergelijk ze. Bovendien reist de header `X-AiCrm-Event` mee met de naam van de gebeurtenis: `customer.created`, `customer.updated`, `customer.deleted` of `activity.created`.

### Wat gebeurt er als mijn webhook-endpoint niet bereikbaar is?

De levering is best-effort: AiCrm wacht tot 5 seconden en probeert het, als het mislukt, na anderhalve seconde nog één keer. Er is geen blijvende wachtrij voor nieuwe pogingen, dus een lange storing van je server kan je meldingen doen missen; synchroniseer in dat geval met een GET naar `/api/apps/public/crm/customers`. De app toont je de status en het tijdstip van de laatste poging van elke webhook, en je kunt wanneer je wilt een testlevering starten.

- [AiCrm — Lichte CRM met API om klanten vanuit elk systeem aan te maken](https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109)

## Over het platform

**AiCrm — Lichte CRM met API om klanten vanuit elk systeem aan te maken** — app van AIstoHire. Beschikbaar in: https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/f/rest-api-crm-ondertekende-webhooks

### Andere talen

- `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
- `de`: https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/f/api-rest-crm-signierte-webhooks
- `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
- `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
