AiHummer
Azərbaycanca
Daxil olŞəxsi kabinet
v1.0.x
{ }Swagger

Bitrix24 əlavəsi

v1.0.x · yeniləndi 2026-07-05

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.

Faktlar

Sahə Dəyər
Versiya 1.0.0
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.

OAuth kimlikləri ilə yanaşı, digər təminat yolları da dəstəklənir: portal administrasiya girişi vasitəsilə agent hesablarının avtomatik yaradılması (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) və əvvəlcədən yaradılmış Bitrix24 istifadəçilərinə sabit identifikatorlar ilə bağlanma (BITRIX24_AGENT_USER_IDS).

Necə istifadə olunur

  • Gələn bir çəkinti sorğulayıcı yeni mesajları götürür və onları göndərir şlüzün ümumi daxil olan son nöqtəsi, burada marşrutlaşdırıcı hədəf agenti həll edir.
  • Çıxış cavablar konnektorun idempotentliyi vasitəsilə göndərilir Çatdırmaq agentin Markdown formatını Bitrix24-ə çevirən addım BB-kod və mesajın iki dəfə göndərilmədiyini təmin edir.
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

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

Plagin zəngin, insanabənzər söhbət davranışını dəstəkləyir:

  • reaksiyalar
  • mesajı redaktə et və sil
  • yazma göstəriciləri
  • @-yönətmələr
  • media

Sərhədlər

[!WARNING] İnsana bənzər model qəsdən edir yox bəzi Bitrix24 botlarını daxil et xüsusiyyətlər:

  • İnteraktiv klaviaturalar / düymələr yoxdurheç bir iplik yoxdur.
  • Gələn media və səs ötürülmür — daxil olan yalnız mətn. A həmkar üslubunda kimlik mətnləri qəbul edir və onlara cavab verir; əlavə fayllar və səs Agentə göndərilən qeydlər bir çevrilişə ötürülmü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.
  • İdempotent Çatdırmaq — Markdown BB-koda çevrilir və heç vaxt iki dəfə göndərilmir.
  • Yalnız mətnli gələnlər; klaviaturalar/ipliklər yoxdur.
  • Ev sahibi-yerli — containerdə deyil, systemd altında işləyir.

Növbəti haradır