REST API a webhooky

Veřejné REST API s více API klíči a podepsanými webhooky

Přidávej zákazníky z webu, formuláře nebo backendu jediným HTTP voláním a každou změnu dostávej na svůj server podepsanou HMAC-SHA256.

Tvoje CRM přestává být místem, kam musíš chodit psát: stává se endpointem, na který volají tvé systémy.

AiCrm, CRM aplikace od AIsToHire, nabízí veřejné REST API nad tvými vlastními kontakty. S klíčem v hlavičce `X-Api-Key` můžeš kontakty vytvářet, vypisovat, zobrazovat, aktualizovat a mazat a přidávat k nim aktivity, a to z formuláře na webu, chatbota, Zapu, skriptu v Pythonu nebo z vlastního backendu. Odpovědi jsou JSON ve tvaru `{ success, data }` a limit je 100 požadavků za minutu na klíč.

Přidání přes API nevytváří duplicity: pokud e-mail, který pošleš, už ve tvé databázi existuje, AiCrm aktualizuje kartu, kterou už máš (doplní chybějící telefon, jméno nebo firmu, spojí štítky) a zapíše do její časové osy nové odeslání s odpovědí HTTP 200; pokud je nový, vytvoří ho a vrátí 201. Každý kontakt, který přijde přes API, se automaticky označí jako `api-lead`, zachová štítky, které pošleš, a uloží původní `subId`, a také zemi, IP adresu a prohlížeč, ze kterých přišel.

Můžeš mít až 20 API klíčů s vlastním názvem, navíc k internímu klíči aplikace. Každé integraci tak dáš jiný klíč — webu, formuláři květnové kampaně, brigádníkovi, dodavateli — a když integrace skončí, zrušíš jen ten její, aniž bys sáhl na ostatní. Celá hodnota klíče se zobrazí jen jednou, při vytvoření; poté ji ve výpisu uvidíš jen maskovanou.

Opačným směrem upozorňují webhooky tvé systémy. Nastavíš až 10 cílů, u každého vybereš, které události odebírá (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) a AiCrm pošle POST na tvou URL s hlavičkami `X-AiCrm-Event` a `X-AiCrm-Signature: sha256=…`, což je podpis HMAC-SHA256 těla pomocí tajného klíče daného webhooku, abys mohl ověřit, že je doručení pravé. Při uložení URL ochrana proti SSRF odmítne localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 a domény `.local` a `.internal`.

Výhody: REST API a webhooky

Přidání kontaktů jediným voláním

POST na `/api/apps/public/crm/customers` s e-mailem a štítky, které chceš, a lead je ve tvém CRM hned zařazený.

Duplicity jsou vyloučené už návrhem

pokud e-mail už existuje, karta se aktualizuje a nové odeslání se zapíše do její časové osy místo vytvoření druhé karty.

Až 20 pojmenovaných klíčů

jeden pro každou integraci, každý zrušitelný zvlášť. Když klíč unikne, smažeš jen ten a nic dalšího přestane fungovat.

Webhooky podepsané HMAC-SHA256

ověříš hlavičku `X-AiCrm-Signature` svým tajným klíčem a víš, že upozornění přichází z tvého CRM, a ne od někoho třetího.

Součástí je ochrana proti SSRF

aplikace odmítne doručovat webhooky na localhost nebo do soukromých rozsahů sítě, takže tvé CRM nelze zneužít ke zkoumání vnitřní sítě.

Plné CRUD, nejen přidávání

výpis se stránkováním a filtry (vyhledávání, stav, štítky, země), zobrazení kontaktu s jeho aktivitou, úprava, smazání a zapisování aktivit.

Původ se zaznamenává automaticky

každé přidání přes API uloží `subId`, který pošleš, plus zemi, IP adresu a prohlížeč, a označí se štítkem `api-lead`, abys ho mohl v aplikaci snadno vyfiltrovat.

Testování bez hádání

aplikace obsahuje dokumentaci endpointů s ukázkou `curl`, kterou lze zkopírovat, a tlačítko pro odeslání testovacího doručení na každý webhook se stavem a časem posledního pokusu.

Claire Donovan

Propoj svůj web se svým CRM ještě dnes odpoledne

AiCrm je CRM nástroj od AIsToHire, který přijímá tvé kontakty přes REST API a upozorňuje tvé systémy podepsanými webhooky. Vytvoř si účet, vygeneruj klíč a proveď první volání.