Wtyczka Bitrix24

v1.0.x · zaktualizowany 2026-10-14

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ę.

Opisane niżej media i wspólne OAuth wymagają podpisanego Core 1.4.15 oraz osobno podpisanego konektora 1.1.1 po publikacji w katalogu i aktualizacji. Zainstalowany konektor 1.1.0 nie potwierdza dostępności tych funkcji.

Fakty

Pole	Wartość
Wersja	1.1.1
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.

Skonfiguruj osobnych użytkowników portalu w BITRIX24_AGENT_USER_IDS, a portal w BITRIX24_PORTAL. Routing działów ogranicza dostęp pracowników; konto agenta nie zastępuje osoby inicjującej zadanie. Opcjonalne istniejące automatyczne przygotowanie używa BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

W podanych wersjach BITRIX24_VAULT_CONNECTIONS wybiera istniejące, ważne, autonomiczne poświadczenie OAuth należące do jego właściciela. Użyj obsługiwanego natywnego zarządzania sejfem/połączeniami; wykorzystaj ten sam ID poświadczenia w powiązaniach narzędzi. Rzeczywisty właściciel rejestruje działający konektor w jego przestrzeni roboczej przez /v1/admin/connections/channel z dedykowanym kluczem connection-token. Ustaw endpoint i apiKey według ID użytkownika agenta w tajnym ustawieniu BITRIX24_VAULT_CONNECTIONS, nigdy w profilach lub instrukcjach agenta. Tylko sejf odświeża tokeny; narzędzia sprawdzają inicjatora i udostępnianie. Zobacz OAuth2.

Jak jest używane

Wejście: mechanizm odpytywania czyta wiadomości. Media są pobierane jako bajty i rejestrowane przez /v1/inbound/media; agent otrzymuje media_id, nie tylko URL lub metadane pliku.
Wyjście: Deliver zamienia Markdown na BB-code i przesyła rzeczywiste bajty przez im.v2.File.upload. Potwierdzenie mediów wymaga prawdziwego FILE_ID i ID wiadomości; tekst lub link nie jest potwierdzeniem pliku.

Zachowaj trwały dziennik dostarczeń podczas aktualizacji. Powtórzenie potwierdzonej operacji zwraca poprzednie potwierdzenie. Częściowe lub nieznane skutki nie są automatycznie wysyłane ponownie; sprawdź je przed ponowną próbą.

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

Obsługiwane funkcje

Reakcje i @-wzmianki.
Wskaźnik pisania i odpowiedzi, gdy konto i dostawca obsługują im.dialog.writing oraz REPLY_ID.
Przychodzące obrazy, audio, głos i pliki zgodnie z powyższymi wymaganiami wersji.
Edycja/usuwanie wiadomości tylko w starszych integracjach z odrębną tożsamością bota; nie są deklarowane dla zwykłych użytkowników OAuth.

Limity

[!WARNING] Interaktywne klawiatury, przyciski i wątki nie są obsługiwane.

Wygenerowany lub przygotowany plik nie potwierdza dostarczenia. Wyniki częściowe, nieudane i nieznane muszą pozostać widoczne.

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.
Host-natywny — działa pod systemd, nie w kontenerze.