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

v1.4.x · шинэчилсэн 2026-10-14

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

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

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

Доорх медиа болон нийтлэг OAuth үйлдэл нь гарын үсэгтэй Core 1.4.15, мөн каталогт тусад нь нийтлэгдэж шинэчлэгдсэн, гарын үсэгтэй 1.1.1 холбогчийг шаарддаг. Суулгасан 1.1.0 эдгээр боломж бэлэн байгааг батлахгүй.

Баримтууд

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

Энэ юу вэ

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

Тусгай портал хэрэглэгчдийг BITRIX24_AGENT_USER_IDS, порталыг BITRIX24_PORTAL-д тохируулна уу. Хэлтсийн чиглүүлэлт ажилтнуудын хандалтыг хязгаарлана; агентын бүртгэл даалгавар эхлүүлсэн хүнийг орлохгүй. Одоо байгаа сонголтот автомат бэлтгэл BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD ашиглана.

Дээрх хувилбаруудад BITRIX24_VAULT_CONNECTIONS эзэмшигчийнх нь одоо байгаа, хүчинтэй, бие даасан OAuth нэвтрэх мэдээллийг сонгоно. Дэмжигдсэн үндсэн нууцын сан/холболтын удирдлагыг ашиглаж, тэр мэдээллийн ID-г хэрэгслийн холболтод дахин ашиглана. Жинхэнэ эзэмшигч ажиллаж буй холбогчийг ажлын талбарт нь /v1/admin/connections/channel-аар тусгай connection-token түлхүүртэй бүртгэнэ. endpoint болон apiKey-г агент хэрэглэгчийн ID-аар нууц BITRIX24_VAULT_CONNECTIONS тохиргоонд оруулна; агентын профайл эсвэл зааварт бүү байрлуул. Токеныг зөвхөн нууцын сан шинэчилнэ; хэрэгслүүд санаачлагч болон хуваалцах эрхийг шалгана. OAuth2-ыг үзнэ үү.

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

Ирэх: асуулгын процесс зурвас уншина. Медиаг байтаар татаж /v1/inbound/media-аар бүртгэнэ; агент зөвхөн URL эсвэл файлын мэдээлэл бус media_id авна.
Гарах: Deliver Markdown-ыг BB-code болгож, бодит байтыг im.v2.File.upload-аар байршуулна. Медиа батлахад бодит FILE_ID болон зурвасын ID хэрэгтэй; текст эсвэл холбоос файлын хүргэлтийн баримт биш.

Шинэчлэх үед тогтвортой хүргэлтийн бүртгэлийг хадгална уу. Баталгаажсан үйлдлийг давтахад өмнөх баримтыг буцаана. Хэсэгчилсэн эсвэл тодорхойгүй нөлөөг автоматаар дахин илгээхгүй; дахин оролдохоос өмнө шалгана уу.

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

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

Хариу үйлдэл болон @-дурдлага.
Бүртгэл, үйлчилгээ үзүүлэгч im.dialog.writing болон REPLY_ID дэмжвэл бичиж буй үзүүлэлт, хариулт.
Дээрх хувилбарын шаардлагатай ирэх зураг, аудио, дуу хоолой болон файл.
Зурвас засах/устгах нь тусдаа ботын таних мэдээлэлтэй хуучин интеграцад л байна; энгийн OAuth хэрэглэгчид зарлахгүй.

Хязгаарууд

[!WARNING] Интерактив гар, товч болон хэлэлцүүлгийн салааг дэмжихгүй.

Үүсгэсэн эсвэл бэлтгэсэн файл баталгаажсан хүргэлт биш. Хэсэгчилсэн, бүтэлгүй, тодорхойгүй үр дүн харагдах ёстой.

Суулгах

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

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

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