Bitrix24 нэмэлт залгаас

v1.2.x · шинэчилсэн 2026-07-05

Bitrix24 залгаас нь таны агентийг Bitrix24-т дотоод ажилтны шууд мессежийн сувгаар холбодог. Ажилтнууд агенттээ хамт ажиллагчдаа мессеж илгээхтэй адил байдлаар мессеж илгээнэ, харин агент нь Bitrix24-ийн чат дотор хариу өгнө.

[!WARNING] Bitrix24 энд байна дотоод ажилтны IM суваг — Telegram эсвэл Slack шиг ажилтнуудад зориулав. Энэ нь гүй хэрэглэгчийн олон сувгийн үйлчилгээ: Нээлттэй шугамууд байхгүй, байхгүй тасалбарын дараалал ба операторын дээшлүүлэлтгүй. Энэ залгаасыг нүүрэнд нь ашиглах хэрэггүй харилцагчийн дэмжлэгийн утас.

Плагин нь хост-орчинд ажилладаг бөгөөд үүдний бааритаа дамжуулан харьцдаг aihummer.connector.v1 гэрээ. Эцсийн хэрэглэгчийн сувгийн зан төлөв нь сувгийн хуудсан дээр байна Bitrix24; энэ хуудас нь залгаас өөрийг нь хамарна.

Баримтууд

Талбай	Үнэлэмж
Хувилбар	1.0.0
Порт	8810
Гүйцэтгэлийн хугацаа	зочин-орчин нутгийн

Энэ юу вэ

Bitrix24 чат ба AiHummer хоорондын хоёр талт гүүр. Агент нь ингэж харагддаг хүн шиг таних тэмдэг Bitrix24-д — агент бүр ерөнхий бот акаунт биш, өөрийн OAuth танигчээрээ нэвтэрдэг — иймээс яриа нь хамт ажиллдаг хүнтэй ярьж байгаа мэт мэдрэмж төрдөг. Хандалт нь байгууллагын дагаж мөрддөг. салбар-модын ACL, тиймээс агентын хүрэх боломж нь таны Bitrix24 бүтцэд хүндэтгэлтэй хандах болно.

OAuth танилтуудын хажууд, бусад хангах замуудыг дэмждэг: порталын админ нэвтрэлтээр агентын дансыг автомат үүсгэх (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) ба урьдчилан үүсгэсэн Bitrix24 хэрэглэгчдэд тогтмол ID-уудаар холбох (BITRIX24_AGENT_USER_IDS).

Үүнийг хэрхэн ашиглаж болох

Өөр рүү орох: татах сонгуулийн ажилтан шинэ зурвасуудыг авч, тэдгээрийг руу илгээдэг гуулгын ерөнхий орж ирэх цэг, энд чиглүүлэгч зорилтот агентыг шийддэг.
Гарах: хариултууд холбогчийн идемпотентын тусламжтай илгээгддэг Хүргэх алхам, агентын Markdown-ыг Bitrix24 руу хувиргадаг BB-код болон мессежийг хоёр удаа илгээгдээгүй болохыг баталгаажуулдаг.

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

Дэмжигдсэн боломжууд

Энэхүү залгаас нь баялаг, хүний адил чатлах зан төлөвийг дэмждэг:

үйл хөдлөлүүд
мессежийг засах ба устгах
таван бичих үзүүлэлтүүд
@-тэмдэглэлүүд
медиа

Хязгаарууд

[!WARNING] Хүн шиг загвар зориудаар хийдэг гүй зарим Bitrix24 ботыг оруулах онцлог:

Интерактив товчлуурууд / товчнууд байхгүй болон утас байхгүй.

Орж ирж буй медиа ба дуу хоолой дамжуулахгүй байна — орох чиглэлтэй нь зөвхөн текст. А хамт ажиллагсадын хэв маягийн таних тэмдэг текст хүлээн авдаг ба тэдэнд хариу өгдөг; хавсралт ба дуу Агентад илгээсэн тэмдэглэлүүд ээлжинд дамждаггүй.

Суулгах

Админ UI доторх зах зээлээс Bitrix24-ыг нэг дархад суулгаарай. Хост-д төрөлхлөн суух програмыг татаж авдаг, суулгах алхмыг нь ажиллуулдаг, тусгаарлагдсан systemd нэгжийг үүсгэдэг, эрүүл мэндийг шалгах хүртэл хүлээдэг, бэлэн болсон гэж тэмдэглэдэг — үзнэ үү Суурилуулах болон шинэчлэх. Дараа нь та агент бүрийн OAuth танигчийг холбож, хэлтсийн модны ACL-ийг зураглах болно.

Аюулгүй байдал ба хязгаарлалт

Дотоод ажилтны зөвхөн IM — хэрэглэгчийн олон сувгийн биш.
Тус бүрийн агентын хүний төстэй OAuth таних байдал — агентууд нь нийтлэг бот акаунт биш юм.
Хэлтэс-модын ACL — зохион байгуулалтын бүтэцээ хүндэтгэнэ.
Идэмпотент хүргэх — Markdown-г BB-код руу хөрвүүлж, хоёр удаа илгээдэггүй.
Зөвхөн текстийн ирсэн мессеж; гар/утасны утасгүй.
Өөрийн орчны хост — нь контейнерт биш, systemd дор ажиллана.