Суваг/Bitrix24
Bitrix24
v1.0.x · шинэчилсэн 2026-10-14
Bitrix24 нь ажилчдын дотоод шуурхай мессежийн сувгуудын нэг юм — ажилтнуудад зориулсан Telegram эсвэл Slack-тэй ижил үүргийг гүйцэтгэнэ. AiHummer агент танай компанийн Bitrix24 дотор ажилтнууд мессеж илгээж, нэрийг нь дурьдаж болох хамтрагчаар гарч ирдэг.
Сувгийн кораб нь … болгон илгээгддэг бүтээгдэхүүнд суурилсан коннектор Зах зээл мөн хост-д зориулж ажилладаг. Энэ нь бусад сувгийн адил Админ UI-аас тохируулагддаг.
[!NOTE]
Bitrix24 сувгийн идэвхтэй байдал шаардлагатай Эхлүүлэгч, Бизнес эсвэл
Энтэрпрайз эрх. Нийгэмлэгийн төлөвлөгөөнд, холбогчийг суулгах нь буцаалт өгдөг
HTTP 402 “шинэчлэлт шаардлагатай” (код plan_limit) — үзэх
Лицензийн олголт.
[!WARNING]
Bitrix24 энд яг зөвхөн дотоод ажилтны IM суваг. Энэ нь гүй
үйлчлүүлэгч олон сувгийн гүй Bitrix24 Нээлттэй Мөрүүд, гүй тасалбарын дараалал, мөн
гүй операторын түвшинг ахиулах талбай. Гадна тийш чиглүүлэхэд битгий ашиглаарай
хуучилцсан хэрэглэгчийн яриа
Доорх медиа болон нийтлэг OAuth үйлдэл нь гарын үсэгтэй Core 1.4.15, мөн каталогт тусад нь нийтлэгдэж шинэчлэгдсэн, гарын үсэгтэй 1.1.1 холбогчийг шаарддаг. Суулгасан 1.1.0 эдгээр боломж бэлэн байгааг батлахгүй.
Хүний адил агентийн таних тэмдэг
Тусгай портал хэрэглэгчдийг 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-ыг үзнэ үү.
Портууд ба гүйцэтгэл
| Порт |
Зорилго |
| 8810 |
Loopback холбогч үйлчилгээ: төлөв шалгах болон Deliver |
Зурвасууд хэрхэн урсдаг
- Ирэх: асуулгын процесс зурвас уншина. Медиаг байтаар татаж
/v1/inbound/media-аар бүртгэнэ; агент зөвхөн URL эсвэл файлын мэдээлэл бус media_id авна.
- Гарах:
Deliver Markdown-ыг BB-code болгож, бодит байтыг im.v2.File.upload-аар байршуулна. Медиа батлахад бодит FILE_ID болон зурвасын ID хэрэгтэй; текст эсвэл холбоос файлын хүргэлтийн баримт биш.
Шинэчлэх үед тогтвортой хүргэлтийн бүртгэлийг хадгална уу. Баталгаажсан үйлдлийг давтахад өмнөх баримтыг буцаана. Хэсэгчилсэн эсвэл тодорхойгүй нөлөөг автоматаар дахин илгээхгүй; дахин оролдохоос өмнө шалгана уу.
Дэмжигддэг юу вэ
- Хариу үйлдэл болон @-дурдлага.
- Бүртгэл, үйлчилгээ үзүүлэгч
im.dialog.writing болон REPLY_ID дэмжвэл бичиж буй үзүүлэлт, хариулт.
- Дээрх хувилбарын шаардлагатай ирэх зураг, аудио, дуу хоолой болон файл.
- Зурвас засах/устгах нь тусдаа ботын таних мэдээлэлтэй хуучин интеграцад л байна; энгийн OAuth хэрэглэгчид зарлахгүй.
[!WARNING]
Интерактив гар, товч болон хэлэлцүүлгийн салааг дэмжихгүй.
Үүсгэсэн эсвэл бэлтгэсэн файл баталгаажсан хүргэлт биш. Хэсэгчилсэн, бүтэлгүй, тодорхойгүй үр дүн харагдах ёстой.
Дараа хаашаа явах вэ
**Bitrix24 нь ажилчдын дотоод шуурхай мессежийн сувгуудын нэг юм** — ажилтнуудад зориулсан Telegram эсвэл Slack-тэй ижил үүргийг гүйцэтгэнэ. AiHummer агент танай компанийн Bitrix24 дотор ажилтнууд мессеж илгээж, нэрийг нь дурьдаж болох хамтрагчаар гарч ирдэг.
Сувгийн кораб нь ... болгон илгээгддэг **бүтээгдэхүүнд суурилсан коннектор [Зах зээл](/mn/v1.4/marketplace/overview-tiers/)** мөн хост-д зориулж ажилладаг. Энэ нь бусад сувгийн адил Админ UI-аас тохируулагддаг.
> [!NOTE]
> Bitrix24 сувгийн идэвхтэй байдал шаардлагатай **Эхлүүлэгч**, **Бизнес** эсвэл
> **Энтэрпрайз** эрх. Нийгэмлэгийн төлөвлөгөөнд, холбогчийг суулгах нь буцаалт өгдөг
> **HTTP 402 "шинэчлэлт шаардлагатай"** (код `plan_limit`) — үзэх
> [Лицензийн олголт](/mn/v1.4/commercial/licensing/).
> [!WARNING]
> Bitrix24 энд яг зөвхөн **дотоод ажилтны IM суваг**. Энэ нь **гүй**
> үйлчлүүлэгч олон сувгийн **гүй** Bitrix24 Нээлттэй Мөрүүд, **гүй** тасалбарын дараалал, мөн
> **гүй** операторын түвшинг ахиулах талбай. Гадна тийш чиглүүлэхэд битгий ашиглаарай
> хуучилцсан хэрэглэгчийн яриа
Доорх медиа болон нийтлэг OAuth үйлдэл нь гарын үсэгтэй Core 1.4.15, мөн каталогт тусад нь нийтлэгдэж шинэчлэгдсэн, гарын үсэгтэй 1.1.1 холбогчийг шаарддаг. Суулгасан 1.1.0 эдгээр боломж бэлэн байгааг батлахгүй.
## Хүний адил агентийн таних тэмдэг
Тусгай портал хэрэглэгчдийг `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](/mn/v1.4/access/connections-oauth2/)-ыг үзнэ үү.
## Портууд ба гүйцэтгэл
| Порт | Зорилго |
|---|---|
| 8810 | Loopback холбогч үйлчилгээ: төлөв шалгах болон Deliver |
## Зурвасууд хэрхэн урсдаг
- Ирэх: асуулгын процесс зурвас уншина. Медиаг байтаар татаж `/v1/inbound/media`-аар бүртгэнэ; агент зөвхөн URL эсвэл файлын мэдээлэл бус `media_id` авна.
- Гарах: `Deliver` Markdown-ыг BB-code болгож, бодит байтыг `im.v2.File.upload`-аар байршуулна. Медиа батлахад бодит `FILE_ID` болон зурвасын ID хэрэгтэй; текст эсвэл холбоос файлын хүргэлтийн баримт биш.
Шинэчлэх үед тогтвортой хүргэлтийн бүртгэлийг хадгална уу. Баталгаажсан үйлдлийг давтахад өмнөх баримтыг буцаана. Хэсэгчилсэн эсвэл тодорхойгүй нөлөөг автоматаар дахин илгээхгүй; дахин оролдохоос өмнө шалгана уу.
## Дэмжигддэг юу вэ
- Хариу үйлдэл болон @-дурдлага.
- Бүртгэл, үйлчилгээ үзүүлэгч `im.dialog.writing` болон `REPLY_ID` дэмжвэл бичиж буй үзүүлэлт, хариулт.
- Дээрх хувилбарын шаардлагатай ирэх зураг, аудио, дуу хоолой болон файл.
- Зурвас засах/устгах нь тусдаа ботын таних мэдээлэлтэй хуучин интеграцад л байна; энгийн OAuth хэрэглэгчид зарлахгүй.
> [!WARNING]
> Интерактив гар, товч болон хэлэлцүүлгийн салааг дэмжихгүй.
>
> Үүсгэсэн эсвэл бэлтгэсэн файл баталгаажсан хүргэлт биш. Хэсэгчилсэн, бүтэлгүй, тодорхойгүй үр дүн харагдах ёстой.
## Дараа хаашаа явах вэ
- Холбогч суурилуулахад: [Зах зээл](/mn/v1.4/marketplace/overview-tiers/).
- Интерактив гар болон санал асуулгын хувьд ашиглана уу [Телеграм](/mn/v1.4/channels/telegram/)
эсвэл [МАКС](/mn/v1.4/channels/max/).
- Доорх өгөгдөл оруулалтын API-г үзнэ үү
[Ерөнхий орж ирэх](/mn/v1.4/channels/generic-inbound/).