AiHummer
Беларуская▾
УвайсціАсабісты кабінет
v1.4.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Каналы/Бітрыкс24

Бітрыкс24

v1.4.x · абноўлена 2026-10-14

Bitrix24 — гэта ўнутраны канал імгненных паведамленняў для супрацоўнікаў — такую ж ролю, якую Telegram або Slack адыгрывае для супрацоўнікаў. Агент AiHummer з’яўляецца ў Bitrix24 вашай кампаніі як калега, з якім супрацоўнікі могуць перапісацца і згадваць у паведамленнях.

Канал адпраўляе ў якасці раз’ём унутры прадукту Рынак і працуе на роднай сістэме хаста. Ён наладжваецца праз Admin UI, як і любы іншы канал.

[!NOTE] Канал Bitrix24 патрабуе актыўнасці Стартап, Бізнэс ці Прадпрыемства ліцэнзія. Па плана супольнасці ўстаноўка раз’ема вяртае HTTP 402 «трэба абнаўленне» (код plan_limit) — гл. Ліцэнзаванне.

[!WARNING] Bitrix24 тут выключна унутраны канал імгненных паведамленняў для супрацоўнікаўГэта не кліент шматканальны не Адкрытыя лініі 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. У сакрэтнай настройцы BITRIX24_VAULT_CONNECTIONS задайце endpoint і apiKey па ID карыстальніка-агента; не змяшчайце іх у профілі або запыты агенту. Толькі сховішча абнаўляе токены; інструменты захоўваюць праверкі ініцыятара і сумеснага доступу. Гл. OAuth2.

Парты і час выканання

Порт Прызначэнне
8810 Сэрвіс канектара на loopback: праверка працаздольнасці і Deliver

Як працякаюць паведамленні

  • Уваходныя: апытанне чытае паведамленні. Медыя спампоўваецца байтамі і рэгіструецца праз /v1/inbound/media; агент атрымлівае media_id, а не толькі URL або звесткі пра файл.
  • Выходныя: Deliver ператварае Markdown у BB-code і загружае сапраўдныя байты праз im.v2.File.upload. Пацвярджэнне медыя патрабуе сапраўдных FILE_ID і ID паведамленняў; тэкст або спасылка не з’яўляюцца квітанцыяй файла.

Захоўвайце трывалы журнал дастаўкі пры абнаўленні. Паўтор пацверджанай аперацыі вяртае ранейшую квітанцыю. Частковыя або невядомыя эфекты аўтаматычна не адпраўляюцца паўторна; праверце іх перад паўторам.

Што падтрымліваецца

  • Рэакцыі і @-згадкі.
  • Набор і адказы, калі акаўнт і платформа падтрымліваюць im.dialog.writing і REPLY_ID.
  • Уваходныя выявы, аўдыё, голас і файлы з улікам патрабаванняў да версій вышэй.
  • Рэдагаванне/выдаленне паведамленняў — толькі ў старых інтэграцый з асобнай ідэнтычнасцю бота; для звычайных OAuth-карыстальнікаў яны не абвяшчаюцца.

[!WARNING] Інтэрактыўныя клавіятуры, кнопкі і галінкі не падтрымліваюцца.

Створаны або падрыхтаваны файл яшчэ не пацвярджае дастаўку. Частковыя, няўдалыя і невядомыя вынікі павінны заставацца бачнымі.

Куды далей