# REST API til CRM med signerede webhooks | AiCrm

> CRM med offentlig REST API: opret og hent kontakter med en X-Api-Key-header, op til 20 nøgler pr. integration og udgående webhooks signeret med HMAC-SHA256. Opret leads fra din hjemmeside uden dubletter.

- **Kilde (source):** https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/f/rest-api-crm-signerede-webhooks
- **Platform (platform):** AIstoHire
- **Sprog (language):** da

## Kort sagt

- Offentlig REST API med flere API-nøgler og signerede webhooks
- Opret kunder fra din hjemmeside, din formular eller dit backend med et HTTP-kald, og modtag hver ændring på din server signeret med HMAC-SHA256.
- Oprettelse af kontakter med ét kald
- Ingen dubletter fra start
- Op til 20 navngivne nøgler

## Offentlig REST API med flere API-nøgler og signerede webhooks

AiCrm, AIsToHires CRM-app, udstiller en offentlig REST API over dine egne kontakter. Med en nøgle i headeren `X-Api-Key` kan du oprette, liste, hente, opdatere og slette kontakter og tilføje aktiviteter til enhver af dem, fra din hjemmesides formular, din chatbot, en Zap, et Python-script eller dit eget backend. Svarene er JSON i formen `{ success, data }`, og grænsen er 100 forespørgsler pr. minut pr. nøgle.

Oprettelse via API duplikerer ikke: hvis den e-mail, du sender, allerede findes i din database, opdaterer AiCrm det kort, du allerede havde (udfylder det telefonnummer, navn eller den virksomhed, der manglede, forener etiketterne) og registrerer en ny indsendelse på dets tidslinje og returnerer HTTP 200; hvis den er ny, opretter den den og returnerer 201. Hver kontakt, der kommer ind via API, mærkes automatisk som `api-lead`, bevarer de etiketter, du sender, og gemmer oprindelses-`subId` samt det land, den IP og den browser, den kom fra.

Du kan have op til 20 API-nøgler med eget navn, ud over appens interne nøgle. Sådan giver du en forskellig nøgle til hver integration — hjemmesiden, formularen fra majkampagnen, praktikanten, leverandøren — og tilbagekalder den alene, når integrationen slutter, uden at røre ved de andre. Den fulde værdi af en nøgle vises kun én gang, når den oprettes; derefter ses den kun maskeret på listen.

I den anden retning giver webhooks dine systemer besked. Du konfigurerer op til 10 destinationer, vælger, hvilke begivenheder hver enkelt abonnerer på (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`), og AiCrm sender et POST til din URL med headerne `X-AiCrm-Event` og `X-AiCrm-Signature: sha256=…`, HMAC-SHA256-signaturen af indholdet med den pågældende webhooks hemmelighed, så du kan verificere, at leveringen er ægte. Når du gemmer URL'en, afviser en anti-SSRF-beskyttelse localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 og domænerne `.local` og `.internal`.

## Hvad den indeholder

- **Oprettelse af kontakter med ét kald** — et POST til `/api/apps/public/crm/customers` med e-mailen og de etiketter, du vil have, og lead'en er allerede klassificeret i dit CRM.
- **Ingen dubletter fra start** — hvis e-mailen allerede findes, opdateres kortet, og den nye indsendelse noteres på dets tidslinje i stedet for at oprette et andet kort.
- **Op til 20 navngivne nøgler** — én pr. integration, kan tilbagekaldes hver for sig. Hvis en nøgle lækker, sletter du den og kun den, og intet andet holder op med at virke.
- **Webhooks signeret med HMAC-SHA256** — du verificerer headeren `X-AiCrm-Signature` med din hemmelighed og ved, at beskeden kommer fra dit CRM og ikke fra en tredjepart.
- **Anti-SSRF-beskyttelse indbygget** — appen nægter at levere webhooks til localhost eller til private netværksområder, så dit CRM ikke kan bruges til at sondere et internt netværk.
- **Fuld CRUD, ikke kun oprettelse** — list med sideinddeling og filtre (søgning, status, etiketter, land), hent en kontakt med dens aktivitet, opdater den, slet den og registrér aktiviteter på den.
- **Oprindelse spores automatisk** — hver oprettelse via API gemmer det `subId`, du sender, plus land, IP og browser, og bliver mærket `api-lead`, så du bagefter kan filtrere den i appen.
- **Test uden at gætte** — appen har dokumentation af endpoints med et `curl`-eksempel, der kan kopieres, og en knap til at sende en testlevering til hver webhook, med status og tidspunkt for det seneste forsøg.

## Ofte stillede spørgsmål

### Hvordan opretter jeg en kontakt i CRM'et fra min hjemmeside?

Du sender et POST til `/api/apps/public/crm/customers` med headeren `X-Api-Key` og en JSON med mindst e-mailen eller telefonen. Du kan også sende navn, telefon, virksomhed, land, status, noter, etiketter og et `subId` til at identificere kampagnen eller den formular, den kommer fra. AiCrm returnerer 201, hvis den opretter den, og 200, hvis kontakten allerede fandtes.

### Hvad sker der, hvis den samme e-mail kommer ind to gange via API'et?

Den duplikeres ikke. AiCrm søger efter e-mailen (eller telefonen, hvis du ikke sender e-mail), og hvis den finder den, opdaterer den det eksisterende kort ved at udfylde de felter, der var tomme, forener de nye etiketter med dem, kontakten allerede havde, og registrerer den nye indsendelse på dens aktivitetstidslinje. Svaret angiver, at kontakten allerede fandtes, og returnerer dens id.

### Hvor mange API-nøgler kan jeg have, og kan jeg tilbagekalde kun én?

Du kan oprette op til 20 nøgler med eget navn, ud over appens interne nøgle, som ikke kan slettes. Hver nøgle slettes uafhængigt, så du kan give en forskellig til hver integration og tilbagekalde den uden at påvirke resten. Den fulde værdi vises kun i det øjeblik, den oprettes; derefter vises den maskeret på listen. Alle nøgler deler grænsen på 100 forespørgsler pr. minut pr. nøgle.

### Hvordan verificerer jeg, at en webhook virkelig kommer fra mit CRM?

Hver levering har headeren `X-AiCrm-Signature: sha256=<signatur>`, som er HMAC-SHA256 af forespørgslens præcise indhold med den hemmelighed, som appen viser dig, når du opretter webhooken. Beregn den HMAC på din server over det modtagne indhold og sammenlign. Desuden følger headeren `X-AiCrm-Event` med navnet på begivenheden: `customer.created`, `customer.updated`, `customer.deleted` eller `activity.created`.

### Hvad sker der, hvis mit webhook-endpoint er nede?

Leveringen er best effort: AiCrm venter op til 5 sekunder, og hvis det fejler, forsøger den igen efter halvandet sekund. Der er ingen vedvarende kø til nye forsøg, så et langt udfald på din server kan få dig til at miste beskeder; i så fald afstemmer du med et GET til `/api/apps/public/crm/customers`. Appen viser dig status og tidspunkt for det seneste forsøg for hver webhook, og du kan starte en testlevering, når du vil.

- [AiCrm — Let CRM med API til at oprette kunder fra ethvert system](https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109)

## Om platformen

**AiCrm — Let CRM med API til at oprette kunder fra ethvert system** — applikation til AIstoHire. Tilgængelig på: https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/f/rest-api-crm-signerede-webhooks

### Andre sprog

- `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
- `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
- `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
