API, webhooki i integracje CRM: co możesz spiąć
Getbuild.pl ma publiczne REST API do odczytu z dokumentacją i kluczami biura (klienci, sprawy, oferty i zadania), a do tego webhooki wychodzące i przychodzące, klucze przyjmowania zgłoszeń oraz gotowe integracje z pocztą, kalendarzami, telefonią Zadarma, Fakturownią, kontami reklamowymi i portalami. Większość połączeń zrobisz bez programisty, a własne narzędzia odczytają dane przez API. Zapisów przez API jeszcze nie ma: nowe zgłoszenia wysyłasz do formularza leadów.
Co możesz spiąć z Getbuild.pl i jak się to robi?
Tabela zbiera najczęstsze potrzeby biura. Każdy wiersz mówi, co chcesz osiągnąć, którym mechanizmem to zrobisz i co musisz mieć przygotowane.
| Co chcesz zrobić | Jak się to robi | Czego potrzebujesz |
|---|---|---|
| Dostawać zgłoszenia z formularza na stronie | formularz na stronę z kluczem przyjmowania zgłoszeń | klucz przyjmowania zgłoszeń z ekranu Integracji |
| Przekazywać zgłoszenia z Zapiera, Make, n8n, WordPressa, Webflow, Tally albo Typeform | uniwersalny webhook przychodzący | klucz przyjmowania zgłoszeń i adres webhooka wpisany w tym narzędziu |
| Dostawać informację u siebie, gdy coś zmieni się w CRM | webhook wychodzący z podpisem HMAC SHA256 | administrator biura z uprawnieniem do webhooków i adres, który przyjmie dane |
| Pokazać oferty na stronie biura | API ofert tylko do odczytu | klucz, który wydaje Getbuild.pl |
| Obsłużyć nieodebrane połączenia | telefonia Zadarma | konto w Zadarma, nieodebrane połączenie tworzy zadanie |
| Mieć pocztę i kalendarz w jednym miejscu | Gmail i Kalendarz Google albo Outlook | konto Google albo Microsoft |
| Wystawiać faktury za prowizję | integracja z Fakturownią | własne konto biura w Fakturowni |
| Mieć wydatki z kampanii w CRM | połączone konto reklamowe jednej z ośmiu platform | dostęp do konta reklamowego w Ustawieniach, w Połączeniach |
| Publikować oferty na portalach | Otodom po połączeniu konta, pozostałe portale przez konta albo pliki FTP | konto albo umowa biura z portalem |
Jak działają webhooki wychodzące?
Webhook to adres w Twoim systemie, na który Getbuild.pl wysyła dane, gdy coś się dzieje. Webhooki wychodzące ustawia administrator biura na ekranie Integracji i potrzebuje do tego uprawnienia do zarządzania webhookami. Manager tego uprawnienia nie ma.
Każda wiadomość ma podpis HMAC SHA256 w nagłówku żądania. Podpis to krótki kod wyliczony z treści wiadomości i wspólnego sekretu. Twój serwer liczy go po swojej stronie i porównuje, więc wie, że wiadomość naprawdę przyszła od Getbuild.pl i nikt jej po drodze nie zmienił.
Gdy Twój serwer nie odpowie poprawnie, Getbuild.pl próbuje wysłać wiadomość 3 razy. Jeśli błędy powtarzają się wiele razy, webhook zostaje wyłączony.
Jak działa webhook przychodzący i co z Zapierem oraz Make?
Uniwersalny webhook przychodzący przyjmuje zgłoszenia z narzędzi takich jak Zapier, Make, n8n, Elementor, WordPress, Webflow, Tally i Typeform. Wskazujesz w nich adres webhooka z kluczem przyjmowania zgłoszeń, a dane trafiają do CRM jako nowe zgłoszenie.
Nie ma osobnej aplikacji Getbuild.pl w katalogu Zapiera ani Make. Te narzędzia działają z nami przez webhooki.
Skąd jeszcze przychodzą zgłoszenia?
- z formularza na Twojej stronie
- z formularzy leadów Google Ads
- z telefonii Zadarma
W przygotowaniu są jeszcze zgłoszenia z Meta Lead Ads oraz z maili portali czytanych ze skrzynki. Dziś nie traktuj ich jako działających.
Zgłoszenia z reklam i formularza zapisują dane kampanii: gclid, utm_source, utm_medium, utm_campaign, utm_term, id i nazwę kampanii, grupę reklam, reklamę i formularz. Dzięki temu wiesz, skąd przyszedł klient.
Co z API ofert i asystentem AI?
Jest publiczne REST API tylko do odczytu (klienci, sprawy, oferty, zadania, ścieżki) z dokumentacją OpenAPI. Klucz tworzy administrator biura w Ustawieniach, w sekcji Klucze API, a klucz widzi tylko tyle, ile osoba, która go utworzyła. Osobne, węższe API ofert obsługuje stronę biura i klucz do niego wydaje Getbuild.pl.
Złącze AI pozwala podłączyć Claude albo ChatGPT do CRM: asystent widzi bezpieczny widok z aliasami zamiast prawdziwych danych klientów i tylko proponuje zmiany, które zatwierdzasz w aplikacji. Włącza je administrator biura w Ustawieniach, w sekcji Połączenia AI. W samym CRM działa też asystent AI (Gemini, Anthropic), który jest domyślnie wyłączony.
Jakie są telefonia, poczta, kalendarze i faktury?
Telefonię obsługuje Zadarma. Nieodebrane połączenie tworzy zadanie, a numer nowego klienta tworzy nowego klienta.
Z Google łączysz Gmail i Kalendarz Google, Dysk Google jako kopię oraz wizytówkę Google. Z Microsoft łączysz Outlook: pocztę, kalendarz, kontakty, To Do i OneDrive. Wiadomości SMS wysyłasz przez SMSAPI.
Faktury za prowizję wystawiasz z CRM przez własne konto biura w Fakturowni, po jego połączeniu. Wystawiasz fakturę, pobierasz PDF i synchronizujesz status płatności.
Jakie reklamy i portale można połączyć?
Konta reklamowe łączysz z ośmioma platformami: Google, Meta, LinkedIn, Microsoft, Pinterest, Snapchat, TikTok i X, w Ustawieniach, w Połączeniach, w sekcji Reklamy i marketing. Po połączeniu konta reklamowego wydatki z kampanii trafiają do CRM. Oferty możesz też publikować w LinkedIn i YouTube.
Oferty publikujesz na Otodom po połączeniu konta oraz na Domy.pl, Nieruchomości Online, Tuziemia, Zaadresowani, Houser i Oferty.net. Pozostałe portale, między innymi Gratka, Morizon, Domiporta, Adresowo i Trójmiasto, obsługuje katalog plików FTP. Razem to 22 nazwane portale i opcja inny portal z 9 formatami plików.
Czego Getbuild.pl nie ma w integracjach?
Te braki są prawdziwe, więc piszemy o nich wprost. Wolimy, żebyś dowiedział się o nich teraz, a nie po wdrożeniu.
- Zapisów przez publiczne REST API. API jest tylko do odczytu, a nowe zgłoszenia wysyłasz do formularza leadów, zdarzenia dostajesz webhookiem.
- Wyszukiwania firmy po numerze NIP w GUS, REGON i CEIDG. Dane firmy wpisujesz ręcznie.
- Innych dostawców telefonii niż Zadarma. Obsługa kolejnego dostawcy VoIP to jeden nowy adapter, ale dziś go nie ma.
- Osobnej aplikacji Zapier i Make. Łączysz je przez webhook.
Co zrobić, gdy potrzebujesz czegoś, czego nie ma?
Najpierw sprawdź, czy wystarczy webhook. Wiele połączeń da się zrobić przez Zapier, Make albo n8n. Gdy potrzebujesz pełnego własnego API, napisz do nas przed startem.
Zapytaj nas o integrację Opisz, z czym chcesz połączyć CRM, a powiemy wprost, czy to dziś działa w Getbuild.pl.
Najczęstsze pytania
Czy Getbuild.pl ma publiczne API?
Tak. Jest publiczne REST API tylko do odczytu (klienci, sprawy, oferty, zadania) z opisem OpenAPI i stroną z dokumentacją, a klucz tworzy administrator biura w Ustawieniach, w sekcji Klucze API. Do tego webhooki wychodzące i przychodzące oraz klucze przyjmowania zgłoszeń. API nie zapisuje danych. Do podłączenia Claude albo ChatGPT służy osobne złącze AI, które włącza administrator biura.
Czy Getbuild.pl działa z Zapierem, Make i n8n?
Tak, przez uniwersalny webhook przychodzący. Nie ma osobnej aplikacji Getbuild.pl w Zapierze ani Make, więc łączysz je webhookiem z kluczem przyjmowania zgłoszeń.
Jak zabezpieczone są webhooki wychodzące?
Każda wiadomość ma podpis HMAC SHA256, a przy błędach jest ponawiana 3 razy. Po wielu błędach webhook zostaje wyłączony. Webhooki ustawia administrator biura.
Z jakim dostawcą telefonii działa Getbuild.pl?
Z Zadarma. Nieodebrane połączenie tworzy zadanie, a numer nowego klienta tworzy nowego klienta. Innych dostawców VoIP dziś nie ma.
Czy Getbuild.pl łączy się tylko z usługami Google?
Nie. Oprócz Google jest Microsoft (Outlook: poczta, kalendarz, kontakty, To Do, OneDrive), Fakturownia, SMSAPI, osiem platform reklamowych oraz portale z ofertami.