API, webhooki i asystent AI

Estalo udostępnia dane CRM biura nieruchomości na trzy sposoby:

• API REST v1: odczyt i zapis klientów, ofert, transakcji, kalendarza, zapytań i zadań, uwierzytelniony kluczem API biura.
• Webhooki: krótkie, podpisane powiadomienia o zmianach wysyłane na Twój adres HTTPS, żeby integracja nie musiała odpytywać API w pętli.
• Asystent AI (MCP): podłączenie Claude do danych biura, z logowaniem do Estalo i zgodą każdej osoby osobno, bez klucza API. Zmiany zapisuje dopiero po potwierdzeniu podglądu.

Dla kogo

Dla biur i agentów, którzy chcą połączyć Estalo z innym systemem: formularzem zapytań na stronie biura, arkuszem lub raportem, systemem księgowym, innym CRM albo własnym skryptem. Dla programistów, którzy robią to na zlecenie biura. Klucze API i adresy webhooków tworzy właściciel biura, a biuro musi mieć aktywny plan.

Status: beta

• API, webhooki i asystent AI są w fazie beta. Włączamy je biurom po kolei; o włączenie poproś pod adresem biuro@programo.pl.
• Odczyt działa od razu po utworzeniu klucza. Zapis wymaga jednorazowego włączenia zmian przez właściciela biura i klucza utworzonego przy włączonej weryfikacji dwuetapowej.
• Asystent AI czyta dane, a jeśli osoba zaznaczy zakresy zmian i biuro ma włączone zmiany przez API, także je zmienia: każdą zmianę najpierw pokazuje jako podgląd i zapisuje dopiero po potwierdzeniu w rozmowie.
• Zmiany w API zapisujemy w historii zmian.

Jak zacząć w 5 krokach

1. Sprawdź dostęp. Właściciel biura otwiera w Estalo Ustawienia › API i webhooki (/dashboard/settings/developers). Komunikat, że API nie zostało jeszcze włączone dla biura, oznacza, że trzeba do nas napisać.

2. Utwórz klucz. Nazwa (na przykład nazwa integracji), tylko te zakresy, których integracja potrzebuje, ważność 30, 90 albo 365 dni. Estalo pokazuje klucz raz: skopiuj go od razu do menedżera sekretów. Szczegóły: Klucze.

3. Wyślij pierwsze żądanie. /me pokazuje biuro, zakresy klucza i to, czy klucz może zapisywać:

   curl -s https://estalo.pl/api/v1/me \
     -H "Authorization: Bearer est_live_xxxxxxxxxxxx_<twój-klucz>"
   

4. Pobierz dane. Listy mają paginację kursorem i filtry dat; do synchronizacji przyrostowej używaj updated_gte. Szczegóły: Listy i paginacja, pola: Zasoby i pola.

5. Zapisuj i słuchaj zmian. Włącz zmiany przez API, utwórz klucz z zakresem zapisu i wysyłaj POST z nagłówkiem Idempotency-Key: Zmiana danych. Dodaj adres webhooka, żeby dowiadywać się o zmianach bez odpytywania: Webhooki.

Adresy

Kontakt

Pytania techniczne: biuro@programo.pl. W zgłoszeniu podaj metodę i adres żądania oraz request_id z odpowiedzi; nigdy nie wysyłaj klucza API ani sekretu webhooka. Podatności zgłaszaj prywatnie na ten sam adres, nie w publicznych zgłoszeniach.