Bitrix24 plagini

v1.0.x · täzelendi 2026-06-26

Bitrix24 plagini siziň agentiňizi Bitrix24-e içerki işgär gysga habarlaşma kanaly hökmünde birikdirýär. Işgärler agente edil bir kärdeşine hat ýazýan ýaly hat ýazýarlar, agent bolsa Bitrix24-iň çatynyň içinde jogap berýär.

[!WARNING] Bu ýerde Bitrix24 — içerki işgär IM kanaly — işgärler üçin Telegram ýa-da Slack ýaly. Bu müşderi omnikanaly däl: Open Lines ýok, talon nobaty ýok we operator eskalasiýasy ýok. Bu plagini müşderi goldaw liniýasynyň öňünde goýmaň.

Plagin host-natiwe işleýär we şertnama arkaly gateway bilen gepleşýär. Ahyrky ulanyjy kanalynyň özüni alyp barşy kanal sahypasynda Bitrix24; bu sahypa plaginiň özüni öz içine alýar.

Maglumatlar

Meýdan	Bahasy
Wersiýa	1.0.0
Port	8810
Runtime	host-native

Bu näme

Bitrix24 çaty bilen AiHummer arasyndaky iki taraplaýyn köpri. Agent Bitrix24-de adam meňzeş şahsyýet hökmünde görünýär — her agent umumy bot hasaby ýerine öz OAuth şahsyýeti bilen kesgitlenýär — şonuň üçin söhbetdeşlikler kärdeş bilen gürleşýän ýaly duýulýar. Elýeterlilik guramanyň bölüm-agajy ACL-ine eýerýär, şonuň üçin agentiň gerimi siziň Bitrix24 gurluşyňyzy hormatlaýar.

Ol nähili ulanylýar

Içerik (Inbound): çekiş polleri täze habarlary alýar we olary gateway-iň umumy içerik (inbound) endpoint-ine geçirýär, ol ýerde router nyşana agenti çözýär.
Daşarlyk (Outbound): jogaplar konnektoryň idempotent Deliver ädimi arkaly iberilýär, ol agentiň Markdown-yny Bitrix24 BB-code-yna öwürýär we habaryň iki gezek iberilmezligini kepillendirýär.

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

Goldanýan aýratynlyklar

Plagin baý, adam meňzeş çat özüni alyp barşyny goldaýar:

reaksiýalar
habary redaktirlemek we pozmak
ýazma görkezijileri
@-bellikler
media

Çäklendirmeler

[!WARNING] Adam meňzeş model käbir Bitrix24 bot aýratynlyklaryny bilkastlaýyn öz içine almaýar:

Interaktiw klawiaturalar / düwmeler ýok we iplikler (threads) ýok.

Gelýän media we ses geçirilmeýär — içerik (inbound) diňe tekst. Kärdeş stilindäki şahsyýet teksti alýar we oňa jogap berýär; agente iberilýän goşundylar we ses bellikleri bir aýlama geçirilmeýär.

Gurnama

Bitrix24-i admin UI-däki marketdan bir gezek basmak bilen gurnaň. Host-natiwe deployer plagini ýükläp alýar, onuň gurnama ädimini işledýär, sandbox-laşan systemd birligini çykarýar we taýýar diýip bellemezden öň saglygyna garaşýar — serediň Gurnama we täzelenmeler. Soňra her agentiň OAuth şahsyýetini birikdirýärsiňiz we bölüm-agajy ACL-ini kartalaýarsyňyz.

Howpsuzlyk we çäklendirmeler

Diňe içerki işgär IM — müşderi omnikanaly däl.
Agent başyna adam meňzeş OAuth şahsyýeti — agentler umumy bot hasaby däl.
Bölüm-agajy ACL — gerim siziň gurama gurluşyňyzy hormatlaýar.
Idempotent Deliver — Markdown BB-code-a çykarylýar we hiç wagt iki gezek iberilmeýär.
Diňe tekst içerik; klawiatura/iplik ýok.
Host-natiwe — konteýnerde däl-de, systemd astynda işleýär.