Bitrix24 — AiHummer Құжаттама

Bitrix24

v1.1.x · жаңартылды 2026-10-14

Bitrix24 — қызметкерлердің ішкі жедел хабар алмасу арнасы — қызметкерлер үшін Telegram немесе Slack атқаратын дәл сол рөл. AiHummer агенті сіздің компанияңыздың Bitrix24 ішінде әріптес ретінде пайда болады, оған қызметкерлер хабарлама жібере алады және атай алады.

Арна ретінде жіберіледі өнім ішіндегі қосқыш Нарық және хостта жергілікті түрде жұмыс істейді. Ол кез келген басқа арна сияқты Әкімші интерфейсінен бапталады.

[!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-ін құрал байланыстарында таңдаңыз. Нақты иесі жұмыс істеп тұрған коннекторды оның жұмыс кеңістігінде бөлек connection-token кілтімен /v1/admin/connections/channel арқылы тіркейді. Агент пайдаланушысының ID-і бойынша endpoint пен apiKey мәндерін құпия 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] Интерактивті пернетақталар, түймелер мен тармақтар қолдау таппайды.

Жасалған не дайындалған файл расталған жеткізу емес. Ішінара, сәтсіз және белгісіз нәтижелер көрініп тұруы керек.

Келесі қайда

Коннекторларды орнату кезінде: Нарық.
Интерактивті пернетақталар мен сауалнама үшін қолданыңыз Телеграм немесе МАКС.
Негізгі енгізу API интерфейсін қараңыз Жалпы кіріс.