AiHummer
Polski▾
Zaloguj sięKonto
v1.0.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanały/Bitrix24

Bitrix24

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

Bitrix24 to wewnętrzny kanał komunikacji błyskawicznej dla pracowników — ta sama rola, jaką Telegram lub Slack pełni dla personelu. Agent AiHummer pojawia się w Bitrix24 twojej firmy jako współpracownik, do którego pracownicy mogą pisać wiadomości i o którym mogą wspominać.

Kanał przesyła jako złącze w produkcie Rynek i działa natywnie na hoście. Jest konfigurowany z poziomu interfejsu administracyjnego, jak każdy inny kanał.

[!NOTE] Kanał Bitrix24 wymaga aktywnego Rozrusznik, Biznes lub Przedsiębiorstwo licencja. W planie Community instalacja łącznika zwraca HTTP 402 „wymagana aktualizacja” (kod plan_limit) — zobacz Licencjonowanie.

[!WARNING] Bitrix24 tutaj jest ściśle wewnętrzny kanał IM dla pracowników. To jest nie klient wielokanałowy nie Bitrix24 Otwarte Linia, nie kolejka biletowa, i nie powierzchnia eskalacji operatora. Nie używaj jej do kierowania ruchu zewnętrznego rozmowy z klientami.

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.

Tożsamość agenta przypominającego człowieka

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.

Porty i środowisko uruchomieniowe

Port Cel
8810 Usługa konektora na loopback: stan i Deliver

Jak przepływają wiadomości

  • 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ą.

Co jest obsługiwane

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

[!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.

Dokąd dalej