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

Bitrix24

v1.2.x · жаңартылды 2026-07-05

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

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

[!NOTE] Bitrix24 арнасы белсенділікті талап етеді Бастауыш, Кәсіпкерлік немесе Кәсіпорын лицензия. Қауымдастық жоспары бойынша, коннекторды орнату нәтижесінде қайтарылады HTTP 402 «жаңарту қажет» (код plan_limit) — қараңыз Лицензиялау.

[!WARNING] Bitrix24 бұл жерде қатаң түрде ішкі қызметкердің IM арнасы. Бұл емес клиенттік омниканал емес Bitrix24 Ашық желілер емес билет кезегі, және емес операторды көтеру беті. Оны сыртқы жолға бағыттау үшін пайдаланбаңыз тұтынушылармен әңгімелер

Адамға ұқсас агенттің тұлғалығы

Әр агент өзімен байланысады адамға ұқсас OAuth сәйкестігі, сондықтан ол Bitrix24 жүйесінде жалпы интеграциялық бот емес, жеке тұлға ретінде көрсетіледі. Көріну сіздің ұйым құрылымыңызға сәйкес бақыланады бөлім-ағаш ACL — агент тек өзінің кім екені рұқсат етілген жерде ғана көрінеді және қатысады, сіздің қызметкерлеріңіз сияқты бірдей бөлім иерархиясын ұстана отырып.

OAuth идентификаторларынан бөлек, коннектор сонымен қатар басқа қамтамасыз ету жолдарын да қолдайды: портал әкімшісінің кіруі арқылы авто-провизия агенттік есептік жазбалары (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) және байланысу белгіленген идентификаторлар бойынша алдын ала құрылған Bitrix24 пайдаланушылары (BITRIX24_AGENT_USER_IDS).

Порттар және іске қосу уақыты

Коннектор бір портта тыңдайды:

Порт	Мақсат
8810	Коннектор қызметі (денсаулық, Deliver соңғы нүктесі және OAuth келісімі)

Хабарламалар қалай ағылады

Bitrix24 AiHummer-ге кіретін оқиғаларды жібермейді; қосқыш тарту оларды.

Кіріс — тарту тіркеушісі жаңа хабарларды оқып, оларды шлюзге жариялайды /v1/inbound/generic.
Шығыс — жауаптар арқылы жеткізіледі aihummer.connector.v1 Жеткізу келісімшарт. Агент markdown Bitrix24 BB-кодына айналдырылады, және жеткізу идемпотент, сондықтан қайта жіберу ешқашан көшірмені жасамайды хабарлама.

Қандай қолдау көрсетіледі

Бұл арна адамға ұқсас қызметкер идентификатына сәйкес келетін өзара әрекеттерді қамтиды:

Реакциялар, хабар өңдеу және өшіру.
Теріп жазу көрсеткіштер.
@-аталу.
Медиа шығарылатын хабарларда.

[!WARNING] Кейбір Telegram стиліндегі функциялар әдейі емес қолдау тапты адамға ұқсас модель:

Интерактивті пернетақталар немесе түймелер жоқ және жіптер жоқ.

Кіретін мәтіндер, медиа және дауыс бағытталады — суреттер, аудио, дауыс және файлдар.

Осы арнадағы мәтінге негізделген өзара әрекеттесу негізінде агент ағындарын жоспарлаңыз.

Келесі қайда

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