REST API och webhooks

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.

Ditt CRM slutar vara en plats du mÄste logga in pÄ för att skriva: det blir en endpoint som dina system anropar.

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

Fördelar med REST API och webhooks

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.

Claire Donovan

Koppla din webbplats till ditt CRM redan i eftermiddag

AiCrm Àr AIsToHires CRM-verktyg som tar emot dina kontakter via REST API och meddelar dina system med signerade webhooks. Skapa ditt konto, generera en nyckel och gör det första anropet.

REST API för CRM med signerade webhooks | AiCrm