Bitrix24 goşundy

v1.0.x · täzelendi 2026-10-14

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.

Aşakdaky media we umumy OAuth hereketi gol çekilen Core 1.4.15 hem-de katalogda aýratyn çap edilip täzelenen, gol çekilen 1.1.1 birleşdirijisini talap edýär. Gurlan 1.1.0 bu mümkinçilikleriň elýeterlidigini tassyklamaýar.

Faktlar

Merkez	Bahasy
Wersiýa	1.1.1
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.

Aýratyn portal ulanyjylaryny BITRIX24_AGENT_USER_IDS, portaly BITRIX24_PORTAL arkaly belläň. Bölüm boýunça ugrukdyrma işgärleriň girişini çäklendirýär; agent hasaby işi başlatýan adamy çalyşmaýar. Bar bolan goşmaça awtomatik taýýarlama BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD ulanýar.

Görkezilen wersiýalarda BITRIX24_VAULT_CONNECTIONS eýesine degişli bar bolan, güýjündäki, özbaşdak OAuth baglanyşygyny saýlaýar. Goldanylýan ýerli ammar/baglanyşyk dolandyryşyny ulanyň; şol maglumat ID-sini gurallaryň baglanyşyklarynda saýlaň. Hakyky eýesi işleýän birleşdirijini onuň iş giňişliginde aýratyn connection-token açary bilen /v1/admin/connections/channel arkaly hasaba alýar. Agent ulanyjy ID-si boýunça endpoint we apiKey bahalaryny gizlin BITRIX24_VAULT_CONNECTIONS sazlamasynda goýuň; agent profillerine ýa-da soraglaryna goýmaň. Tokenleri diňe ammar täzeleýär; gurallar başlatýan adamy we paýlaşmagy barlaýar. Serediň: OAuth2.

Ol nähili ulanylýar

Giriş: soraglaýjy habarlary okaýar. Media baýtlar hökmünde ýüklenýär we /v1/inbound/media arkaly hasaba alynýar; agent diňe URL ýa-da faýl maglumatyny däl, media_id alýar.
Çykyş: Deliver Markdown-y BB-code-a öwürýär we hakyky baýtlary im.v2.File.upload arkaly ýükleýär. Media tassygy hakyky FILE_ID we habar ID-lerini talap edýär; tekst ýa-da baglanyşyk faýl kwitansiýasy däl.

Täzelenmelerde dowamly gowşuryş žurnalyny saklaň. Tassyklanan amalyň gaýtalanmagy öňki kwitansiýany gaýtarýar. Bölekleýin ýa-da näbelli täsir awtomatik gaýtadan iberilmeýär; gaýtalamazdan öň barlaň.

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

Goldanylýan aýratynlyklary

Reaksiýalar we @-agzamalar.
Hasap we platforma im.dialog.writing we REPLY_ID goldasa, ýazuw görkezijisi we jogaplar.
Ýokardaky wersiýa talaplary bilen giriş suratlary, audio, ses we faýllar.
Habar redaktirlemek/pozmak diňe aýratyn bot şahsyýetli köne integrasiýalarda; adaty OAuth ulanyjylary üçin yglan edilmeýär.

Çäkler

[!WARNING] Interaktiw klawiaturalar, düwmeler we mowzuk şahalary goldanylmaýar.

Döredilen ýa-da taýýarlanan faýl tassyklanan gowşuryş däl. Bölekleýin, şowsuz we näbelli netijeler görünýän bolmaly.

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.
Serwer-iň özü — konteýnerde däl, systemd-de işleýär.