Bitrix24 հավելված
Bitrix24 հավելվածը ձեր գործակալին միացնում է Bitrix24-ին որպես եկամտաբեր հաղորդագրությունների ներքին ալիք աշխատակիցների համար։ Անձնակազմը գործակալին հաղորդագրություն է ուղարկում նույն կերպ, ինչպես կուղարկեր գործընկերոջը, իսկ գործակալը պատասխանում է Bitrix24- ի զրույցում:
[!WARNING] Bitrix24 այստեղ է աշխատակիցների արագ հաղորդագրությունների ներքին ալիք — ինչպես Telegram կամ Slack աշխատակիցների համար. Դա է ոչ հաճախորդային օմնիկանալ՝ բաց Լինիաներ չկան, չկան փող Ticket-ների հերթ և օպերատորին նարգացումը բացակայություն. Մի օգտագործեք այս հավելումը ֆրոնթենդի համար Հաճախորդների աջակցման գիծ
Պլագինը աշխատում է հոստի վրա և հաղորդակցվում է դարպասի միջոցով aihummer.connector.v1 համաձայնագիր։ Ամբողջօրյա օգտագործողի վարքը ալիքում նշվում է ալիքի էջում Բիտրիքս24; այս էջը ընդգրկում է հենցպլագինը.
Ստորև նկարագրված մեդիան և ընդհանուր OAuth կապը պահանջում են ստորագրված Core 1.4.15 և առանձին ստորագրված 1.1.1 միակցիչ՝ կատալոգում հրապարակելուց և թարմացնելուց հետո։ Տեղադրված 1.1.0-ը չի հաստատում այդ հնարավորությունների հասանելիությունը։
Փաստեր
| Արտ | Արժեք |
|---|---|
| Թարմացում | 1.1.1 |
| Փորտ | 8810 |
| Գործարկման ժամանակ | ծագումով հոստի համար |
Ի՞նչ է սա
Երկկողմանի կամուրջ Bitrix24 չաթի և AiHummer-ի միջև։ Գործակալը հայտնվում է որպես մարդակազմային նույնություն Bitrix24-ում՝ յուրաքանչյուր գործակալը ինքն Authenticate է անցնում իր սեփական OAuth գրանցամուտով, այլ ոչ թե բոտի ընդհանուր գրանցամուտով՝ դրա պատճառով քննարկումները զգացվում են որպես գործընկերոջ հետ շփում. Դիմումը համապատասխան է կազմակերպության քաղաքականությանը ACL բաժնի ծառ, այնպես որ գործակալի ծածկույթը համապատասխան կլինի ձեր Bitrix24 կառուցվածքին։
Առանձին պորտալի օգտատերերին նշեք BITRIX24_AGENT_USER_IDS-ում, իսկ պորտալը՝ BITRIX24_PORTAL-ում։ Բաժինների երթուղավորումը սահմանափակում է աշխատակիցների մուտքը․ գործակալի հաշիվը չի փոխարինում առաջադրանքի նախաձեռնողին։ Առկա կամընտիր ավտոմատ պատրաստումն օգտագործում է BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD։
Նշված տարբերակներում BITRIX24_VAULT_CONNECTIONS-ը ընտրում է սեփականատիրոջը պատկանող առկա, վավեր, ինքնավար OAuth կապը։ Օգտագործեք աջակցվող տեղային պահոցի/կապերի կառավարումը․ նույն հավատարմագրման ID-ն ընտրեք գործիքների կապակցումներում։ Իրական սեփականատերը գրանցում է աշխատող միակցիչն իր աշխատանքային տարածքում /v1/admin/connections/channel-ով՝ առանձին connection-token բանալիով։ Գործակալ օգտատիրոջ ID-ով endpoint և apiKey-ն նշեք գաղտնի BITRIX24_VAULT_CONNECTIONS կարգավորման մեջ․ մի դրեք դրանք գործակալի պրոֆիլում կամ հարցումներում։ Միայն պահոցն է թարմացնում տոկենները․ գործիքները պահպանում են նախաձեռնողի և համօգտագործման ստուգումները։ Տե՛ս OAuth2։
Ինչպես է սա օգտագործվում
- Մուտքային․ հարցումը կարդում է հաղորդագրությունները։ Մեդիան ներբեռնվում է բայթերով և գրանցվում
/v1/inbound/media-ով․ գործակալը ստանում էmedia_id, ոչ միայն URL կամ ֆայլի նկարագրություն։ - Ելքային․
Deliver-ը Markdown-ը փոխարկում է BB-code-ի և իրական բայթերը վերբեռնումim.v2.File.upload-ով։ Մեդիայի հաստատումը պահանջում է իրականFILE_IDև հաղորդագրությունների ID-ներ․ տեքստը կամ հղումը ֆայլի անդորրագիր չէ։
Թարմացումների ժամանակ պահպանեք առաքման մշտական մատյանը։ Հաստատված գործողության կրկնությունը վերադարձնում է նախկին անդորրագիրը։ Մասնակի կամ անհայտ ազդեցությունները ինքնաբերաբար չեն կրկնվում․ ստուգեք դրանք նոր փորձից առաջ։
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24Աջակցվող գործառույթներ
- Արձագանքներ և @-հիշատակումներ։
- Գրման ցուցիչ և պատասխաններ, երբ հաշիվն ու հարթակը աջակցում են
im.dialog.writingևREPLY_ID։ - Մուտքային պատկերներ, աուդիո, ձայն և ֆայլեր՝ վերը նշված տարբերակների պահանջներով։
- Հաղորդագրությունների խմբագրում/ջնջում՝ միայն առանձին բոտի ինքնությամբ հին ինտեգրացիաներում․ սովորական OAuth օգտատերերի համար դրանք չեն հայտարարվում։
Սահմաններ
[!WARNING] Ինտերակտիվ ստեղնաշարերը, կոճակները և թեմատիկ շղթաները չեն աջակցվում։
Ստեղծված կամ պատրաստված ֆայլը հաստատված առաքում չէ։ Մասնակի, ձախողված և անհայտ արդյունքները պետք է տեսանելի մնան։
Տեղադրում
Ներբեռնեք Bitrix24 մեկ կտտոցով մարկետփլեյսից ադմինիստրատիվ ինտերֆեյսի միջոցով: Հոստին ներսի տեղադրման ծրագրիչը ներբեռնում է պլագինը, իրականացնում տեղադրման քայլը, ստեղծում մեկուսացված systemd-հաստատվածություն և սպասում է վիճակի ստուգման, նախքան այն նշելը որպես պատրաստը — տեսնել Տեղադրում և թարմացումներ. Դրանից հետո դուք միացնում եք յուրաքանչյուր գործակալի OAuth հաշիվը և համեմատում բաժանմունքների ծառը ACL-ի հետ:
Անվտանգություն և սահմանափակումներ
- Միայն աշխատակիցների ներքին հաղորդակցության փոխանակումը — հաճախորդների համար ոչ օմնիկանալական է։
- Մարդը նման OAuth-հայտնությունը յուրաքանչյուր գործակալի համար — գործակալները սովորական բոտ-հաշիվներ չեն։
- ACL բաժնի ծառ — հաշվի է առնում ձեր կազմակերպչական կառուցվածքը.
- Նատիվ՝ հոստի համար — աշխատում է systemd-ի տակ, այլ ոչ թե կոնտեյներում։