ბიტრიქს24 პლაგინი

v1.0.x · განახლდა 2026-07-05

Bitrix24-ის დანამატი აერთებს თქვენს აგენტს Bitrix24-სთან, როგორც თანამშრომლების სწრაფი შეტყობინებების შიდა არხს. თანამშრომლები აგენტს წერს ისე, როგორც დაწერდნენ კოლეგას, ხოლო აგენტი პასუხობს Bitrix24 ჩატში.

[!WARNING] Bitrix24 აქ არის თანამშრომლებისთვის სწრაფი შეტყობინებების შიდა არხი — როგორც Telegram ან Slack სტაფისთვის. ეს არის არა კლიენტური ომნიქანალი: ღია ხაზები არ არის, არა ბილეთების რიგი და ოპერატორისთვის ესკალაციის არარსებობა. ნუ გამოიყენებთ ამ პლაგინს ფრონტენდისთვის კლიენტების მხარდაჭერის ხაზინი.

პლაგინი მუშაობს ჰოსტზე და ახდენს კომუნიკაციას გეითვეისთან მეშვეობით aihummer.connector.v1 კონტრაქტი. საბოლოო მომხმარებლის ქცევა არხზე განთავსებულია არხის გვერდზე ბიტრიქს24; ეს გვერდი ეხება თავად პლაგინს.

ფაქტები

ხელი	მნიშვნელობა
ვერსია	1.0.0
პორტი	8810
გადაწვის დრო	მასპინძლისთვის ბუნებრივი

რა არის ეს

ორმხრივი ხიდი Bitrix24 ჩატსა და AiHummer-ს შორის. აგენტი ჩანს როგორც ადამიანის მსგავსი იდენტობა Bitrix24-ში — თითოეული აგენტი ავტენტიფიცირდება საკუთარი OAuth ანგარიშით, არა ბოტის საერთო ანგარიშით — ამიტომ საუბრები აღიქმება როგორც კოლეგასთან კომუნიკაცია. წვდომა შეესაბამება ორგანიზაციის ACL განყოფილებების ხის პოლიტიკას, ასე რომ, აგენტის წვდომის არე შეესაბამება თქვენს Bitrix24 სტრუქტურას.

OAuth პირადობის დამადასტურებელებთან ერთად, მხარდაჭერილია სხვა მიწოდების გზები: აგენტის ანგარიშების ავტომატური შექმნა პორტალის ადმინისტრატორის შესვლის საშუალებით (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) და მიბმა წინასწარ შექმნილ Bitrix24 მომხმარებლებთან ფიქსირებული იდენტიფიკატორების მიხედვით (BITRIX24_AGENT_USER_IDS).

როგორ გამოიყენება ეს

მიღებული: პულ-პოლერი იღებს ახალ გზავნილებს და გადასცეს მათ უნივერსალური გეიტვეის შესასვლელი წერტილი, სადაც როუტერი განსაზღვრავს სამიზნე აგენტს.
გაგზავნილი: პასუხები გაიგზავნება კონექტორის იდემპოტენტური იდენტიფიკატორის საშუალებით მიტანება ნაბიჯი, რომელიც გარდაქმნის აგენტის Markdown-ს Bitrix24-ში BB-კოდი და გარანტირებს, რომ შეტყობინება ორჯერ არ გაიგზავნება.

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

მხარდაჭერილი ფუნქციები

პლაგინი უჭერს მხარს მდიდარ, ადამიანური ქცევის მსგავს ჩათს:

რეაქციები
შეტყობინებების რედაქტირება და წაშლა
ტექსტის შეყვანის ინდიკატორები
@-შეტყობინებები
მედია

შეზღუდვები

[!WARNING] ადამიანის მსგავსი მოდელი ამას ცნობივით აკეთებს არა ჩართეთ გარკვეული Bitrix24 ბოტი მახასიათებლები:

ინტერაქტიული კლავიატურები / ღილაკები არ არის და არ არსებობს ძაფები.

მიღებული მედია და ხმა არ გადაეცემა — შემოსული ესაა მხოლოდ ტექსტი. ა განცხადებითი იდენტურობა კოლეგის სტილში იღებს და პასუხობს ტექსტს; დანართები და ხმა ინფორმაცია, რომელიც აგენტისათვის არის გაგზავნილი, საუბრის პროცესში არ გადადის.

დაყენება

დააინსტალირეთ Bitrix24 ერთ კლიკზე მარკეტფლეისიდან ადმინისტრაციული ინტერფეისის საშუალებით. ჰოსტზე ადგილობრივი დეპლოიერი ჩამოტვირთავს პლაგინს, გაუშვებს მის ინსტალაციის ნაბიჯს, შეიქმნის სანდბოქსირებულ systemd ერთეულს და დაელოდება ჯანმრთელობის შემოწმებას, სანამ მზად არ მონიშნავს — ხილვა ინსტალაცია და განახლებები. შემდეგ თქვენ უკავშირისებთ ყველა აგენტის OAuth ანგარიშს და Department-ის ხეს შესაბამისობაში ყოფნით ACL-თან.

უსაფრთხოება და შეზღუდვები

მხოლოდ თანამშრომლთა შიდა შეტყობინებები — არაა ომნიკანალური მომხმარებლებისთვის.
ადამიანის მსგავსი OAuth-საიდენტიფიკაციო თითოეული აგენტისთვის — აგენტები ჩვეულებრივი ბოტ-ანგარიშები არ არიან.
ACL-ის განყოფილების ხე — ითვალისწინებს თქვენს ორგანიზაციულ სტრუქტურას.
იდენტპოტენტური მიწოდება — Markdown გარდაიქმნება BB-კოდად და არასდროს გაიგზავნება მეორედ.
მხოლოდ ტექსტი; კლავიატურები/თრეადები არ არის.
ადგილობრივი ჰოსტისთვის — მუშაობს systemd-ის ქვეშ, არა კონტეინერში.