Telegram

**Telegram არის AiHummer-ის პროდუქციის ხარისხის, რეკომენდებული პირველი არხი.** ეს არის ყველაზე სწრაფი გზა, რომ მომუშავე აგენტი რეალური ადამიანების წინაშე გამოიყვანოთ: შექმენით ბოტი [@BotFather](https://t.me/BotFather)-ით, მიეცით კონექტორს token და შემომავალი შეტყობინებები იწყებენ მოძრაობას gateway-ში. Telegram კონექტორი ინსტალირდება პროდუქტში ჩაშენებული [Marketplace](/ka/v1.0/marketplace/overview-tiers)-დან და კონფიგურირდება Admin UI-ში. ის მუშაობს host-native რეჟიმში და ესაუბრება gateway-ს შემომავალი API-ის მეშვეობით, ასე რომ ის დამოუკიდებლად სკალირდება და გადაიტვირთება turn engine-ისგან. ## რატომ უნდა დაიწყოთ Telegram-ით Telegram-ს აქვს ყველაზე ნაკლები ხახუნი ნებისმიერ AiHummer არხს შორის: არანაირი კარიერი, არანაირი OAuth თანხმობის ეკრანი, არანაირი აპლიკაციის განხილვა. ბოტის token საკმარისია შეტყობინებების გასაგზავნად და მისაღებად, და იგივე კონექტორი მოიცავს როგორც შიდა პერსონალის ჩატებს, ისე მომხმარებლისკენ მიმართულ ბოტებს. იმის გამო, რომ ის პროდუქციის ხარისხისაა და სრულად გამოცდილია, ეს არის არხი, რომელსაც გირჩევთ პირველად დააკავშიროთ AiHummer-ის შეფასებისას. ## Polling ან webhook კონექტორი მხარს უჭერს ორივე მიღების რეჟიმს, ასე რომ ის მუშაობს მიუხედავად იმისა, თქვენი gateway მისაწვდომია თუ არა საჯარო ინტერნეტიდან. - **Long polling** — კონექტორი იწევს განახლებებს Telegram-დან. არანაირი შემომავალი პორტი ან TLS არ არის საჭირო, რაც მას იდეალურს ხდის ლოკალური განვითარებისა და კერძო ქსელებისთვის. - **Webhook** — Telegram უგზავნის განახლებებს საჯარო HTTPS URL-ზე. დაბალი ლატენტურობა და უკეთ შესაფერისი პროდუქციისთვის reverse proxy-ს უკან, რომელიც წყვეტს TLS-ს. კონექტორი უსმენს **პორტ 8800-ზე** ჩვეულებრივი დანერგვისას, ან **8091-ზე** ლოკალური გაშვებისთვის. თითოეული შემომავალი შეტყობინება იგზავნება gateway-ის URL-ზე, რომელიც კონფიგურირებულია `AIHUMMER_INBOUND_URL`-ში, ავთენტიფიცირებული გაზიარებული inbound საიდუმლოთი. ## მდიდარი შეტყობინებები, რეაქციები და გამოკითხვები უბრალო ტექსტის გარდა, Telegram არხი ასახავს **Rich Messages**-ს — ფორმატირებულ პასუხებს, რომლებიც აგენტის სტრუქტურირებულ გამოსავალს ასახავს Telegram-ის ნატიურ შეტყობინების ფუნქციებზე. ის ასევე მხარს უჭერს **რეაქციებსა** და **გამოკითხვებს**, ასე რომ აგენტს შეუძლია უპასუხოს მომხმარებლის შეტყობინებას რეაქციით ან ჩატში სწრაფი გამოკითხვა ჩასვას turn-ის ნაწილად. > [!TIP] > Telegram არის არხი, რომელიც AiHummer-ისთვის იდენტიფიცირებულია როგორც `telegram`. გამოიყენეთ ეს არხის > id, როდესაც აგენტს აკავშირებთ ან საუბრებს ფილტრავთ წყაროს მიხედვით. ## ბოტიდან-ბოტამდე loop guard-ით აგენტებს შეუძლიათ ესაუბრონ სხვა ბოტებს. ამის უსაფრთხოდ გასახდელად, კონექტორი მოწოდებულია **loop guard-ით**: ის ამოიცნობს და წყვეტს გაუკონტროლებელ ბოტიდან-ბოტამდე გაცვლებს, სანამ ისინი უსასრულო ping-pong-ად გადაიქცევიან. ეს საშუალებას გაძლევთ შეადგინოთ მრავალ-ბოტიანი workflow-ები კლასიკური feedback-loop ჩავარდნის რეჟიმის გარეშე. ## საიდუმლოების შუამავლობა OIDC-ით ბოტის token და კონექტორის სხვა საიდუმლოები არასოდეს არის hard-coded სერვისში. ნაცვლად ამისა, კონექტორი იღებს მათ გაშვების დროს **Secrets Service-დან OIDC-ით** — ის ავთენტიფიცირდება, შემდეგ იღებს რწმუნებებს, რომლებიც სჭირდება. საიდუმლოები რჩება დაშიფრულ vault-ში და კონფიგურაციის ფაილებისა და პროცესის არგუმენტების მიღმა. > [!NOTE] > შემომავალი შეტყობინებები იგზავნება `AIHUMMER_INBOUND_URL`-ზე და დაცულია > გაზიარებული HMAC inbound საიდუმლოთი (`AIHUMMER_INBOUND_SECRET`). gateway-ს უნდა ჰქონდეს > კონფიგურირებული ნაგულისხმევი workspace მათ გასაგზავნად. ## შემდეგ სად - შეადარეთ არხები [MAX](/ka/v1.0/channels/max), [Bitrix24](/ka/v1.0/channels/bitrix24) და [SIP ტელეფონია](/ka/v1.0/channels/sip) გზამკვლევებში. - არა-ჩატ წყაროებისთვის იხილეთ [Generic inbound](/ka/v1.0/channels/generic-inbound). - შენდებით API-ზე დაყრდნობით? იხილეთ [chat/completions](/ka/v1.0/api/chat-completions).