Bitrix24

**Bitrix24 — бул ички кызматкерлердин лезде билдирүү алмашуу каналы** — Telegram же Slack кызматкерлер үчүн ойногон ошол эле ролду аткарат. AiHummer агенти сиздин компанияңыздын Bitrix24'үндө кесиптеш катары көрүнөт, аны кызматкерлер билдирүү жөнөтүп жана белгилей (mention) алышат. Канал **продукттун ичиндеги [Marketplace](/ky/v1.0/marketplace/overview-tiers) коннектору** катары жеткирилет жана хост-нативдик иштейт. Ал, башка каналдар сыяктуу, Admin UI'ден конфигурацияланат. > [!WARNING] > Bitrix24 бул жерде катуу түрдө **ички кызматкерлердин IM каналы**. Ал **эмес** > кардарлардын омниканалы, **эмес** Bitrix24 Open Lines, **эмес** билеттер кезеги, > жана **эмес** операторго эскалациялоо бети. Аны тышкы кардарлардын > сүйлөшүүлөрүн багыттоо үчүн колдонбоңуз. ## Адамга окшош агент идентификациясы Ар бир агент өзүнүн **адамга окшош OAuth идентификациясы** менен туташат, ошондуктан ал Bitrix24'те жалпы интеграция боту эмес, өзүнчө инсан катары көрүнөт. Көрүнүүлүк **бөлүмдөр-дарагынын ACL'и** аркылуу сиздин уюмдук түзүмүңүздү сактайт — агент өзүнүн идентификациясына уруксат берилген жерде гана көрөт жана катышат, кызматкерлериңиз сыяктуу ошол эле бөлүмдөр иерархиясын ээрчип. ## Порттор жана рантайм Коннектор бекитилген порттордун кичинекей топтомун колдонот: | Порт | Максаты | |---|---| | 8810 | Коннектор кызматы (ден соолук жана башкаруу) | | 8080 | Жеткирүү эндпоинти (демейки) | | 8791 | OAuth макулдугу | ## Билдирүүлөр кантип агат Bitrix24 кирүүчү окуяларды AiHummer'ге түртпөйт; коннектор аларды **тартып алат**. - **Кирүүчү** — тартып алуу поллери жаңы билдирүүлөрдү окуйт жана аларды шлюзга `/v1/inbound/generic` дарегине жайгаштырат. - **Чыгуучу** — жооптор `aihummer.connector.v1` **Deliver** контракты аркылуу жеткирилет. Агенттин **markdown'ы Bitrix24 BB-кодуна айландырылат**, жана жеткирүү **идемпотенттик**, ошондуктан кайра жөнөтүлгөн билдирүү эч качан кайталанган билдирүү жаратпайт. ## Эмне колдоого алынат Канал адамга окшош кызматкердин идентификациясына туура келген өз ара аракеттенүүлөрдү камтыйт: - Реакциялар, билдирүүнү **түзөтүү** жана **өчүрүү**. - **Терип жатат** индикаторлору. - **@-белгилөөлөр**. - Чыгуучу билдирүүлөрдөгү **медиа**. > [!WARNING] > Кээ бир Telegram-стилиндеги функциялар адамга окшош моделде атайын **колдоого > алынбайт**: > > - **Интерактивдүү клавиатуралар же баскычтар жок** жана **жиптер (threads) жок**. > - **Кирүүчү медиа жана үн багытталбайт** — кирүүчү **текст-гана**. > > Бул каналда агенттин агымдарын текстке негизделген өз ара аракеттенүү боюнча > пландаштырыңыз. ## Андан ары кайда - Коннекторлорду орнотуу боюнча: [Marketplace](/ky/v1.0/marketplace/overview-tiers). - Интерактивдүү клавиатуралар жана сурамжылоолор үчүн [Telegram](/ky/v1.0/channels/telegram) же [MAX](/ky/v1.0/channels/max) колдонуңуз. - Негизги кабыл алуу API'син [Generic inbound](/ky/v1.0/channels/generic-inbound) бөлүмүнөн караңыз.