Bitrix24 goşundy

v1.2.x · täzelendi 2026-07-05

Bitrix24 plagin agentiňizi Bitrix24-e içki işgärleriniň çalt habarlaşma kanaly hökmünde baglaýar. işgärler agent bilen habarlaşyklaryhyny kärdeşine habarlasyp duran ýaly edýärler, we agent Bitrix24-deki çatda jogap berýär.

[!WARNING] Bu ýerde Bitrix24 bar içki işgär IM kanaly — Telegram ýa-da Slack ýaly işçiler üçin. Ol däk daşary müşderi köp-kanal: Açyk setirler ýok, ýok bilet nobaty we operatoryň ýokarlanmasy ýok. Bu plaginini öňe sürmek üçin ulanmaň müşderi goldaw setiri.

Plugin myhman-döredilen gurluşda işleýär we gapy bilen habarlaşýar aihummer.connector.v1 daşky ulanyjynyň kanal öňüni alyş hereketi kanal sahypasynda görkezilýär Bitrix24; bu sahypa pluginiň özüni öz içine alýar.

Faktlar

Merkez	Bahasy
Wersiýa	1.0.0
Port	8810
Iş wagty	myhman-oglan

Ol näme

Bitrix24 çaty we AiHummer arasynda iki taraplaýyn köpri. Agent ýaly görünýär adam ýaly şahsyýet Bitrix24-de — her agent umumy bot hasaby ýerineine özüniň OAuth şahsyýeti bilen tassyklanýar — şonuň üçin gürrüňdeşlikler kärdeş bilen gürleşýän ýaly duýulýar. Giriş guramanyň düzgünlerine laýyk häsiýetlenýär buşluk-agt ACL, şonuň üçin agentiň ýetip bilmegi siziň Bitrix24 gurluşyňyza hormat goýýar.

OAuth şahsyýetlerinden başga-da, beýleki üpjünçilik ugurlary goldanylýar: portala administratoryň girişi arkaly agent hasaplaryny awtomatik döretmek (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) we öňünden döredilen Bitrix24 ulanyjylaryna düwünli id’ler arkaly baglanyşmak (BITRIX24_AGENT_USER_IDS).

Ol nähili ulanylýar

Gelýän: suruşýan bölümler täze habarlary alýar we olary geçelginiň umumy gelen nokady, bu ýerde ruterdir meňzeş agenti çözýär.
Çykýan: jogaplar birikdirijiniň identik id arkaly iberilýär Eltmek agentyň Markdown faýlyny Bitrix24-e öwürýän ädim BB-kod we habaryň iki gezek iberilmeýändigine kepillik berýär.

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

Goldanylýan aýratynlyklary

Plugin baý, adam ýaly söhbetdeşlik häsiýetini goldaýar:

reaksiýalar
habary üýtgetmek we pozmak
ýazyp ýörän görkezijiler
@-belgiler
mediýa

Çäkler

[!WARNING] Adamşa meňzeş model maksat bilen edýär däk käbir Bitrix24 botyny goşmak häsiýetler:

Interaktiw klawiaturalar / düwmeler ýok we toparlar ýok.

Gelýän media we ses ugradylmaýar — içeri gelýän diňe tekst. A hämkar görnüşli şahsyýet teksti kabul edýär we oňa jogap berýär; goşundylary we sesi agentiň elýeterine iberilen bellikler bir öwrülişe geçirilmän galdy.

Gurnama

Admin UI ulgamynda markétpleýsden Bitrix24-i bir basyş bilen gurnaryň. Serwerde ýerlikli goýulýan programma goşundy ýükleýär, gurnamak ädimini ýerine ýetirýär, sandbokslanan systemd bölügini döredýär we taýýarlandygyny belläp başlamazdan ozal saglygyny barlaýar — serediň Gurnama we täzelenmeler. Soňra öňherki agentiň her biriniň OAuth şahsyýetini birleşdirýärsiňiz we bölümler agajynyň ACL-ini şaýlaýarlar.

Howpsuzlyk we çäklendirmeler

Içki işgär diňe IM — müşderi köpkanal däl.
Heri agent üçin adam ýaly OAuth şahsyýeti — agentler generiki bot hasaplary däl.
Şöbə-aýak ACL — hormat siziň gurama gurluşyňyza ýetýär.
Idempotent eltip bermek — Markdown BB-kodyna öwürilýär we hiç haçan iki gezek iberilmeýär.
Diňe tekst gelýär; hiç hili klawiatura/temalar ýok.
Serwer-iň özü — konteýnerde däl, systemd-de işleýär.