Bitrix24 — դա աշխատակիցների համար ընդլայնված հաղորդագրությունների ներքին ալիք է — նույն դերը, որը Telegram-ը կամ Slack-ը խաղում են աշխատակիցների համար: AiHummer գործակալը հայտնվում է ձեր ընկերության Bitrix24-ում որպես գործընկերը, ինչպեսին աշխատակիցները կարող են գրել և հիշատակել նրան:
Հենքը մատակարարվում է որպես պրոդուկտից ելումով Շուկա և աշխատում է բնօրինակ կերպով հոստի վրա։ Այն կարգավորվում է վարչարարական ինտերֆեյսի միջոցով, ինչպես ցանկացած այլ ալիք։
[!NOTE]
Բիտրիքս24 ալիքը պահանջում է ակտիվություն Ստարտեր, Բիզնես կամ
ԱԿԸ համապատվաստագիր։ Community պլանի շրջանակում կոնեկտորը տեղադրելը վերադարձնում է
HTTP 402 «պահանջվում է թարմացում» (կոդ plan_limit) — տես
Լիցենզավորում.
[!WARNING]
Bitrix24 այստեղ խիստ է աշխատակիցների արագ հաղորդագրությունների ներքին ալիք. Սա ոչ
հաճախորդների օմնիկանալ ոչ Բիտրիքս24 բաց գծեր ոչ տոմսերի գծային հերթը, և
ոչ օպերատորի էսկալացիայի մակերես։ Մի օգտագործեք այն արտաքին նավիգացիայի համար
խոսակցություններ հաճախորդների հետ
Մարդանման գործակի նույնականություն
Այն յուրաքանչյուր գործակալ միանում է իր սեփականով Մարդանման 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-ն տվյալների ընդունման համար
Ընդհանուր մուտք.
**Bitrix24 — դա աշխատակիցների համար ընդլայնված հաղորդագրությունների ներքին ալիք է** — նույն դերը, որը Telegram-ը կամ Slack-ը խաղում են աշխատակիցների համար: AiHummer գործակալը հայտնվում է ձեր ընկերության Bitrix24-ում որպես գործընկերը, ինչպեսին աշխատակիցները կարող են գրել և հիշատակել նրան:
Հենքը մատակարարվում է որպես **պրոդուկտից ելումով [Շուկա](/hy/v1.0/marketplace/overview-tiers)** և աշխատում է բնօրինակ կերպով հոստի վրա։ Այն կարգավորվում է վարչարարական ինտերֆեյսի միջոցով, ինչպես ցանկացած այլ ալիք։
> [!NOTE]
> Բիտրիքս24 ալիքը պահանջում է ակտիվություն **Ստարտեր**, **Բիզնես** կամ
> **ԱԿԸ** համապատվաստագիր։ Community պլանի շրջանակում կոնեկտորը տեղադրելը վերադարձնում է
> **HTTP 402 «պահանջվում է թարմացում»** (կոդ `plan_limit`) — տես
> [Լիցենզավորում](/hy/v1.0/commercial/licensing).
> [!WARNING]
> Bitrix24 այստեղ խիստ է **աշխատակիցների արագ հաղորդագրությունների ներքին ալիք**. Սա **ոչ**
> հաճախորդների օմնիկանալ **ոչ** Բիտրիքս24 բաց գծեր **ոչ** տոմսերի գծային հերթը, և
> **ոչ** օպերատորի էսկալացիայի մակերես։ Մի օգտագործեք այն արտաքին նավիգացիայի համար
> խոսակցություններ հաճախորդների հետ
## Մարդանման գործակի նույնականություն
Այն յուրաքանչյուր գործակալ միանում է իր սեփականով **Մարդանման 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 ոճով կատարվել են դիտմամբ **ոչ** աջակցվում է
> մարդաձև մոդել:
>
> - **Ոչ ինտերակտիվ ստեղնաշարեր կամ կոճակներ** և **ոչ մի հոսանք**.
> - **Մուտքագրվող տեքստային հաղորդագրությունները, մեդիան և ձայնը փոխանցվում են** — պատկերներ, աուդիո, ձայն և ֆայլեր։
>
> Ծրագրեք գործակալի հոսքերը տեքստային փոխազդեցության շուրջ այս ալիքով։
## Որտեղից հետո
- Կապակցիչների տեղադրման մասին: [Շուկա](/hy/v1.0/marketplace/overview-tiers).
- Ինտերակտիվ զանգվածների և հարցումների համար օգտագործեք [Թելեգրամ](/hy/v1.0/channels/telegram)
կամ [ՄԱՔՍ](/hy/v1.0/channels/max).
- Դիտեք հիմնական API-ն տվյալների ընդունման համար
[Ընդհանուր մուտք](/hy/v1.0/channels/generic-inbound).