# REST-API for CRM med signerte webhooks | AiCrm

> CRM med offentlig REST-API: opprett og hent kontakter med X-Api-Key, opptil 20 nøkler og webhooks signert med HMAC-SHA256. Leads fra nettstedet uten duplikater.

- **Kilde (source):** https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/f/rest-api-crm-signerte-webhooks
- **Plattform (platform):** AIstoHire
- **Språk (language):** no

## Kort oppsummert

- Offentlig REST-API med flere API-nøkler og signerte webhooks
- Opprett kunder fra nettstedet, skjemaet eller backend-en din med ett HTTP-kall, og motta hver endring på serveren din signert med HMAC-SHA256.
- Opprett kontakter med ett enkelt kall
- Ingen duplikater, av design
- Opptil 20 navngitte nøkler

## Offentlig REST-API med flere API-nøkler og signerte webhooks

AiCrm, CRM-appen fra AIsToHire, tilbyr et offentlig REST-API over dine egne kontakter. Med en nøkkel i headeren `X-Api-Key` kan du opprette, liste, hente, oppdatere og slette kontakter, og legge til aktiviteter på hvilken som helst av dem, fra skjemaet på nettstedet ditt, chatboten din, en Zap, et Python-skript eller din egen backend. Svarene er JSON på formen `{ success, data }`, og grensen er 100 forespørsler per minutt og nøkkel.

Oppretting via API lager ikke duplikater: hvis e-posten du sender allerede finnes i databasen din, oppdaterer AiCrm kortet du allerede hadde (fyller ut telefon, navn eller firma som manglet, slår sammen etikettene) og registrerer en ny innsending i tidslinjen, og returnerer HTTP 200. Hvis den er ny, oppretter den kontakten og returnerer 201. Hver kontakt som kommer inn via API, merkes automatisk som `api-lead`, beholder etikettene du sender og lagrer opprinnelses-`subId`, i tillegg til landet, IP-en og nettleseren den kom fra.

Du kan ha opptil 20 API-nøkler med eget navn, i tillegg til appens interne nøkkel. Slik gir du en egen nøkkel til hver integrasjon (nettstedet, skjemaet til majkampanjen, praktikanten, leverandøren) og trekker den tilbake alene når integrasjonen avsluttes, uten å røre de andre. Hele verdien til en nøkkel vises bare én gang, når du oppretter den, og etterpå ser du den kun maskert i listen.

Den andre veien varsler webhooks systemene dine. Du konfigurerer opptil 10 mål, velger hvilke hendelser hvert av dem abonnerer på (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`), og AiCrm sender en POST til URL-en din med headerne `X-AiCrm-Event` og `X-AiCrm-Signature: sha256=…`, HMAC-SHA256-signaturen til innholdet med hemmeligheten til den webhooken, slik at du kan verifisere at leveringen er legitim. Når du lagrer URL-en, avviser et anti-SSRF-vern localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 og domenene `.local` og `.internal`.

## Hva den inneholder

- **Opprett kontakter med ett enkelt kall** — en POST til `/api/apps/public/crm/customers` med e-posten og etikettene du vil ha, og leaden ligger allerede i CRM-et ditt, klassifisert.
- **Ingen duplikater, av design** — hvis e-posten allerede finnes, oppdateres kortet og den nye innsendingen noteres i tidslinjen i stedet for at det opprettes et nytt kort.
- **Opptil 20 navngitte nøkler** — én per integrasjon, hver for seg kan trekkes tilbake. Hvis en nøkkel lekker ut, sletter du akkurat den, og ingenting annet slutter å virke.
- **Webhooks signert med HMAC-SHA256** — du verifiserer headeren `X-AiCrm-Signature` med hemmeligheten din og vet at varselet kommer fra CRM-et ditt og ikke fra en tredjepart.
- **Anti-SSRF-vern er inkludert** — appen nekter å levere webhooks til localhost eller private nettverksområder, så CRM-et ditt kan ikke brukes til å sondere et internt nettverk.
- **Full CRUD, ikke bare oppretting** — list med paginering og filtre (søk, status, etiketter, land), hent en kontakt med aktiviteten, oppdater den, slett den og registrer aktiviteter på den.
- **Opprinnelsen spores automatisk** — hver oppretting via API lagrer `subId` du sender, pluss land, IP og nettleser, og merkes med `api-lead` slik at du senere kan filtrere på den i appen.
- **Testing uten gjetting** — appen har dokumentasjon av endepunktene med et `curl`-eksempel du kan kopiere, og en knapp for å sende en testlevering til hver webhook, med status og tidspunkt for siste forsøk.

## Vanlige spørsmål

### Hvordan oppretter jeg en kontakt i CRM-et fra nettstedet mitt?

Du sender en POST til `/api/apps/public/crm/customers` med headeren `X-Api-Key` og en JSON med minst e-post eller telefon. Du kan også sende navn, telefon, firma, land, status, notater, etiketter og en `subId` for å identifisere kampanjen eller skjemaet det kommer fra. AiCrm returnerer 201 hvis kontakten opprettes og 200 hvis den allerede fantes.

### Hva skjer hvis samme e-post kommer inn to ganger via API-et?

Den dupliseres ikke. AiCrm søker etter e-posten (eller telefonen, hvis du ikke sender e-post), og hvis den finner den, oppdaterer den det eksisterende kortet ved å fylle ut feltene som var tomme, slår de nye etikettene sammen med de som allerede fantes, og registrerer den nye innsendingen i aktivitetstidslinjen. Svaret oppgir at kontakten allerede fantes og returnerer id-en.

### Hvor mange API-nøkler kan jeg ha, og kan jeg trekke tilbake bare én?

Du kan opprette opptil 20 nøkler med eget navn, i tillegg til appens interne nøkkel, som ikke kan slettes. Hver nøkkel slettes uavhengig, så du kan gi en egen til hver integrasjon og trekke den tilbake uten å påvirke resten. Hele verdien vises bare i øyeblikket du oppretter den, og etterpå vises den maskert i listen. Alle nøklene deler grensen på 100 forespørsler per minutt per nøkkel.

### Hvordan verifiserer jeg at en webhook virkelig kommer fra CRM-et mitt?

Hver levering har headeren `X-AiCrm-Signature: sha256=<signatur>`, som er HMAC-SHA256 av nøyaktig forespørselens innhold, beregnet med hemmeligheten appen viser deg når du oppretter webhooken. Beregn den HMAC-en på serveren din over innholdet du mottok, og sammenlign. I tillegg følger headeren `X-AiCrm-Event` med navnet på hendelsen: `customer.created`, `customer.updated`, `customer.deleted` eller `activity.created`.

### Hva skjer hvis webhook-endepunktet mitt er nede?

Leveringen er best-effort: AiCrm venter i opptil 5 sekunder, og hvis den feiler, prøver den på nytt etter halvannet sekund. Det finnes ingen vedvarende kø for nye forsøk, så et langvarig utfall på serveren din kan gjøre at du mister varsler. I så fall avstemmer du med en GET til `/api/apps/public/crm/customers`. Appen viser deg status og tidspunkt for siste forsøk for hver webhook, og du kan sende en testlevering når du vil.

- [AiCrm — Lettvekts-CRM med API for å registrere kunder fra et hvilket som helst system](https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109)

## Om plattformen

**AiCrm — Lettvekts-CRM med API for å registrere kunder fra et hvilket som helst system** — applikasjon for AIstoHire. Tilgjengelig på: https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/f/rest-api-crm-signerte-webhooks

### Andre språk

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