REST API i webhooki

Publiczne REST API z wieloma kluczami API i podpisanymi webhookami

Dodawaj klientów ze strony, formularza lub backendu jednym wywołaniem HTTP i otrzymuj każdą zmianę na swoim serwerze, podpisaną HMAC-SHA256.

Twój CRM przestaje być miejscem, do którego trzeba wchodzić i wpisywać dane: staje się endpointem, który wywołują Twoje systemy.

AiCrm, aplikacja CRM z AIsToHire, udostępnia publiczne REST API do Twoich własnych kontaktów. Z kluczem w nagłówku `X-Api-Key` możesz tworzyć, listować, odczytywać, aktualizować i usuwać kontakty oraz dodawać aktywności do każdego z nich – z formularza na stronie, chatbota, Zapa, skryptu w Pythonie lub własnego backendu. Odpowiedzi to JSON w postaci `{ success, data }`, a limit wynosi 100 żądań na minutę na klucz.

Dodawanie przez API nie duplikuje: jeśli wysłany e-mail już istnieje w Twojej bazie, AiCrm aktualizuje kartę, którą już miałeś(-aś) (uzupełnia brakujący telefon, nazwę lub firmę, łączy tagi) i rejestruje nowe zgłoszenie na jej osi czasu, zwracając HTTP 200; jeśli jest nowy, tworzy go i zwraca 201. Każdy kontakt wchodzący przez API jest automatycznie oznaczany jako `api-lead`, zachowuje tagi, które wyślesz, i zapisuje źródłowy `subId` oraz kraj, IP i przeglądarkę, z których przyszedł.

Możesz mieć do 20 kluczy API z własną nazwą, nie licząc wewnętrznego klucza aplikacji. Dzięki temu dajesz inny klucz każdej integracji – stronie, formularzowi majowej kampanii, stażyście, dostawcy – i odwołujesz go osobno, gdy integracja się kończy, nie ruszając pozostałych. Pełna wartość klucza jest pokazywana tylko raz, przy tworzeniu; potem na liście widać ją tylko w postaci zamaskowanej.

W drugą stronę webhooki powiadamiają Twoje systemy. Konfigurujesz do 10 adresów docelowych, wybierasz, na jakie zdarzenia każdy się subskrybuje (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`), a AiCrm wykonuje POST na Twój URL z nagłówkami `X-AiCrm-Event` i `X-AiCrm-Signature: sha256=…`, czyli podpisem HMAC-SHA256 treści z sekretem tego webhooka, abyś mógł(-ogła) zweryfikować, że dostawa jest prawdziwa. Przy zapisie URL zabezpieczenie anty-SSRF odrzuca localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 oraz domeny `.local` i `.internal`.

Zalety: REST API i webhooki

Dodawanie kontaktów jednym wywołaniem

POST na `/api/apps/public/crm/customers` z e-mailem i tagami, jakie chcesz, a lead jest już w Twoim CRM, sklasyfikowany.

Brak duplikatów z założenia

jeśli e-mail już istnieje, karta jest aktualizowana, a nowe zgłoszenie zapisuje się na jej osi czasu zamiast tworzyć drugą kartę.

Do 20 nazwanych kluczy

po jednym na integrację, odwoływalnych osobno. Jeśli klucz wycieknie, usuwasz tylko ten i nic poza nim przestaje działać.

Webhooki podpisane HMAC-SHA256

weryfikujesz nagłówek `X-AiCrm-Signature` swoim sekretem i wiesz, że powiadomienie pochodzi z Twojego CRM, a nie od osoby trzeciej.

Zabezpieczenie anty-SSRF w zestawie

aplikacja odmawia dostarczania webhooków na localhost lub do prywatnych zakresów sieci, więc Twojego CRM nie da się użyć do sondowania sieci wewnętrznej.

Pełny CRUD, a nie tylko dodawanie

lista ze stronicowaniem i filtrami (wyszukiwanie, status, tagi, kraj), pobranie kontaktu z jego aktywnością, aktualizacja, usunięcie i rejestrowanie aktywności.

Źródło śledzone automatycznie

każde dodanie przez API zapisuje przesłany `subId` oraz kraj, IP i przeglądarkę i jest oznaczone tagiem `api-lead`, by później łatwo je filtrować w aplikacji.

Testy bez zgadywania

aplikacja zawiera dokumentację endpointów z przykładem `curl` do skopiowania i przycisk wysyłający testową dostawę do każdego webhooka, ze statusem i godziną ostatniej próby.

Claire Donovan

Połącz swoją stronę z CRM jeszcze dziś po południu

AiCrm to narzędzie CRM z AIsToHire, które przyjmuje Twoje kontakty przez REST API i powiadamia Twoje systemy podpisanymi webhookami. Załóż konto, wygeneruj klucz i wykonaj pierwsze wywołanie.

REST API do CRM z podpisanymi webhookami | AiCrm