REST API og webhooks

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.

Dit CRM holder op med at være et sted, du skal ind og skrive i: det bliver et endpoint, som dine systemer kalder.

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

Fordele ved REST API og webhooks

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.

Claire Donovan

Forbind din hjemmeside med dit CRM allerede i eftermiddag

AiCrm er AIsToHires CRM-værktøj, der modtager dine kontakter via REST API og giver dine systemer besked med signerede webhooks. Opret din konto, generér en nøgle, og foretag det første kald.

REST API til CRM med signerede webhooks | AiCrm