Bitrix24 არის შიდა თანამშრომელთა მყისიერი შეტყობინებების არხი — იგივე როლი,
რომელსაც Telegram ან Slack ასრულებს პერსონალისთვის. AiHummer-ის აგენტი ჩნდება თქვენი
კომპანიის Bitrix24-ში როგორც კოლეგა, რომელსაც თანამშრომლები შეტყობინებებს უგზავნიან და მოიხსენიებენ.
არხი მოწოდებულია როგორც კონექტორი პროდუქტში ჩაშენებული
Marketplace-დან და მუშაობს host-native რეჟიმში. ის
კონფიგურირდება Admin UI-დან, ისევე როგორც ნებისმიერი სხვა არხი.
[!WARNING]
Bitrix24 აქ მკაცრად არის შიდა თანამშრომელთა IM არხი. ის არ არის
მომხმარებელთა ომნიარხი, არ არის Bitrix24 Open Lines, არ არის ბილეთების რიგი და
არ არის ოპერატორზე ესკალაციის ზედაპირი. ნუ გამოიყენებთ მას გარე
მომხმარებლების საუბრების მარშრუტიზაციისთვის.
ადამიანის მსგავსი აგენტის იდენტობა
თითოეული აგენტი უკავშირდება საკუთარი ადამიანის მსგავსი OAuth იდენტობით, ასე რომ ის ჩნდება
Bitrix24-ში როგორც ცალკეული ადამიანი და არა ზოგადი ინტეგრაციის ბოტი. ხილვადობა
პატივს სცემს თქვენი ორგანიზაციის სტრუქტურას დეპარტამენტის-ხის ACL-ის მეშვეობით — აგენტი მხოლოდ
იქ ხედავს და მონაწილეობს, სადაც მის იდენტობას ნებადართულია, იმავე
დეპარტამენტის იერარქიის მიხედვით, რასაც თქვენი თანამშრომლები.
პორტები და გაშვების გარემო
კონექტორი იყენებს ფიქსირებული პორტების მცირე ნაკრებს:
პორტი
დანიშნულება
8810
კონექტორის სერვისი (ჯანმრთელობა და კონტროლი)
8080
მიწოდების endpoint (ნაგულისხმევი)
8791
OAuth თანხმობა
როგორ მოძრაობს შეტყობინებები
Bitrix24 არ უგზავნის შემომავალ მოვლენებს AiHummer-ს; კონექტორი იწევს მათ.
შემომავალი — pull poller კითხულობს ახალ შეტყობინებებს და აგზავნის მათ gateway-ში
/v1/inbound/generic-ზე.
გამავალი — პასუხები მიეწოდება aihummer.connector.v1Deliver კონტრაქტის მეშვეობით. აგენტის markdown გარდაიქმნება Bitrix24 BB-code-ად, ხოლო
მიწოდება იდემპოტენტურია, ასე რომ ხელახლა გაგზავნა არასოდეს ქმნის დუბლირებულ
შეტყობინებას.
რა არის მხარდაჭერილი
არხი მოიცავს იმ ურთიერთქმედებებს, რომლებიც ჯდება ადამიანის მსგავსი თანამშრომლის იდენტობაში:
რეაქციები, შეტყობინების რედაქტირება და წაშლა.
აკრეფის ინდიკატორები.
@-მოხსენიებები.
მედია გამავალ შეტყობინებებში.
[!WARNING]
ზოგიერთი Telegram-ის სტილის ფუნქცია მიზანმიმართულად არ არის მხარდაჭერილი
ადამიანის მსგავს მოდელში:
არანაირი ინტერაქტიული კლავიატურა ან ღილაკები და არანაირი thread-ები.
შემომავალი მედია და ხმა არ გადაიგზავნება — შემომავალი მხოლოდ ტექსტურია.
დაგეგმეთ აგენტის ნაკადები ამ არხზე ტექსტურ ურთიერთქმედებაზე დაყრდნობით.
**Bitrix24 არის შიდა თანამშრომელთა მყისიერი შეტყობინებების არხი** — იგივე როლი,
რომელსაც Telegram ან Slack ასრულებს პერსონალისთვის. AiHummer-ის აგენტი ჩნდება თქვენი
კომპანიის Bitrix24-ში როგორც კოლეგა, რომელსაც თანამშრომლები შეტყობინებებს უგზავნიან და მოიხსენიებენ.
არხი მოწოდებულია როგორც **კონექტორი პროდუქტში ჩაშენებული
[Marketplace](/ka/v1.0/marketplace/overview-tiers)-დან** და მუშაობს host-native რეჟიმში. ის
კონფიგურირდება Admin UI-დან, ისევე როგორც ნებისმიერი სხვა არხი.
> [!WARNING]
> Bitrix24 აქ მკაცრად არის **შიდა თანამშრომელთა IM არხი**. ის **არ არის**
> მომხმარებელთა ომნიარხი, **არ არის** Bitrix24 Open Lines, **არ არის** ბილეთების რიგი და
> **არ არის** ოპერატორზე ესკალაციის ზედაპირი. ნუ გამოიყენებთ მას გარე
> მომხმარებლების საუბრების მარშრუტიზაციისთვის.
## ადამიანის მსგავსი აგენტის იდენტობა
თითოეული აგენტი უკავშირდება საკუთარი **ადამიანის მსგავსი OAuth იდენტობით**, ასე რომ ის ჩნდება
Bitrix24-ში როგორც ცალკეული ადამიანი და არა ზოგადი ინტეგრაციის ბოტი. ხილვადობა
პატივს სცემს თქვენი ორგანიზაციის სტრუქტურას **დეპარტამენტის-ხის ACL-ის** მეშვეობით — აგენტი მხოლოდ
იქ ხედავს და მონაწილეობს, სადაც მის იდენტობას ნებადართულია, იმავე
დეპარტამენტის იერარქიის მიხედვით, რასაც თქვენი თანამშრომლები.
## პორტები და გაშვების გარემო
კონექტორი იყენებს ფიქსირებული პორტების მცირე ნაკრებს:
| პორტი | დანიშნულება |
|---|---|
| 8810 | კონექტორის სერვისი (ჯანმრთელობა და კონტროლი) |
| 8080 | მიწოდების endpoint (ნაგულისხმევი) |
| 8791 | OAuth თანხმობა |
## როგორ მოძრაობს შეტყობინებები
Bitrix24 არ უგზავნის შემომავალ მოვლენებს AiHummer-ს; კონექტორი **იწევს** მათ.
- **შემომავალი** — pull poller კითხულობს ახალ შეტყობინებებს და აგზავნის მათ gateway-ში
`/v1/inbound/generic`-ზე.
- **გამავალი** — პასუხები მიეწოდება `aihummer.connector.v1`
**Deliver** კონტრაქტის მეშვეობით. აგენტის **markdown გარდაიქმნება Bitrix24 BB-code-ად**, ხოლო
მიწოდება **იდემპოტენტურია**, ასე რომ ხელახლა გაგზავნა არასოდეს ქმნის დუბლირებულ
შეტყობინებას.
## რა არის მხარდაჭერილი
არხი მოიცავს იმ ურთიერთქმედებებს, რომლებიც ჯდება ადამიანის მსგავსი თანამშრომლის იდენტობაში:
- რეაქციები, შეტყობინების **რედაქტირება** და **წაშლა**.
- **აკრეფის** ინდიკატორები.
- **@-მოხსენიებები**.
- **მედია** გამავალ შეტყობინებებში.
> [!WARNING]
> ზოგიერთი Telegram-ის სტილის ფუნქცია მიზანმიმართულად **არ არის** მხარდაჭერილი
> ადამიანის მსგავს მოდელში:
>
> - **არანაირი ინტერაქტიული კლავიატურა ან ღილაკები** და **არანაირი thread-ები**.
> - **შემომავალი მედია და ხმა არ გადაიგზავნება** — შემომავალი **მხოლოდ ტექსტურია**.
>
> დაგეგმეთ აგენტის ნაკადები ამ არხზე ტექსტურ ურთიერთქმედებაზე დაყრდნობით.
## შემდეგ სად
- კონექტორების ინსტალაციის შესახებ: [Marketplace](/ka/v1.0/marketplace/overview-tiers).
- ინტერაქტიული კლავიატურებისა და გამოკითხვებისთვის გამოიყენეთ [Telegram](/ka/v1.0/channels/telegram)
ან [MAX](/ka/v1.0/channels/max).
- იხილეთ ძირითადი მიღების API აქ:
[Generic inbound](/ka/v1.0/channels/generic-inbound).