REST-API og webhooks

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.

CRM-et ditt slutter å være et sted du må logge inn for å skrive: det blir et endepunkt som systemene dine kaller.

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

Fordeler med REST-API og webhooks

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.

Claire Donovan

Koble nettstedet ditt til CRM-et i ettermiddag

AiCrm er CRM-verktøyet fra AIsToHire som mottar kontaktene dine via REST-API og varsler systemene dine med signerte webhooks. Opprett kontoen din, generer en nøkkel og gjør det første kallet.