W sekcji Dla programistów znajdziesz narzędzia do rozszerzania możliwości Bitrix24.
W tym artykule dowiesz się, jak:
- Skonfigurować dostęp do tworzenia integracji,
- Utworzyć webhook,
- Utworzyć aplikację,
- Znaleźć wszystkie utworzone webhooki i aplikacje,
- Sprawdzić statystyki zapytań webhooków i aplikacji.
Skonfiguruj dostęp do tworzenia integracji
Domyślnie tylko administrator Bitrix24 może tworzyć aplikacje dla wszystkich użytkowników. Webhooki przychodzące i aplikacje na własny użytek mogą tworzyć wszyscy użytkownicy. Administrator Bitrix24 może zmienić te ustawienia.
1. Kliknij ikonę ustawień po prawej stronie nazwy lub logo Twojego Bitrix24.
2. Przejdź do Ustawienia (⚙️).
3–4. Na karcie Bezpieczeństwo rozwiń blok Integracje Bitrix24.
5–6. Kliknij +Dodaj w każdym polu, aby wybrać pracowników, którzy będą mogli tworzyć:
- Webhooki przychodzące,
- Aplikacje dla wszystkich,
- Aplikacje na własny użytek.
7. Zapisz zmiany.
Utwórz webhook
Na karcie Typowe przypadki użycia znajdziesz przykłady popularnych scenariuszy tworzenia webhooków: utworzenie narzędzia Czat bot do informowania pracowników lub dodanie skryptu sprzedażowego do formularza połączenia. Jeśli nie znajdziesz odpowiedniego scenariusza, możesz utworzyć własny webhook.
Wybierz scenariusz i przejdź do ustawień.
Webhook do wywoływania REST API. W tym polu system automatycznie generuje tajny klucz webhooka. Klucz jest dostępny tylko dla osoby, która utworzyła webhook. Jeśli administrator Bitrix24 edytuje webhook innego użytkownika, system zmieni tajny klucz, a administrator stanie się właścicielem tego webhooka.
Webhooki: szybki start
Kreator zapytań REST. Za pomocą kreatora możesz wybrać metody i ustawić parametry potrzebne do rozszerzenia możliwości narzędzi. Możesz też przeczytać opisy metod i parametrów oraz pobrać przykład w języku PHP z wybranymi parametrami.
Opis metod w dokumentacji REST
URL. W tym polu system automatycznie tworzy adres URL na podstawie wybranych metod i parametrów. Możesz użyć tego adresu w systemach zewnętrznych, aby wykonać zapytanie.
Adres URL składa się z kilku części:
********24.bitrix24.ru— Adres Twojego Bitrix24./rest— Wskazuje, że komunikacja odbywa się przez REST z użyciem webhooków./7— Identyfikator użytkownika, który utworzył webhook./hv**********ffgs— Tajny klucz. Za jego pomocą można przeglądać, zmieniać i usuwać dane w Bitrix24./crm.lead.update— Wywoływana metoda REST API..json— Parametr używany domyślnie przy tworzeniu nowych webhooków.?ID=42— Parametry wymagane przez konkretną metodę. Podaje się je po znaku zapytania i oddziela symbolem &.
Przykład wywołania metody aktualizacji
Przyjrzyjmy się metodom aktualizacji crm.***.update. Dla tych metod CRM, z wyjątkiem metod dotyczących procesów inteligentnych, obowiązuje wspólna zasada: należy przekazać identyfikator, a następnie tablicę ze zmienianymi wartościami w fields.
Przykład wywołania metody aktualizacji w pasku adresu przeglądarki: crm.***.update.json?id=1&fields[TITLE]=Тестовая%20сущность&fields[ASSIGNED_BY_ID]=1&fields[UF_CRM_1234567890]=TEST
Tak wygląda schemat zapytania REST API do wykonania w pasku adresu przeglądarki: [метод].json?[если передаем массив, то передаем поле так:]fields[[поле]]
Parametry mogą się różnić w zależności od metody, dlatego sprawdzaj opis każdej z nich.
Aby przetestować zapytanie, kliknij Wykonaj i sprawdź wynik.
Przypisz uprawnienia. Możesz zezwolić na wykonywanie zapytań tylko w wybranych narzędziach Bitrix24. Na przykład scenariusz Importuj klientów będzie działać wyłącznie w sekcji CRM.
Twórz aplikacje lokalne
Aplikacje lokalne tworzysz na potrzeby swojego Bitrix24. Przejdź do karty Typowe przypadki użycia > Inne > Aplikacja lokalna.
Aplikacje lokalne: szybki start
Znajdź utworzone webhooki i aplikacje
Przejdź do karty Integracje. Znajdziesz tu:
- Nazwy webhooków i aplikacji,
- Wydarzenia, które wywołują,
- Narzędzia, do których mają dostęp,
- Informację o tym, kto je utworzył.
Aby wyświetlić na liście webhooków tylko potrzebne informacje, kliknij Ustawienia (⚙️) i wybierz pola. Jeśli chcesz edytować lub usunąć webhook lub aplikację, kliknij Menu (≡).
Sprawdź statystyki aplikacji i webhooków
Otwórz kartę Statystyki, aby sprawdzić liczbę zapytań dla każdego webhooka i aplikacji. To narzędzie pomoże Ci ocenić obciążenie Bitrix24 wynikające z zapytań REST.
Oceń obciążenie REST w Bitrix24
Aby sprawdzić statystyki wybranych aplikacji i webhooków, użyj pola Filtr. Możesz filtrować dane z okresu obejmującego maksymalnie 14 dni.
Aby wyświetlić w statystykach tylko potrzebne informacje, kliknij Ustawienia (⚙️) i wybierz pola.
W skrócie
- Sekcja Zasoby programistów zawiera narzędzia do rozszerzania możliwości Bitrix24 za pomocą webhooków i REST API.
- Do tworzenia webhooków możesz wykorzystać gotowe scenariusze. Jeśli nie znajdziesz odpowiedniego, utwórz webhook samodzielnie.
- Domyślnie tylko administrator Bitrix24 może tworzyć aplikacje dla wszystkich użytkowników. Webhooki przychodzące i aplikacje na własny użytek mogą tworzyć wszyscy użytkownicy. Administrator Bitrix24 może to zmienić w ustawieniach Bitrix24, w sekcji Bezpieczeństwo.
- Uprawnienia do tworzenia aplikacji i webhooków zależą również od konektora Vibecode. Gdy przełącznik Źródło uprawnień — serwer Vibecode jest włączony, obowiązują uprawnienia ustawione w Alaio Vibecode.
- Wszystkie utworzone webhooki i aplikacje znajdziesz na karcie Integracje.
- Statystyki zapytań webhooków i aplikacji sprawdzisz na karcie Statystyki.