AiHummer
Հայերեն▾
ՄուտքԱնձնական գրասենյակ
v1.0.x▾
{ }Swagger

Բիտրիքս24

v1.0.x · թարմացվել է 2026-10-14

Bitrix24 — դա աշխատակիցների համար ընդլայնված հաղորդագրությունների ներքին ալիք է — նույն դերը, որը Telegram-ը կամ Slack-ը խաղում են աշխատակիցների համար: AiHummer գործակալը հայտնվում է ձեր ընկերության Bitrix24-ում որպես գործընկերը, ինչպեսին աշխատակիցները կարող են գրել և հիշատակել նրան:

Հենքը մատակարարվում է որպես պրոդուկտից ելումով Շուկա և աշխատում է բնօրինակ կերպով հոստի վրա։ Այն կարգավորվում է վարչարարական ինտերֆեյսի միջոցով, ինչպես ցանկացած այլ ալիք։

[!NOTE] Բիտրիքս24 ալիքը պահանջում է ակտիվություն Ստարտեր, Բիզնես կամ ԱԿԸ համապատվաստագիր։ Community պլանի շրջանակում կոնեկտորը տեղադրելը վերադարձնում է HTTP 402 «պահանջվում է թարմացում» (կոդ plan_limit) — տես Լիցենզավորում.

[!WARNING] Bitrix24 այստեղ խիստ է աշխատակիցների արագ հաղորդագրությունների ներքին ալիք. Սա ոչ հաճախորդների օմնիկանալ ոչ Բիտրիքս24 բաց գծեր ոչ տոմսերի գծային հերթը, և ոչ օպերատորի էսկալացիայի մակերես։ Մի օգտագործեք այն արտաքին նավիգացիայի համար խոսակցություններ հաճախորդների հետ

Ստորև նկարագրված մեդիան և ընդհանուր OAuth կապը պահանջում են ստորագրված Core 1.4.15 և առանձին ստորագրված 1.1.1 միակցիչ՝ կատալոգում հրապարակելուց և թարմացնելուց հետո։ Տեղադրված 1.1.0-ը չի հաստատում այդ հնարավորությունների հասանելիությունը։

Մարդանման գործակի նույնականություն

Առանձին պորտալի օգտատերերին նշեք 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։

Նավահանգիստներ և կատարման ժամանակ

Պորտ Նպատակ
8810 Loopback միակցիչի ծառայություն․ առողջության ստուգում և Deliver

Ինչպես են հոսում հաղորդագրությունները

  • Մուտքային․ հարցումը կարդում է հաղորդագրությունները։ Մեդիան ներբեռնվում է բայթերով և գրանցվում /v1/inbound/media-ով․ գործակալը ստանում է media_id, ոչ միայն URL կամ ֆայլի նկարագրություն։
  • Ելքային․ Deliver-ը Markdown-ը փոխարկում է BB-code-ի և իրական բայթերը վերբեռնում im.v2.File.upload-ով։ Մեդիայի հաստատումը պահանջում է իրական FILE_ID և հաղորդագրությունների ID-ներ․ տեքստը կամ հղումը ֆայլի անդորրագիր չէ։

Թարմացումների ժամանակ պահպանեք առաքման մշտական մատյանը։ Հաստատված գործողության կրկնությունը վերադարձնում է նախկին անդորրագիրը։ Մասնակի կամ անհայտ ազդեցությունները ինքնաբերաբար չեն կրկնվում․ ստուգեք դրանք նոր փորձից առաջ։

Ինչ է աջակցվում

  • Արձագանքներ և @-հիշատակումներ։
  • Գրման ցուցիչ և պատասխաններ, երբ հաշիվն ու հարթակը աջակցում են im.dialog.writing և REPLY_ID։
  • Մուտքային պատկերներ, աուդիո, ձայն և ֆայլեր՝ վերը նշված տարբերակների պահանջներով։
  • Հաղորդագրությունների խմբագրում/ջնջում՝ միայն առանձին բոտի ինքնությամբ հին ինտեգրացիաներում․ սովորական OAuth օգտատերերի համար դրանք չեն հայտարարվում։

[!WARNING] Ինտերակտիվ ստեղնաշարերը, կոճակները և թեմատիկ շղթաները չեն աջակցվում։

Ստեղծված կամ պատրաստված ֆայլը հաստատված առաքում չէ։ Մասնակի, ձախողված և անհայտ արդյունքները պետք է տեսանելի մնան։

Որտեղից հետո

  • Կապակցիչների տեղադրման մասին: Շուկա.
  • Ինտերակտիվ զանգվածների և հարցումների համար օգտագործեք Թելեգրամ կամ ՄԱՔՍ.
  • Դիտեք հիմնական API-ն տվյալների ընդունման համար Ընդհանուր մուտք.