Bitrix24 spraudnis

v1.1.x · atjaunināts 2026-10-14

Bitrix24 spraudnis savieno jūsu aģentu ar Bitrix24 kā iekšējo darbinieku tūlītējās ziņojumapmaiņas kanālu. Darbinieki ziņo aģentam tāpat, kā viņi ziņotu kolēģim, un aģents atbild Bitrix24 tērzēšanā.

[!WARNING] Bitrix24 šeit ir iekšējais darbinieku IM kanāls — piemēram, Telegram vai Slack personālam. Tas ir ne klients viskanālu: nav Atvērtās Līnijas, nav biļešu rinda un bez operatora eskalācijas. Nelietojiet šo spraudni, lai pārvaldītu klientu atbalsta līnija

Spraudnis darbojas kā saimniekdators un sarunājas ar vārteju pa aihummer.connector.v1 līgums. Galalietotāja kanāla uzvedība ir kanāla lapā Bitrix24; šī lapa aptver pašu spraudni.

Tālāk aprakstītajiem medijiem un kopīgajam OAuth vajadzīgs parakstīts Core 1.4.15 un atsevišķi parakstīts savienotājs 1.1.1 pēc publicēšanas katalogā un atjaunināšanas. Instalēts 1.1.0 neapstiprina šo iespēju pieejamību.

Fakti

Lauks	Vērtība
Versija	1.1.1
Osta	8810
Izpildlaiks	saimniek-dzimtā

Kas tas ir

Divvirzienu tilts starp Bitrix24 tērzēšanu un AiHummer. Aģents parādās kā cilvēkam līdzīga identitāte Bitrix24 — katrs aģents autentificējas ar savu OAuth identitāti, nevis vispārīgu bota kontu — tāpēc sarunas šķiet kā saruna ar kolēģi. Piekļuve notiek saskaņā ar organizācijas departamentu-koks ACL, tāpēc aģenta darbības joma atbilst jūsu Bitrix24 struktūrai.

Atsevišķus portāla lietotājus norādiet BITRIX24_AGENT_USER_IDS, portālu – BITRIX24_PORTAL. Maršrutēšana pa nodaļām ierobežo darbinieku piekļuvi; aģenta konts neaizstāj uzdevuma iniciatoru. Izvēles esošā automātiskā sagatavošana izmanto BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Norādītajās versijās BITRIX24_VAULT_CONNECTIONS izvēlas esošus, derīgus, autonomus OAuth akreditācijas datus, kas pieder to īpašniekam. Izmantojiet atbalstīto vietējo glabātavas/savienojumu pārvaldību; to pašu datu ID izmantojiet rīku piesaistēs. Īstais īpašnieks reģistrē darbojošos savienotāju tā darbvietā ar /v1/admin/connections/channel un atsevišķu connection-token atslēgu. endpoint un apiKey pēc aģenta lietotāja ID ievietojiet slepenajā BITRIX24_VAULT_CONNECTIONS iestatījumā, ne aģenta profilā vai uzvednēs. Tikai glabātava atjauno pilnvaras; rīki pārbauda iniciatoru un kopīgošanu. Skatiet OAuth2.

Kā to lieto

Ienākošie: aptaujas process lasa ziņojumus. Mediji tiek lejupielādēti kā baiti un reģistrēti ar /v1/inbound/media; aģents saņem media_id, ne tikai URL vai faila metadatus.
Izejošie: Deliver pārveido Markdown par BB-code un augšupielādē īstus baitus ar im.v2.File.upload. Mediju apstiprināšanai vajadzīgi īsti FILE_ID un ziņojumu ID; teksts vai saite nav faila piegādes apliecinājums.

Atjauninot saglabājiet noturīgo piegādes žurnālu. Atkārtota apstiprināta darbība atgriež iepriekšējo apliecinājumu. Daļēja vai nezināma ietekme netiek automātiski nosūtīta vēlreiz; pārbaudiet to pirms atkārtošanas.

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

Atbalstītās funkcijas

Reakcijas un @-pieminējumi.
Rakstīšanas indikators un atbildes, ja konts un pakalpojuma sniedzējs atbalsta im.dialog.writing un REPLY_ID.
Ienākošie attēli, audio, balss un faili ar iepriekš norādītajām versiju prasībām.
Ziņojumu rediģēšana/dzēšana tikai senākām integrācijām ar atsevišķu bota identitāti; parastiem OAuth lietotājiem tās netiek deklarētas.

Ierobežojumi

[!WARNING] Interaktīvās tastatūras, pogas un pavedieni netiek atbalstīti.

Ģenerēts vai sagatavots fails nav apstiprināta piegāde. Daļējiem, neveiksmīgiem un nezināmiem rezultātiem jāpaliek redzamiem.

Uzstādīšana

Instalējiet Bitrix24 ar vienu klikšķi no tirgus vietas administrācijas saskarnē. Vietējais mitinājuma izvades rīks lejupielādē spraudni, veic tā instalācijas soli, renderē izolētu systemd vienību un gaida sistēmas veselības pārbaudi, pirms to atzīmē kā gatavu — skatīt Instalēšana un atjauninājumi. Pēc tam jūs savienojat katra aģenta OAuth identitāti un kartējat nodaļu koka ACL.

Drošība un ierobežojumi

Tikai iekšējam darbinieku IM — ne klienta omnicanāls.
Cilvēkam līdzīga OAuth identitāte katram aģentam — aģenti nav vispārīgi bot konti.
Departamentu koku ACL — reach respektē jūsu organizācijas struktūru.
Resursdatorspecifisks — darbojas zem systemd, nevis konteinerā.