Bitrix24 əlavəsi

v1.2.x · yeniləndi 2026-10-14

Bitrix24 plaginisi agentinizi Bitrix24-ə daxili əməkdaş anlıq mesajlaşma kanalı kimi birləşdirir. Heyət agentə bir həmkarına mesaj yazdığı kimi mesaj göndərir və agent Bitrix24 söhbətində cavab verir.

[!WARNING] Bitrix24 burada bir daxili əməkdaş IM kanalı — Telegram və ya Slack kimi işçilər üçün. Bu yox müştəri omnicanal: Açıq Xətlər yoxdur, yoxdur bilet növbəsi və operator eskalasiyası yoxdur. Bu plaqini ön tərəfə çıxarmaq üçün istifadə etməyin müştəri dəstək xətti.

Plagin host-da yerli olaraq işləyir və keçid ilə əlaqə qurur aihummer.connector.v1 müqavilə. Son istifadəçi kanal davranışı kanal səhifəsindədir Bitrix24; bu səhifə plaqinin özünü əhatə edir.

Aşağıdakı media və ortaq OAuth davranışı imzalanmış Core 1.4.15 və kataloqda ayrıca dərc edilərək yenilənmiş, imzalanmış 1.1.1 konnektorunu tələb edir. Quraşdırılmış 1.1.0 bu imkanların mövcudluğunu təsdiqləmir.

Faktlar

Sahə	Dəyər
Versiya	1.1.1
Limanç	8810
İcra vaxtı	ev sahibi-yerli

Bu nədir

Bitrix24 çat ilə AiHummer arasında iki tərəfli bir körpü. Agent kimi görünür insanabənzər şəxsiyyət Bitrix24-də — hər bir agent ümumi bot hesabı yerinə öz OAuth şəxsiyyəti ilə autentifikasiya olunur — buna görə də söhbətlər həmkarla danışmaq kimi olur. Giriş təşkilatın qaydalarına əsaslanır şöbə ağacı ACL, beləliklə bir agentin çatdığı sahə sizin Bitrix24 strukturunuza hörmət edir.

Ayrı portal istifadəçilərini BITRIX24_AGENT_USER_IDS, portalı isə BITRIX24_PORTAL ilə təyin edin. Şöbə marşrutlaşdırması əməkdaşların girişini məhdudlaşdırır; agent hesabı tapşırığın təşəbbüskarını əvəz etmir. Mövcud əlavə avtomatik hazırlama BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD istifadə edir.

Göstərilən versiyalarda BITRIX24_VAULT_CONNECTIONS sahibinə məxsus mövcud, qüvvədə olan, avtonom OAuth bağlantısını seçir. Dəstəklənən yerli məxfi anbar/bağlantı idarəetməsindən istifadə edin; eyni bağlantı ID-sini alət bağlamalarında seçin. Həqiqi sahibi işləyən konnektoru onun iş məkanında ayrıca connection-token açarı ilə /v1/admin/connections/channel vasitəsilə qeyd edir. Agent istifadəçi ID-si üzrə endpoint və apiKey dəyərlərini gizli BITRIX24_VAULT_CONNECTIONS parametrinə yazın; agent profillərinə və sorğularına qoymayın. Tokenləri yalnız anbar yeniləyir; alətlər təşəbbüskar və paylaşım yoxlamalarını saxlayır. Bax: OAuth2.

Necə istifadə olunur

Daxil olan: sorğulayıcı mesajları oxuyur. Media baytlarla yüklənir və /v1/inbound/media vasitəsilə qeyd olunur; agent yalnız URL və ya fayl məlumatı deyil, media_id alır.
Çıxan: Deliver Markdown-u BB-koda çevirir və həqiqi baytları im.v2.File.upload vasitəsilə yükləyir. Media təsdiqi həqiqi FILE_ID və mesaj ID-ləri tələb edir; mətn və ya keçid fayl qəbzi deyil.

Yeniləmələrdə davamlı çatdırılma jurnalını saxlayın. Təsdiqlənmiş əməliyyatın təkrarı əvvəlki qəbzi qaytarır. Qismən və ya naməlum təsir avtomatik təkrar göndərilmir; yenidən cəhddən əvvəl yoxlayın.

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

Dəstəklənən xüsusiyyətlər

Reaksiyalar və @-qeyd etmələr.
Hesab və platforma im.dialog.writing və REPLY_ID dəstəkləyirsə yazma göstəricisi və cavablar.
Yuxarıdakı versiya tələbləri ilə daxil olan şəkillər, audio, səs və fayllar.
Mesaj redaktəsi/silinməsi yalnız ayrıca bot kimliyi olan köhnə inteqrasiyalarda mümkündür; adi OAuth istifadəçiləri üçün elan edilmir.

Sərhədlər

[!WARNING] İnteraktiv klaviaturalar, düymələr və mövzu zəncirləri dəstəklənmir.

Yaradılmış və ya hazırlanmış fayl təsdiqlənmiş çatdırılma deyil. Qismən, uğursuz və naməlum nəticələr görünən qalmalıdır.

Quraşdırma

Admin UI-də bazardan Bitrix24-ü bir kliklə quraşdırın. Host-yerli yerləşdirici plaginini yükləyir, quraşdırılma addımını yerinə yetirir, sandbox edilmiş systemd vahidini göstərir və hazır olduğunu qeyd etmədən əvvəl sağlamlığı gözləyir — baxın Quraşdırma və yeniləmələr. Sonra hər agentin OAuth şəxsiyyətini birləşdirirsiniz və şöbə ağacı ACL-sini xəritələndirirsiniz.

Təhlükəsizlik və məhdudiyyətlər

Yalnız daxili işçilər üçün IM — müştəri çoxkanallı deyil.
Agent başına insanabənzər OAuth identifikasiyası — agentlər ümumi bot hesabları deyillər.
Şöbə ağacı ACL — hörmət təşkilati struktura çatır.
Ev sahibi-yerli — containerdə deyil, systemd altında işləyir.