Bitrix24 pistikprogramm

v1.4.x · uuendatud 2026-10-14

Bitrix24 pistikprogramm ühendab teie agendi Bitrix24-ga sisemise töötaja kiirsuhtluskanalina. Töötajad saadavad agendile sõnumi samamoodi, nagu nad saadaksid sõnumi kolleegile, ja agent vastab Bitrix24 vestluses.

[!WARNING] Bitrix24 siin on sisemine töötajate IM-kanal — nagu Telegram või Slack töötajatele. See on ei kliendi mitmekanaliline: avatud liine ei ole, ei ole piletijärjekord ja operaatori eskaleerimist ei toimu. Ära kasuta seda pistikprogrammi ettepoole suunamiseks klienditoe liin.

Pistikprogramm jookseb hosti natiivina ja suhtleb väravaga üle aihummer.connector.v1 leping. Lõppkasutaja kanali käitumine on kanali lehel Bitrix24; see leht käsitleb ise pluginat.

Allolev meedia ja ühine OAuth eeldavad allkirjastatud Core 1.4.15 ning eraldi allkirjastatud ühendaja 1.1.1 avaldamist kataloogis ja uuendamist. Paigaldatud 1.1.0 ei kinnita nende võimaluste kättesaadavust.

Faktid

Väli	Väärtus
Versioon	1.1.1
Sadam	8810
Käivitusajal	peremees-ja kohaliku

Mis see on

Kahepoolne sild Bitrix24 vestluse ja AiHummeri vahel. Agent ilmub kui inimese-laadne identiteet Bitrix24-s — iga agent autentib ennast oma OAuth-identiteediga, mitte üldise boti kontoga — seega tundub vestlus nagu rääkimine kolleegiga. Juurdepääs järgib organisatsiooni osakond-puu ACL, nii et agendi ulatus austab teie Bitrix24 struktuuri.

Määrake eraldi portaali kasutajad võtmes BITRIX24_AGENT_USER_IDS ja portaal võtmes BITRIX24_PORTAL. Osakondade marsruutimine piirab töötajate ligipääsu; agendi konto ei asenda ülesande algatajat. Valikuline olemasolev automaatne seadistus kasutab BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Nimetatud versioonides valib BITRIX24_VAULT_CONNECTIONS olemasoleva, kehtiva, autonoomse OAuth-mandaadi, mis kuulub selle omanikule. Kasutage toetatud natiivset hoidla/ühenduste haldust; kasutage sama mandaadi ID-d tööriistaseostes. Tegelik omanik registreerib töötava ühendaja selle tööruumis aadressil /v1/admin/connections/channel eraldi connection-token võtmega. Pange endpoint ja apiKey agendi kasutaja ID järgi salajasse BITRIX24_VAULT_CONNECTIONS sättesse, mitte agendiprofiili ega viipadesse. Ainult hoidla värskendab tokeneid; tööriistad kontrollivad tegutsejat ja jagamist. Vt OAuth2.

Kuidas seda kasutatakse

Sisend: küsitleja loeb sõnumeid. Meedia laaditakse alla baitidena ja registreeritakse /v1/inbound/media kaudu; agent saab media_id, mitte ainult URL-i või faili metaandmed.
Väljund: Deliver teisendab Markdowni BB-code’iks ja laadib tegelikud baidid üles im.v2.File.upload kaudu. Meedia kinnitamiseks on vaja tegelikke FILE_ID ja sõnumi ID-sid; tekst või link ei ole faili kviitung.

Säilitage uuendamisel püsiv kohaletoimetamise logi. Kinnitatud toimingu kordamine tagastab eelmise kviitungi. Osalist või teadmata mõju ei saadeta automaatselt uuesti; kontrollige seda enne kordamist.

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

Toetatud funktsioonid

Reaktsioonid ja @-mainimised.
Kirjutamisnäidik ja vastused, kui konto ja teenusepakkuja toetavad im.dialog.writing ja REPLY_ID.
Saabuvad pildid, heli, hääl ja failid ülaltoodud versiooninõuetega.
Sõnumite muutmine/kustutamine ainult varasemates eraldi boti identiteediga integratsioonides; tavaliste OAuth-kasutajate jaoks neid ei deklareerita.

Piirid

[!WARNING] Interaktiivseid klaviatuure, nuppe ja lõimesid ei toetata.

Loodud või ettevalmistatud fail ei tähenda kinnitatud kohaletoimetamist. Osalised, nurjunud ja teadmata tulemused peavad jääma nähtavaks.

Paigaldus

Paigalda Bitrix24 turuletilt ühe klikiga administraatori liidesest. Host-omane juurutaja laadib pistikprogrammi alla, käivitab selle paigaldamise sammu, kuvab liivakastitud systemd üksuse ja ootab tervist, enne kui märgib selle valmis olevaks — vaata Paigalda ja uuendused. Seejärel ühendate iga esindaja OAuth-identiteedi ja kaardistate osakonnapuu ACL-i.

Turvalisus ja piirid

Ainult siseinimeste IM — mitte kliendi mitmekanali
Agendi kohta inimese sarnane OAuth-identiteet — agendid ei ole üldised boti kontod.
Osakond-puu ACL — reach austab teie organisatsiooni struktuuri.
Host-mahine — töötab systemdi all, mitte konteineris.