# REST API för CRM med signerade webhooks | AiCrm

> CRM med publikt REST API: skapa och hämta kontakter med X-Api-Key, upp till 20 nycklar och webhooks signerade med HMAC-SHA256. Leads utan dubbletter.

- **Källa (source):** https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/f/rest-api-crm-signerade-webhooks
- **Plattform (platform):** AIstoHire
- **Språk (language):** sv

## Sammanfattning

- Publikt REST API med flera API-nycklar och signerade webhooks
- Lägg in kunder från din webbplats, ditt formulär eller din backend med ett HTTP-anrop, och få varje ändring till din server signerad med HMAC-SHA256.
- Skapa kontakter med ett enda anrop
- Inga dubbletter av design
- Upp till 20 namngivna nycklar

## Publikt REST API med flera API-nycklar och signerade webhooks

AiCrm, CRM-appen från AIsToHire, exponerar ett publikt REST API över dina egna kontakter. Med en nyckel i rubriken `X-Api-Key` kan du skapa, lista, hämta, uppdatera och radera kontakter, och lägga till aktiviteter på vilken som helst av dem, från formuläret på din webbplats, din chattbot, en Zap, ett Python-skript eller din egen backend. Svaren är JSON med formen `{ success, data }`, och gränsen är 100 anrop per minut och nyckel.

Registrering via API skapar inga dubbletter: om e-postadressen du skickar redan finns i din databas uppdaterar AiCrm kortet du redan hade (fyller i telefon, namn eller företag som saknades, slår ihop taggar) och registrerar en ny inskickning i dess tidslinje och returnerar HTTP 200; om den är ny skapas den och 201 returneras. Varje kontakt som kommer in via API taggas automatiskt som `api-lead`, behåller de taggar du skickar och sparar ursprungligt `subId`, samt land, IP och webbläsare den kom från.

Du kan ha upp till 20 API-nycklar med eget namn, utöver appens interna nyckel. På så sätt ger du en separat nyckel till varje integration – webbplatsen, formuläret i majkampanjen, praktikanten, leverantören – och återkallar den ensam när integrationen tar slut, utan att röra de andra. Hela värdet på en nyckel visas bara en gång, när den skapas; därefter syns den bara maskerad i listan.

I andra riktningen meddelar webhooks dina system. Du konfigurerar upp till 10 mål, väljer vilka händelser var och en prenumererar på (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) och AiCrm gör en POST till din URL med rubrikerna `X-AiCrm-Event` och `X-AiCrm-Signature: sha256=…`, HMAC-SHA256-signaturen av kroppen med den webhookens hemlighet, så att du kan verifiera att leveransen är legitim. När du sparar URL:en avvisar ett anti-SSRF-skydd localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 samt domänerna `.local` och `.internal`.

## Vad som ingår

- **Skapa kontakter med ett enda anrop** — en POST till `/api/apps/public/crm/customers` med e-postadressen och de taggar du vill ha, och leadet ligger redan i ditt CRM, klassificerat.
- **Inga dubbletter av design** — om e-postadressen redan finns uppdateras kortet och den nya inskickningen noteras i dess tidslinje i stället för att ett andra kort skapas.
- **Upp till 20 namngivna nycklar** — en per integration, möjliga att återkalla var för sig. Om en nyckel läcker raderar du just den och inget annat slutar fungera.
- **Webhooks signerade med HMAC-SHA256** — du verifierar rubriken `X-AiCrm-Signature` med din hemlighet och vet att aviseringen kommer från ditt CRM och inte från en tredje part.
- **Anti-SSRF-skydd ingår** — appen vägrar leverera webhooks till localhost eller privata nätverksintervall, så ditt CRM kan inte användas för att sondera ett internt nätverk.
- **Fullständigt CRUD, inte bara nya poster** — lista med sidindelning och filter (sökning, status, taggar, land), hämta en kontakt med dess aktivitet, uppdatera den, radera den och registrera aktiviteter på den.
- **Ursprunget spåras automatiskt** — varje registrering via API sparar det `subId` du skickar plus land, IP och webbläsare, och märks med `api-lead` så att du sedan kan filtrera den i appen.
- **Test utan gissningar** — appen har dokumentation av endpoints med ett kopierbart `curl`-exempel och en knapp för att skicka en testleverans till varje webhook, med status och tidpunkt för senaste försöket.

## Vanliga frågor

### Hur skapar jag en kontakt i CRM:et från min webbplats?

Du gör en POST till `/api/apps/public/crm/customers` med rubriken `X-Api-Key` och en JSON med minst e-postadress eller telefon. Du kan också skicka namn, telefon, företag, land, status, anteckningar, taggar och ett `subId` för att identifiera kampanjen eller formuläret de kommer från. AiCrm returnerar 201 om kontakten skapas och 200 om den redan fanns.

### Vad händer om samma e-postadress kommer in två gånger via API:et?

Den dupliceras inte. AiCrm söker på e-postadressen (eller telefonen, om du inte skickar någon e-post) och om den hittar kontakten uppdateras det befintliga kortet genom att tomma fält fylls i, de nya taggarna slås ihop med dem som redan fanns och den nya inskickningen registreras i aktivitetstidslinjen. Svaret anger att kontakten redan fanns och returnerar dess id.

### Hur många API-nycklar kan jag ha och kan jag återkalla bara en?

Du kan skapa upp till 20 nycklar med eget namn, utöver appens interna nyckel, som inte kan raderas. Varje nyckel tas bort oberoende av de andra, så du kan ge en egen till varje integration och återkalla den utan att påverka resten. Hela värdet visas bara när nyckeln skapas; därefter visas den maskerad i listan. Alla nycklar delar gränsen på 100 anrop per minut och nyckel.

### Hur verifierar jag att en webhook verkligen kommer från mitt CRM?

Varje leverans har rubriken `X-AiCrm-Signature: sha256=<signatur>`, som är HMAC-SHA256 av den exakta anropskroppen med den hemlighet som appen visar när du skapar webhooken. Beräkna den HMAC:en på din server över den mottagna kroppen och jämför. Dessutom skickas rubriken `X-AiCrm-Event` med händelsens namn: `customer.created`, `customer.updated`, `customer.deleted` eller `activity.created`.

### Vad händer om min webhook-endpoint ligger nere?

Leveransen är best-effort: AiCrm väntar upp till 5 sekunder och om den misslyckas försöker den igen efter en och en halv sekund. Det finns ingen beständig kö för omförsök, så ett långt avbrott på din server kan göra att du missar aviseringar; i så fall avstämmer du med en GET till `/api/apps/public/crm/customers`. Appen visar status och tidpunkt för det senaste försöket för varje webhook, och du kan skicka en testleverans när du vill.

- [AiCrm — Lätt CRM med API för att lägga in kunder från vilket system som helst](https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109)

## Om plattformen

**AiCrm — Lätt CRM med API för att lägga in kunder från vilket system som helst** — app från AIstoHire. Tillgänglig på: https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/f/rest-api-crm-signerade-webhooks

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