Bitrix24 plagini

v1.0.x · yeniləndi 2026-06-26

Bitrix24 plagini agentinizi Bitrix24-ə daxili işçi ani-mesajlaşma kanalı kimi qoşur. İşçilər həmkarına mesaj yazdıqları kimi agentə mesaj yazır və agent Bitrix24-ün çatı daxilində cavab verir.

[!WARNING] Buradakı Bitrix24 daxili işçi IM kanalıdır — işçilər üçün Telegram və ya Slack kimi. O, müştəri omnikanalı deyil: Open Lines yoxdur, bilet növbəsi yoxdur və operator eskalasiyası yoxdur. Bu plagini müştəri dəstəyi xəttinin önündə istifadə etməyin.

Plagin host-native işləyir və gateway ilə müqavilə üzərindən danışır. Son istifadəçi kanal davranışı kanal səhifəsindədir Bitrix24; bu səhifə plaginin özünü əhatə edir.

Faktlar

Sahə	Dəyər
Versiya	1.0.0
Port	8810
İcra mühiti	host-native

Bu nədir

Bitrix24 çatı ilə AiHummer arasında ikitərəfli körpü. Agent Bitrix24-də insanabənzər identiklik kimi görünür — hər agent ümumi bot hesabı əvəzinə öz OAuth identikliyi ilə autentifikasiya olur — beləliklə söhbətlər həmkarla danışmaq kimi hiss olunur. Giriş təşkilatın şöbə-ağacı ACL-ını izləyir, beləliklə agentin əhatə dairəsi Bitrix24 strukturunuza hörmət edir.

Necə istifadə olunur

Daxil olan: çəkmə (pull) sorğulayıcısı yeni mesajları götürür və onları gateway-in ümumi daxil olan son nöqtəsinə ötürür, burada marşrutlayıcı hədəf agenti həll edir.
Çıxan: cavablar konnektorun idempotent Deliver addımı vasitəsilə göndərilir, bu, agentin Markdown-unu Bitrix24 BB-code-a çevirir və mesajın iki dəfə göndərilmədiyinə zəmanət verir.

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

Dəstəklənən funksiyalar

Plagin zəngin, insanabənzər çat davranışını dəstəkləyir:

reaksiyalar
mesajın redaktəsi və silinməsi
yazma göstəriciləri
@-qeydlər
media

Məhdudiyyətlər

[!WARNING] İnsanabənzər model bilərəkdən bəzi Bitrix24 bot funksiyalarını daxil etmir:

İnteraktiv klaviaturalar / düymələr yoxdur və mövzular (threads) yoxdur.

Daxil olan media və səs ötürülmür — daxil olan yalnız-mətndir. Həmkar-tipli identiklik mətni qəbul edir və ona cavab verir; agentə göndərilən əlavələr və səs qeydləri növbəyə ötürülmür.

Quraşdırma

Bitrix24-ü admin UI-dakı marketplace-dən bir kliklə quraşdırın. Host-native yerləşdirici plagini yükləyir, onun quraşdırma addımını işə salır, qum qutusunda (sandboxed) systemd vahidi yaradır və hazır kimi qeyd etməzdən əvvəl sağlamlığı gözləyir — baxın Quraşdırma və yeniləmələr. Sonra hər agentin OAuth identikliyini qoşur və şöbə-ağacı ACL-ını xəritələndirirsiniz.

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

Yalnız daxili işçi IM — müştəri omnikanalı deyil.
Agent başına insanabənzər OAuth identikliyi — agentlər ümumi bot hesabları deyil.
Şöbə-ağacı ACL — əhatə dairəsi təşkilat strukturunuza hörmət edir.
İdempotent Deliver — Markdown BB-code-a çevrilir və heç vaxt iki dəfə göndərilmir.
Yalnız-mətn daxil olan; klaviaturalar/mövzular yoxdur.
Host-native — konteynerdə deyil, systemd altında işləyir.