Wtyczka Bitrix24

v1.2.x · zaktualizowany 2026-07-05

Wtyczka Bitrix24 łączy Twojego agenta z Bitrix24 jako kanał komunikacji wewnętrznej dla pracowników. Pracownicy wysyłają agentowi wiadomość w taki sam sposób, w jaki wysyłaliby wiadomość koledze, a agent odpowiada w czacie Bitrix24.

[!WARNING] Bitrix24 tutaj jest wewnętrzny kanał IM dla pracowników — jak Telegram czy Slack dla personelu. To jest nie klient wielokanałowy: nie ma otwartych linii, nie kolejka zgłoszeń i brak eskalacji do operatora. Nie używaj tego wtyczki jako frontu do linia obsługi klienta

Wtyczka działa natywnie na hoście i komunikuje się z bramą przez aihummer.connector.v1 umowa. Zachowanie kanału użytkownika końcowego znajduje się na stronie kanału Bitrix24; ta strona obejmuje sam wtyczkę.

Fakty

Pole	Wartość
Wersja	1.0.0
Port	8810
Czas wykonywania	gospodarz-natywny

Czym to jest

Dwukierunkowy most między czatem Bitrix24 a AiHummer. Agent pojawia się jako tożsamość podobna do ludzkiej w Bitrix24 — każdy agent uwierzytelnia się przy użyciu własnej tożsamości OAuth, a nie ogólnego konta bota — dzięki czemu rozmowy przypominają rozmowę z kolegą. Dostęp podlega zasadom organizacji ACL drzewa działu, więc zasięg agenta respektuje twoją strukturę Bitrix24.

Oprócz tożsamości OAuth, obsługiwane są inne ścieżki provisioningu: automatyczne tworzenie kont agentów za pomocą logowania administratora portalu (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) i powiązywanie z wcześniej utworzonymi użytkownikami Bitrix24 za pomocą stałych identyfikatorów (BITRIX24_AGENT_USER_IDS).

Jak jest używane

Przychodzące: pobieracz wiadomości odbiera nowe wiadomości i przesyła je do ogólny punkt końcowy przychodzący bramy, gdzie router rozwiązuje docelowego agenta.
Wychodzące: odpowiedzi są wysyłane przez niezmienny identyfikator łącznika Dostarczyć krok, który konwertuje Markdown agenta na Bitrix24 BB-kod i gwarantuje, że wiadomość nie zostanie wysłana dwa razy.

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Obsługiwane funkcje

Wtyczka obsługuje bogate, przypominające ludzkie zachowania w czacie:

reakcje
edycja i usuwanie wiadomości
wskaźniki pisania
@-wzmianki
media

Limity

[!WARNING] Model przypominający człowieka robi to celowo nie zawrzyj kilka botów Bitrix24 funkcje:

Brak interaktywnych klawiatur / przycisków i brak wątków.

Ruch przychodzący mediów i głosu nie jest przekazywany — przychodzący to tylko tekst. A tożsamość w stylu współpracownika otrzymuje i odpowiada na tekst; załączniki i głos notatki wysłane do agenta nie są przekazywane w turze.

Instalacja

Zainstaluj Bitrix24 jednym kliknięciem z marketplace w interfejsie administracyjnym. Wbudowany w hoście instalator pobiera wtyczkę, uruchamia jej krok instalacyjny, tworzy odizolowaną jednostkę systemd i czeka na stan zdrowia, zanim oznaczy ją jako gotową — zobacz Instalacja i aktualizacje. Następnie łączysz tożsamość OAuth każdego agenta i mapujesz ACL drzewa działów.

Bezpieczeństwo i ograniczenia

Tylko wewnętrzne wiadomości natychmiastowe dla pracowników — nie omnichannel dla klienta.
Tożsamość OAuth przypominająca ludzką dla agenta — agenci nie są ogólnymi kontami botów.
ACL drzewa działu — dociera do szanowania twojej struktury organizacyjnej.
Dostarczanie idempotentne — Markdown jest renderowany do BB-code i nigdy nie jest wysyłany dwa razy.
Tylko tekst; brak klawiatur/wątków.
Host-natywny — działa pod systemd, nie w kontenerze.