Integracja Bitrix24 przez API REST i webhooki

Webhook przychodzący, wychodzący i aplikacja lokalna

Mechanizm	Kierunek	Do czego go używam
Webhook przychodzący	z zewnątrz do Bitrix24	adres z kluczem, przez który integracja wywołuje metody REST: zakłada leady, aktualizuje deale, dodaje komentarze
Webhook wychodzący	z Bitrix24 na zewnątrz	portal wysyła zdarzenie, na przykład dodanie lub zmianę deala, na adres integracji
Aplikacja lokalna	w obie strony	gdy potrzeba więcej niż webhook, na przykład własnej zakładki w karcie CRM

Przy tworzeniu webhooka wybiera się zakres uprawnień, na przykład CRM, zadania albo telefonię. Zaznaczam tylko to, czego integracja potrzebuje, a webhook zakładam na koncie technicznym, a nie na koncie pracownika, który kiedyś może odejść. Adres webhooka przychodzącego działa jak hasło: kto go zna, może zapisywać dane w portalu, więc nie wklejam go do maili ani arkuszy.

Faktury, sklep, telefonia i formularze

Program do faktur

Deal na etapie wygranej przekazuje dane klienta i pozycje do polskiego programu do faktur. Numer faktury, numer KSeF i później status płatności wracają do deala.

Sklep internetowy

Zamówienie z WooCommerce albo Shopera tworzy w Bitrix24 kontakt i deal z wartością koszyka, więc obsługa widzi historię klienta w jednym miejscu.

Centrala VoIP

Bitrix24 ma w API metody do rejestrowania rozmów z zewnętrznej centrali. Połączenie zapisuje się w karcie klienta razem z nagraniem, o ile centrala potrafi wysłać zdarzenie, co sprawdzam u jej dostawcy.

Formularze na stronie

Własny formularz zamiast wbudowanego tworzy lead z oznaczeniem źródła i kampanii, z kontrolą duplikatów po adresie e-mail i telefonie.

Wystawianie dokumentów opisuję na stronie automatyzacja fakturowania, a wysyłkę do KSeF, którą wykonuje program do faktur, w tekście integracja z KSeF. Szczegóły po stronie sklepu są na stronach integracja Shoper i integracja WooCommerce.

Co zostawić w automatyzacji Bitrix24, a co wynieść na zewnątrz

Bitrix24 ma wbudowane reguły automatyzacji, czyli roboty i wyzwalacze przypięte do etapów. Dobrze radzą sobie z tym, co dzieje się wewnątrz portalu: zadanie dla handlowca po zmianie etapu, przypomnienie, zmiana osoby odpowiedzialnej. Na zewnątrz przenoszę przepływy, które:

łączą kilka systemów, na przykład CRM, program do faktur i magazyn,
muszą ponowić próbę, gdy drugi system nie odpowiada,
wymagają dziennika, z którego widać, co i kiedy zostało wysłane,
mają warunki trudne do utrzymania w edytorze reguł.

Takie przepływy buduję zwykle w n8n, opisanym na stronie automatyzacja n8n, albo we własnym kodzie.

Plan, edycja portalu i limity

Dostęp do API REST i webhooków oraz liczba reguł automatyzacji i procesów biznesowych zależą od planu Bitrix24. Część możliwości bywa niedostępna w tańszych planach, a portal w chmurze różni się od edycji instalowanej na własnym serwerze. Przed wyceną sprawdzam w aktualnym cenniku i dokumentacji, co obejmuje Twój plan. API ma też limity liczby zapytań, więc większe synchronizacje rozkładam w czasie i kolejkuję.

Nie sprzedaję licencji. Plan kupujesz u producenta albo u partnera, a ja buduję połączenia. Jeśli dopiero wybierasz system, zacznij od porównania Pipedrive czy Bitrix24, a konfigurację samego CRM opisuję na stronie wdrożenie CRM.

Zanim zlecisz integrację Bitrix24

Ustal, kto ma uprawnienia administratora portalu, bo to on zakłada webhook lub aplikację.
Spisz pola, z których korzystacie, także własne. W API mają one kody zaczynające się od UF_CRM, więc lista nazw z ekranu przyspiesza mapowanie.
Wskaż lejek i etapy, które mają uruchamiać przepływ.
Przygotuj kilka testowych deali i kontaktów, na których sprawdzimy integrację przed włączeniem na prawdziwych danych.
Zdecyduj, kto dostaje powiadomienia o błędach.

Pierwszy przepływ uruchamiam na jednym lejku i jednym rodzaju dokumentu, a kolejne dokładam po kilku dniach obserwacji dziennika. Błąd w mapowaniu pól dotyka wtedy kilku deali, a nie całej bazy klientów.

Najczęstsze pytania

Czy sprzedajesz licencje Bitrix24?

Nie. Plan wybierasz i opłacasz u producenta albo u jego partnera. Zajmuję się połączeniami z innymi systemami, więc nie mam powodu namawiać na droższy plan, jeśli Twój wystarcza.

Czy da się zintegrować Bitrix24 instalowany na własnym serwerze?

Zwykle tak, bo ta edycja także ma API REST. Różni się konfiguracja dostępu z zewnątrz, a aktualizacje są po Twojej stronie. Szczegóły sprawdzam w dokumentacji tej edycji przed wyceną.

Co się stanie, jeśli webhook wychodzący nie dotrze?

Integracja nie może polegać tylko na nim. Dokładam okresowe porównanie przez API REST, które wyłapuje pominięte zmiany, oraz dziennik zdarzeń. Deal zmieniony w czasie awarii i tak trafi do programu do faktur.

Czy integracja zadziała z Subiektem albo Optimą?

Tak, ale potrzebna jest druga część: połączenie z programem, który działa w firmie. Opisuję je na stronach integracja Subiekt i integracja Comarch Optima. Bitrix24 wymienia dane z tym połączeniem przez API.

Integracja Bitrix24 z fakturami, sklepem i telefonią