Bitrix24-ը ներքին աշխատակիցների ակնթարթային հաղորդագրությունների ալիք է — նույն
դերը, որ Telegram-ը կամ Slack-ը խաղում են անձնակազմի համար։ AiHummer-ի գործակալը հայտնվում է ձեր
ընկերության Bitrix24-ում որպես գործընկեր, որին աշխատակիցները կարող են գրել և նշել։
Ալիքը մատակարարվում է որպես կոնեկտոր ապրանքի ներսում գործող
Marketplace-ից և աշխատում է host-native ռեժիմով։ Այն
կարգավորվում է Admin UI-ից, ինչպես ցանկացած այլ ալիք։
[!WARNING]
Bitrix24-ն այստեղ խստորեն ներքին աշխատակիցների IM ալիք է։ Այն չէ
հաճախորդների բազմալիք միջավայր, չէ Bitrix24 Open Lines, չէ տոմսերի հերթ, և
չէ օպերատորի փոխանցման մակերես։ Մի օգտագործեք այն արտաքին
հաճախորդների զրույցները ուղղորդելու համար։
Մարդանման գործակալի ինքնություն
Յուրաքանչյուր գործակալ միանում է իր սեփական մարդանման OAuth ինքնությամբ, այնպես որ Bitrix24-ում այն
հայտնվում է որպես առանձին անձ, այլ ոչ թե ընդհանուր ինտեգրման բոտ։ Տեսանելիությունը
հարգում է ձեր կազմակերպության կառուցվածքը բաժինների ծառի ACL-ի միջոցով — գործակալը միայն
տեսնում և մասնակցում է այնտեղ, որտեղ թույլատրված է իր ինքնությունը՝ հետևելով նույն
բաժինների հիերարխիային, ինչ ձեր աշխատակիցները։
Պորտեր և runtime
Կոնեկտորն օգտագործում է ֆիքսված պորտերի փոքր հավաքածու.
Պորտ
Նպատակ
8810
Կոնեկտորի ծառայություն (health և control)
8080
Առաքման endpoint (լռելյայն)
8791
OAuth համաձայնություն
Ինչպես են հոսում հաղորդագրությունները
Bitrix24-ը մուտքային իրադարձությունները չի մղում AiHummer-ին. կոնեկտորը քաշում է դրանք։
Մուտքային — pull poller-ը կարդում է նոր հաղորդագրությունները և տեղադրում դրանք gateway-ում
/v1/inbound/generic հասցեում։
Ելքային — պատասխանները առաքվում են aihummer.connector.v1Deliver պայմանագրով։ Գործակալի markdown-ը փոխակերպվում է Bitrix24 BB-code-ի, և
առաքումը իդեմպոտենտ է, այնպես որ կրկնված ուղարկումը երբեք չի առաջացնում կրկնակի
հաղորդագրություն։
Ինչ է աջակցվում
Ալիքը ընդգրկում է այն փոխազդեցությունները, որոնք համապատասխանում են մարդանման աշխատակցի ինքնությանը.
Ռեակցիաներ, հաղորդագրության խմբագրում և ջնջում։
Տպելու ինդիկատորներ։
@-նշումներ։
Մեդիա ելքային հաղորդագրություններում։
[!WARNING]
Telegram-ի ոճի որոշ ֆունկցիաներ միտումնավոր չեն աջակցվում
մարդանման մոդելում.
Չկան ինտերակտիվ ստեղնաշարեր կամ կոճակներ և չկան threads։
Մուտքային մեդիան և ձայնը չեն փոխանցվում — մուտքայինը միայն տեքստ է։
Պլանավորեք գործակալի հոսքերը այս ալիքում տեքստի վրա հիմնված փոխազդեցության շուրջ։
**Bitrix24-ը ներքին աշխատակիցների ակնթարթային հաղորդագրությունների ալիք է** — նույն
դերը, որ Telegram-ը կամ Slack-ը խաղում են անձնակազմի համար։ AiHummer-ի գործակալը հայտնվում է ձեր
ընկերության Bitrix24-ում որպես գործընկեր, որին աշխատակիցները կարող են գրել և նշել։
Ալիքը մատակարարվում է որպես **կոնեկտոր ապրանքի ներսում գործող
[Marketplace](/hy/v1.0/marketplace/overview-tiers)-ից** և աշխատում է host-native ռեժիմով։ Այն
կարգավորվում է Admin UI-ից, ինչպես ցանկացած այլ ալիք։
> [!WARNING]
> Bitrix24-ն այստեղ խստորեն **ներքին աշխատակիցների IM ալիք է**։ Այն **չէ**
> հաճախորդների բազմալիք միջավայր, **չէ** Bitrix24 Open Lines, **չէ** տոմսերի հերթ, և
> **չէ** օպերատորի փոխանցման մակերես։ Մի օգտագործեք այն արտաքին
> հաճախորդների զրույցները ուղղորդելու համար։
## Մարդանման գործակալի ինքնություն
Յուրաքանչյուր գործակալ միանում է իր սեփական **մարդանման OAuth ինքնությամբ**, այնպես որ Bitrix24-ում այն
հայտնվում է որպես առանձին անձ, այլ ոչ թե ընդհանուր ինտեգրման բոտ։ Տեսանելիությունը
հարգում է ձեր կազմակերպության կառուցվածքը **բաժինների ծառի ACL**-ի միջոցով — գործակալը միայն
տեսնում և մասնակցում է այնտեղ, որտեղ թույլատրված է իր ինքնությունը՝ հետևելով նույն
բաժինների հիերարխիային, ինչ ձեր աշխատակիցները։
## Պորտեր և runtime
Կոնեկտորն օգտագործում է ֆիքսված պորտերի փոքր հավաքածու.
| Պորտ | Նպատակ |
|---|---|
| 8810 | Կոնեկտորի ծառայություն (health և control) |
| 8080 | Առաքման endpoint (լռելյայն) |
| 8791 | OAuth համաձայնություն |
## Ինչպես են հոսում հաղորդագրությունները
Bitrix24-ը մուտքային իրադարձությունները չի մղում AiHummer-ին. կոնեկտորը **քաշում է** դրանք։
- **Մուտքային** — pull poller-ը կարդում է նոր հաղորդագրությունները և տեղադրում դրանք gateway-ում
`/v1/inbound/generic` հասցեում։
- **Ելքային** — պատասխանները առաքվում են `aihummer.connector.v1`
**Deliver** պայմանագրով։ Գործակալի **markdown-ը փոխակերպվում է Bitrix24 BB-code-ի**, և
առաքումը **իդեմպոտենտ** է, այնպես որ կրկնված ուղարկումը երբեք չի առաջացնում կրկնակի
հաղորդագրություն։
## Ինչ է աջակցվում
Ալիքը ընդգրկում է այն փոխազդեցությունները, որոնք համապատասխանում են մարդանման աշխատակցի ինքնությանը.
- Ռեակցիաներ, հաղորդագրության **խմբագրում** և **ջնջում**։
- **Տպելու** ինդիկատորներ։
- **@-նշումներ**։
- **Մեդիա** ելքային հաղորդագրություններում։
> [!WARNING]
> Telegram-ի ոճի որոշ ֆունկցիաներ միտումնավոր **չեն** աջակցվում
> մարդանման մոդելում.
>
> - **Չկան ինտերակտիվ ստեղնաշարեր կամ կոճակներ** և **չկան threads**։
> - **Մուտքային մեդիան և ձայնը չեն փոխանցվում** — մուտքայինը **միայն տեքստ է**։
>
> Պլանավորեք գործակալի հոսքերը այս ալիքում տեքստի վրա հիմնված փոխազդեցության շուրջ։
## Ուր հաջորդիվ
- Կոնեկտորների տեղադրման մասին՝ [Marketplace](/hy/v1.0/marketplace/overview-tiers)։
- Ինտերակտիվ ստեղնաշարերի և հարցումների համար օգտագործեք [Telegram](/hy/v1.0/channels/telegram)
կամ [MAX](/hy/v1.0/channels/max)։
- Տեսեք հիմքում ընկած ընդունման API-ն
[Generic inbound](/hy/v1.0/channels/generic-inbound)-ում։
