AiHummer
Lietuvių▾
PrisijungtiPaskyra
v1.1.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanalai/Bitrix24

Bitrix24

v1.1.x · atnaujinta 2026-10-14

Bitrix24 yra vidinis darbuotojų momentinių žinučių kanalas — tas pats vaidmuo, kurį Telegram ar Slack atlieka darbuotojams. AiHummer agentas pasirodo jūsų įmonės Bitrix24 kaip kolega, su kuriuo darbuotojai gali rašyti žinutes ir minėti.

Kanalas siunčia kaip jungtis iš produkto viduje Prekyvietė ir veikia tiesiogiai ant šeimininko. Jis konfigūruojamas iš administratoriaus sąsajos, kaip ir bet kuris kitas kanalas.

[!NOTE] Bitrix24 kanalui reikalinga aktyvi Starteris, Verslas arba Įmonė licencija. Bendruomenės plane jungiklio įdiegimas grąžina HTTP 402 „reikalingas atnaujinimas“ (kodas plan_limit) — žiūrėti Licencijavimas.

[!WARNING] Bitrix24 čia yra griežtai vidinis darbuotojų IM kanalas. Tai yra ne klientų daugiakanalis ne Bitrix24 Atviros linijos ne bilietų eilė, ir ne operatoriaus eskalacijos paviršius. Nenaudokite jo maršrutuoti išoriniams klientų pokalbiai.

Toliau aprašytai medijai ir bendram OAuth reikia pasirašyto Core 1.4.15 ir atskirai pasirašyto 1.1.1 jungiklio po paskelbimo kataloge ir atnaujinimo. Įdiegtas 1.1.0 nepatvirtina šių galimybių prieinamumo.

Žmogaus panašaus agento tapatybė

Atskirus portalo naudotojus nustatykite BITRIX24_AGENT_USER_IDS, portalą – BITRIX24_PORTAL. Maršrutizavimas pagal skyrius riboja darbuotojų prieigą; agento paskyra nepakeičia užduoties iniciatoriaus. Pasirinktinai esamas automatinis paruošimas naudoja BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Nurodytose versijose BITRIX24_VAULT_CONNECTIONS parenka esamą, galiojantį, autonominį OAuth prisijungimo duomenį, priklausantį jo savininkui. Naudokite palaikomą savąjį saugyklos/ryšių valdymą; tą patį duomens ID naudokite įrankių susiejimuose. Tikrasis savininkas registruoja veikiantį jungiklį jo darbo srityje per /v1/admin/connections/channel su atskiru connection-token raktu. endpoint ir apiKey pagal agento naudotojo ID įrašykite slaptame BITRIX24_VAULT_CONNECTIONS nustatyme, niekada ne agento profilyje ar užklausose. Tik saugykla atnaujina žetonus; įrankiai tikrina iniciatorių ir bendrinimą. Žr. OAuth2.

Prievadai ir vykdymo laikas

Prievadas Paskirtis
8810 Jungiklio paslauga per loopback: būsena ir Deliver

Kaip teka žinutės

  • Įvestis: apklausos procesas skaito pranešimus. Medija atsisiunčiama baitais ir registruojama per /v1/inbound/media; agentas gauna media_id, ne tik URL ar failo metaduomenis.
  • Išvestis: Deliver konvertuoja Markdown į BB-code ir įkelia tikrus baitus per im.v2.File.upload. Medijos patvirtinimui reikia tikrų FILE_ID ir pranešimų ID; tekstas ar nuoroda nėra failo kvitas.

Atnaujindami išsaugokite patvarų pristatymo žurnalą. Pakartota patvirtinta operacija grąžina ankstesnį kvitą. Daliniai ar nežinomi padariniai automatiškai nesiunčiami dar kartą; prieš kartodami juos patikrinkite.

Kas yra palaikoma

  • Reakcijos ir @-paminėjimai.
  • Rašymo indikatorius ir atsakymai, kai paskyra bei teikėjas palaiko im.dialog.writing ir REPLY_ID.
  • Gaunami vaizdai, garsas, balsas ir failai pagal pirmiau nurodytus versijų reikalavimus.
  • Pranešimų redagavimas/šalinimas tik senoms integracijoms su atskira boto tapatybe; įprastiems OAuth naudotojams šios galimybės neskelbiamos.

[!WARNING] Interaktyvios klaviatūros, mygtukai ir gijos nepalaikomi.

Sukurtas ar paruoštas failas nėra patvirtintas pristatymas. Daliniai, nepavykę ir nežinomi rezultatai turi likti matomi.

Kur toliau