AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.2.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Каналҳо/Битрикс24

Битрикс24

v1.2.x · навсозӣ шуд 2026-10-14

Bitrix24 як канали паёмнависи фаврии дохилии кормандон мебошад — ҳамон нақшеро, ки Telegram ё Slack барои кормандон мебозад, мебозад. Як агенти AiHummer дар дохили Bitrix24-и ширкати шумо ҳамчун ҳамкор пайдо мешавад, ки кормандон метавонанд ба ӯ паём фиристанд ва ё ишора кунанд.

Канал ҳамчун киштӣ ҳаракат мекунад пайвасткунанда аз маҳсулот Бозор ва ба маҳалли корбарӣ мепайвад. Он аз интерфейси идоракунӣ танзим карда мешавад, мисли ҳама каналҳои дигар.

[!NOTE] Канали Bitrix24 талаб мекунад, ки фаъол бошад Оғозкунанда, Тиҷорат ё Ширкат иҷозатнома. Дар нақшаи Ҷамъиятӣ, насб кардани пайвасткунак бармегардад HTTP 402 “навсозии талабшаванда” (код plan_limit) — бинед Литсензиядоркунӣ.

[!WARNING] Bitrix24 ин ҷо маҳз як канали дохилии кормандонОн аст не мизоҷи чандканалӣ не Хатҳои Ҷӯрои Bitrix24, не навбат барои чипта, ва не як сатҳи болоравии оператор. Барои роҳандозӣ кардани беруна истифода набаред суҳбатҳои муштариён

Медиа ва 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 сабт мекунад. endpoint ва apiKey-ро аз рӯйи ID-и корбари агент дар танзими махфии 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] Клавиатураҳои интерактивӣ, тугмаҳо ва шохаҳои муҳокима дастгирӣ намешаванд.

Файли сохташуда ё омодашуда расонидани тасдиқшуда нест. Натиҷаҳои қисман, ноком ва номаълум бояд намоён монанд.

Баъд ба куҷо