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

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.