Historia zmian

Zmiany w API, webhookach i asystencie AI Estalo, z datami.

Zmiany w API v1, webhookach i asystencie AI, od najnowszych. Pełna historia projektu jest w CHANGELOG.md w repozytorium.

2026-11-02: zmiany przez asystenta AI

Asystent AI (MCP) może zakładać i zmieniać klientów, oferty, zapytania, transakcje, wydarzenia w kalendarzu i zadania w dwóch krokach: estalo_prepare_write pokazuje podgląd zmiany, estalo_commit_write zapisuje ją dopiero po potwierdzeniu w rozmowie. Podgląd jest ważny 10 minut i działa raz.
Zakresy zmian (*:write) są na ekranie zgody w osobnej grupie „Zmiany w danych biura”, nigdy zaznaczone z góry. Zmiany działają tylko w biurze, w którym właściciel włączył zmiany przez API.
Limit 20 zapisanych zmian na minutę na połączenie, każda zmiana w dzienniku z połączeniem, które ją wykonało.

POST /api/v1/{zasób}, PATCH /api/v1/{zasób}/{id} dla wszystkich sześciu zasobów oraz DELETE dla klientów (archiwum), ofert (kosz), wydarzeń i zadań. Zapis wykonuje się jako twórca klucza, według tych samych reguł co aplikacja.
Dwanaście zakresów: do każdego *:read doszło *:write. Zakres zapisu nie obejmuje odczytu.
Zapis wymaga jednorazowego włączenia przez właściciela biura, a klucz z zakresem zapisu powstaje tylko przy włączonej weryfikacji dwuetapowej. /me zwraca nowe pole writes. Właściciel może zmiany ponownie wyłączyć; klucz przestaje zapisywać także wtedy, gdy jego twórca wyłączy weryfikację dwuetapową.
Nagłówek Idempotency-Key (obowiązkowy przy POST), pole expected_updated_at przy PATCH, limity zapisu 30 na klucz i 120 na biuro na minutę, treść do 64 KB, nowe kody błędów zapisu.
Webhooki: nowe zdarzenia lead.updated, client.updated, deal.created, task.created, property.created, property.updated; wysyłka z harmonogramu co minutę.
Dokument OpenAPI w wersji 1.1.0-beta opisuje operacje zapisu. Publiczna dokumentacja pod adresem /developers.

API i asystent AI stosują ustawienie biura „Widoczność danych między agentami”: przy „Pełne biuro (odczyt)” agent czyta wszystkich klientów i wszystkie oferty biura.
leads zwraca message (treść zapytania z maila portalu, tylko dla source = email_import) oraz portal, offer_number, provider_listing_id i listing_title z importu zapytania.

Data w filtrze z niezakodowanym + w strefie czasowej (+02:00) kończy się 400 z komunikatem, że + trzeba zapisać jako %2B.

Serwer MCP https://estalo.pl/api/mcp (tylko odczyt, cztery narzędzia) włączony na produkcji dla pierwszych biur. Obsługiwany klient: Claude. Zgoda na ekranie Estalo, odwołanie w Ustawieniach › Połączone aplikacje AI.

Odczyt sześciu zasobów (clients, properties, deals, events, leads, tasks) kluczami z zakresami odczytu, paginacja kursorem, filtry dat, limity 60 na klucz, 240 na biuro i 120 na adres IP na minutę, dziennik bez wartości.
Webhooki z podpisem HMAC i ponowieniami przygotowane w kodzie, wyłączone do czasu testów.

Historia zmian

Zmiany w API, webhookach i asystencie AI Estalo, z datami.

Zmiany w API v1, webhookach i asystencie AI, od najnowszych. Pełna historia projektu jest w CHANGELOG.md w repozytorium.

Asystent AI (MCP) może zakładać i zmieniać klientów, oferty, zapytania, transakcje, wydarzenia w kalendarzu i zadania w dwóch krokach: estalo_prepare_write pokazuje podgląd zmiany, estalo_commit_write zapisuje ją dopiero po potwierdzeniu w rozmowie. Podgląd jest ważny 10 minut i działa raz.
Zakresy zmian (*:write) są na ekranie zgody w osobnej grupie „Zmiany w danych biura”, nigdy zaznaczone z góry. Zmiany działają tylko w biurze, w którym właściciel włączył zmiany przez API.
Limit 20 zapisanych zmian na minutę na połączenie, każda zmiana w dzienniku z połączeniem, które ją wykonało.

POST /api/v1/{zasób}, PATCH /api/v1/{zasób}/{id} dla wszystkich sześciu zasobów oraz DELETE dla klientów (archiwum), ofert (kosz), wydarzeń i zadań. Zapis wykonuje się jako twórca klucza, według tych samych reguł co aplikacja.
Dwanaście zakresów: do każdego *:read doszło *:write. Zakres zapisu nie obejmuje odczytu.
Zapis wymaga jednorazowego włączenia przez właściciela biura, a klucz z zakresem zapisu powstaje tylko przy włączonej weryfikacji dwuetapowej. /me zwraca nowe pole writes. Właściciel może zmiany ponownie wyłączyć; klucz przestaje zapisywać także wtedy, gdy jego twórca wyłączy weryfikację dwuetapową.
Nagłówek Idempotency-Key (obowiązkowy przy POST), pole expected_updated_at przy PATCH, limity zapisu 30 na klucz i 120 na biuro na minutę, treść do 64 KB, nowe kody błędów zapisu.
Webhooki: nowe zdarzenia lead.updated, client.updated, deal.created, task.created, property.created, property.updated; wysyłka z harmonogramu co minutę.
Dokument OpenAPI w wersji 1.1.0-beta opisuje operacje zapisu. Publiczna dokumentacja pod adresem /developers.

API i asystent AI stosują ustawienie biura „Widoczność danych między agentami”: przy „Pełne biuro (odczyt)” agent czyta wszystkich klientów i wszystkie oferty biura.
leads zwraca message (treść zapytania z maila portalu, tylko dla source = email_import) oraz portal, offer_number, provider_listing_id i listing_title z importu zapytania.

Data w filtrze z niezakodowanym + w strefie czasowej (+02:00) kończy się 400 z komunikatem, że + trzeba zapisać jako %2B.

Serwer MCP https://estalo.pl/api/mcp (tylko odczyt, cztery narzędzia) włączony na produkcji dla pierwszych biur. Obsługiwany klient: Claude. Zgoda na ekranie Estalo, odwołanie w Ustawieniach › Połączone aplikacje AI.

Odczyt sześciu zasobów (clients, properties, deals, events, leads, tasks) kluczami z zakresami odczytu, paginacja kursorem, filtry dat, limity 60 na klucz, 240 na biuro i 120 na adres IP na minutę, dziennik bez wartości.
Webhooki z podpisem HMAC i ponowieniami przygotowane w kodzie, wyłączone do czasu testów.