Битрикс24

**Bitrix24 як канали паёмнависи фаврии дохилии кормандон мебошад** — ҳамон нақшеро, ки Telegram ё Slack барои кормандон мебозад, мебозад. Як агенти AiHummer дар дохили Bitrix24-и ширкати шумо ҳамчун ҳамкор пайдо мешавад, ки кормандон метавонанд ба ӯ паём фиристанд ва ё ишора кунанд. Канал ҳамчун киштӣ ҳаракат мекунад **пайвасткунанда аз маҳсулот [Бозор](/tg/v1.0/marketplace/overview-tiers)** ва ба маҳалли корбарӣ мепайвад. Он аз интерфейси идоракунӣ танзим карда мешавад, мисли ҳама каналҳои дигар. > [!NOTE] > Канали Bitrix24 талаб мекунад, ки фаъол бошад **Оғозкунанда**, **Тиҷорат** ё > **Ширкат** иҷозатнома. Дар нақшаи Ҷамъиятӣ, насб кардани пайвасткунак бармегардад > **HTTP 402 "навсозии талабшаванда"** (код `plan_limit`) — бинед > [Литсензиядоркунӣ](/tg/v1.0/commercial/licensing). > [!WARNING] > Bitrix24 ин ҷо маҳз як **канали дохилии кормандон**Он аст **не** > мизоҷи чандканалӣ **не** Хатҳои Ҷӯрои Bitrix24, **не** навбат барои чипта, ва > **не** як сатҳи болоравии оператор. Барои роҳандозӣ кардани беруна истифода набаред > суҳбатҳои муштариён ## Шахсият ё агент бо хусусиятҳои инсонӣ Ҳар агент бо худи худ пайваст мешавад **шифти OAuth ба монанди инсон**бо ин роҳ он дар Bitrix24 ҳамчун шахси ҷудогона нишон дода мешавад на ҳамчун боти умумии ҳамгироӣ. Мушоҳида ба сохтори ташкилоти шумо мувофиқат мекунад **сохтмони-шохаии шуъба ACL** — агент танҳо он ҷо мебинад ва иштирок мекунад, ки шахсияташ иҷозат дода шудааст, бо пайравӣ аз ҳамон сохтори идораи кор, ки кормандони шумо мебошанд. Ғайр аз шахсияти OAuth, пайвасткунӣ инчунин роҳҳои дигар барои таъминкуниро дастгирӣ мекунад: **Ҳисобҳои агентии худпуштибонӣ тавассути воридшавӣ ба маъмури портал** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) ва васл шудан ба **Истифодабарандагони Bitrix24, ки пешакӣ бо ID-ҳои доимӣ сохта шудаанд** (`BITRIX24_AGENT_USER_IDS`). ## Бандарҳо ва вақти иҷро Пайвасткунанда ба як порти ягона гӯш медиҳад: | Бандар | Мақсад | |---|---| | 8810 | Хизматрасонии пайвасткунанда (сиҳатӣ, нуқтаи охирини Тақсим ва ризоияти OAuth) | ## Чӣ тавр паёмҳо мегузаранд Bitrix24 воқеаҳои воридшударо ба AiHummer пеш намебарад; пайвасткунӣ **ҷалб мекунад** онҳо. - **Воридшаванда** — як мухотиби ҷалбкунанда паёмҳои навро мехонад ва онҳоро ба дарвоза мефиристад дар `/v1/inbound/generic`. - **Берунрав** — посухҳо тавассути `aihummer.connector.v1` **Таҳвил додан** шартнома. Агенти **маркдаун ба рамзи BB-и Bitrix24 табдил дода мешавад**, ва таъсил **идемпотент**, бинобар ин фиристодани такрорӣ ҳеҷ гоҳ нусхаи такрориро истеҳсол намекунад паём. ## Чӣ пуштибонӣ мешавад Ин канал муомилоте, ки ба шахсияти корманди монанди инсон мувофиқ аст, фаро мегирад: - Вокунишҳо, паём **тарҳрезӣ** ва **ҳазф**. - **Навиштан** нишонаҳо. - **@-зикрҳо**. - **Воситаҳои ахбори омма** дар паёмҳои баровардашуда. > [!WARNING] > Баъзе хусусиятҳои услуби Телеграм бо мақсад ҳастанд **не** дар он тараф дастгирӣ карда шуд > намудори монанд ба инсон: > > - **Ҳеҷ клавиатура ё тугмаи интерактивӣ вуҷуд надорад** ва **ҳеҷ қабат**. > - **Матнҳои воридшуда, медиа ва садо ирсол карда мешаванд** — тасвирҳо, аудио, овоз ва файлҳо. > > Ҷараёнҳои агентиро вобаста ба муоширати матнӣ дар ин канал нақша кунед. ## Баъд ба куҷо - Дар бораи насби пайвасткунакҳо: [Бозор](/tg/v1.0/marketplace/overview-tiers). - Барои клавиатураҳои муоширатӣ ва назарсанҷӣ истифода баред [Телеграм](/tg/v1.0/channels/telegram) ё [МАХ](/tg/v1.0/channels/max). - API-и зерқабулкуниро бинед дар [Воридшавии умумӣ](/tg/v1.0/channels/generic-inbound).