ტელეგრამი
ტელეგრამი — ეს არის წარმოებაზე ორიენტირებული, რეკომენდებული პირველი არხი AiHummer-ისთვის. ეს ყველაზე სწრაფი გზა გარე ადამიანებისთვის მუშაობაში მყოფი აგენტის ჩვენებაა: შექმნათ ბოტი @BotFather, გადასცით კონექტორს ტოქენი, და შემოსული შეტყობინებები დაიწყებენ პრივილეგიებით შესვლას გეითვეიში.
ტელეგრამის კონექტორი ინსტალირდება პროდუქტიდან ბაზარი და კონფიგურირებულია ადმინისტრატორის ინტერფეისში. იგი მუშაობს ჰოსტზე-ნატიულად და უკავშირდება გაღრმავებულ API-ს, ამიტომ მას შეუძლია სკალირება და ხელახლა დაწყება ტურნი-მოძრავისგან დამოუკიდებლად.
დაკავშირეთ Telegram 6 ნაბიჯში
ეს არის სრული გზა ნულიდან ბოლომდე ბოტამდე, რომელიც გიპასუხებთ Telegram-ში. ყველაფერი, რაც თქვენ გჭირდებათ, არის Telegram-ის ანგარიში და წვდომა თქვენი AiHummer-ს ადმინისტრატორის ვებ-პანელზე.
- შექმენით ბოტი BotFather-ის დახმარებით. გ otevრეთ Telegram-ში
@BotFather, გაგზავნა
/newbot, და დაადგინეთ ბოტის სახელი და მომხმარებლის სახელი. რას დაინახავთ: BotFather აბრუნებს ტოკენი მობრძანება123456789:AA…— ეს არის ბოტის წვდომის გასაღები, დააკოპირე იგი. - დაინსტალირეთ Telegram-ის კავშირი. ხელმძღანლური ინტერფეისში გახსენით პლაგინები/მარკეტპლეისი, იპოვნეთ Telegram-ს კავშირის კატალოგში გადადით და დააჭირეთ «აინსტალირეთ». დაელოდეთ, სანამ კარტა «ონლაინ» გახდება (ინსტალაცია) მიჩვენებს პროგრესის ინდიკატორს).
- ჩასვით ტოკენი. გადადით არხები ეკრანზე → დაყენებული არხების დაყენება შეინახეთ დაბლოკვა, გახსენით Telegram-ის ბარათი და ჩასვით ბოტის ტოკენი შენახვა ფორმის კონექტორის ველში.
- აგენტის შექმნა (თუ თქვენ ჯერ კიდევ არ გაქვთ) — ნახეთ აგენტები: საკმარისია სახელისა და სისტემური მოთხოვნის.
- დაამაგრეთ აგენტი არხზე. ზე არხები ეკრანზე «ბოჭკოები» ბლოკი, არჩევა სტანდარტული ეჯენტი ტელეგრამისთვის — წესი «ახალი მიმოწერები Telegram-ში წარმართავს აგენტი Y». არჩევანი ინახება დაუყოვნებლივ.
- გააგზავნეთ შეტყობინება ბოტს. გახსენით თქვენი ბოტი Telegram-ში და გაუგზავნეთ მას შეტყობინება. *რა თქვენ დაინახავთ: * აგენტი პასუხობს ჩეთში და ჩანს შესაბამისი საუბარი ადმინისტრაციულ ინტერფეისში, სესიათა ეკრანზე.
[!NOTE] სტანდარტულად ეჯენტი პასუხობს მხოლოდ ცნობილი მომხმარებლები (რეგისტრირებული ადამიანები AiHummer). თუ ბოტი დუმს თქვენს შეტყობინებაზე — დაამატეთ თავი როგორც ინსტანციის მომხმარებელი, ან გამორთეთ „შეიძლება უპასუხო მხოლოდ ცნობილ მომხმარებლებს“ არხები ეკრანი.
რატომ დაიწყოთ Telegram-ით
ტელეგრამში AiHummer-ის ყველა არხში მინიმალური სრიალი არის: არაა ოპერატორი კავშირისთვის, არაა OAuth თანხმობის ეკრანი, არაა აპლიკაციის გადამოწმება. საკმარისია ბოტის ტოკენი, რათა გაგზავნოთ და მიიღოთ შეტყობინებები, და იგივე კონექტორი მოიცავს როგორც შინაგან თანამშრომლების ჩატებს, ასევე ბოტები კლიენტებთან ურთიერთობისთვის. რადგან ეს არის სამრეწველო გადაწყვეტილება და სრულად გასინჯულია, ეს არის არხი, რომლის კავშირიც ჩვენ გირჩევთ პირველ რიგში AiHummer-ის შეფასების დროს.
გამოკითხვა ან ვებჰუკი
კონექტორი მხარს უჭერს ორივე ჩატვირთვის რეჟიმს, ამიტომ ის მუშაობს იმ შემთხვევაში, როდესაც თქვენი გეითვეი ხელმისაწვდომია საჯარო ინტერნეტიდან თუ არა.
- გრძელი გამოკითხვა — კონექტორი იღებს განახლებებს Telegram-იდან. შემომავალი პორტი არ არის ან საჭიროა TLS, რაც მას იდეალურს ხდის ადგილობრივი განვითარებისა და პირადი გამოყენებისთვის ქსელები.
- ვებჰუკი — ტელეგრამი გაგზავნის განახლებებს საჯარო HTTPS URL-ზე. უფრო დაბალი დაგვიანება და კარგად ერგება მუშაობას უკანა პროქსის საშუალებით, რომელიც ასრულებს TLS პროცესს.
კონექტორი ელის პორტი 8800 საშუალო განთავსებაში, ან 8091 ადგილობრივი დაწყებისთვის. ყველა შემომავალი შეტყობინება იგზავნება გეითვეის URL-ზე, რომელიც იყოს კონფიგურირებული AIHUMMER_INBOUND_URL, ავთენტიფიცირებულია საერთო შემომავალი საიდუმლოს გამოყენებით.
ბოლო გამდიდრებული შეტყობინებები, შეტყობინებებზე რეაქციები და გამოკითხვები
სხვა ჩვეულებრივი ტექსტის გარდა, ტელეგრამის არხი წარმოადგენს მდიდარი შეტყობინებები — ფორმატირებული პასუხები, რომლებიც ამცნობს აგენტის სტრუქტურირებულ გამოშვებას Telegram-ის შიდა შეტყობინების ფუნქციებთან. ასევე იგი მხარს უჭერს მოვლენები შეტყობინებებზე და გამოკითხვები, რათა აგენტი შეძლოს მომხმარებლის შეტყობინებაზე რეაგირება ან ჩართოს სწრაფი გამოკითხვა ჩეთში ერთ ნაბიჯში.
[!TIP] ტელეგრამი — ეს არის არხი, რომელიც AiHummer-მა აღუწერა როგორც
telegram. გამოიყენეთ ეს არხი ამომცნობი, როდესაც თქვენ აკავშირებთ აგენტს ან ფილტრავთ საუბრებს წყაროს მიხედვით.
ბოტი ბოტთან ერთად განმეორებისგან დაცვის საშუალებით
მსახურულები შეუძლიათ ერთმანეთთან ბოტებთან კომუნიკაცია. უსაფრთხო დასაზღვევად, კონექტორი შედის ციკლის დამცველი: იგი ხვდება და იჭერს კონტროლირებად გარეთ გამოტანილ კომუნიკაციას ბოტებს შორის, სანამ ისინი გაუჩინარებულ პინგ-პონგად არ გადაიქცევიან. ეს საშუალებას აძლევს შექმნას სამუშაო პროცესები მრავალბოტიან რეჟიმში კლასიკური შეცდომის რეჟიმის გარეშე, უკუკავშირის წრიული ციკლის გამო.
საიდუმლო გამშვები OIDC-ის მეშვეობით
ბოტის ტოკენი და კავშირის სხვა საიდუმლოებები არასოდეს იწერება სერვისის კოდში. ამის ნაცვლად, კონექტორი მათ მიიღებს შესრულების დროს საიდუმლოების სერვისი OIDC-ის მეშვეობით — ის ახორციელებს ავთენტიფიკაციას, შემდეგ კი იღებს საჭირო მონაცემებს. საიდუმლოებები რჩებიან დაშიფრულ საცავში და არ ხვდებიან კონფიგურაციულ ფაილებშიც და პროცესების არგუმენტებშიც.
[!NOTE] მოსული შეტყობინებები გამოქვეყნებულია
AIHUMMER_INBOUND_URLდა მტკიცდება ერთობლივი შემომავალი საიდუმლო HMAC (AIHUMMER_INBOUND_SECRET). კარიბჭე უნდა ჰქონდეს ნაგულისხმევი სამუშაო სივრცე უკვე დაყენებულია მათი გასაგზავნად.
თუ ეს არ მუშაობს
- ტელეგრამის კონექტორი არ არის ეკრანზე „არხები“ — ჯერ მიიღეთ ეს ეს პლაგინები/მარკეტპლეისი ეკრანი; ინსტალაციამდე არხი არ გამოისახება. Community-ის თვალსაზრისით, ხელმისაწვდომია მხოლოდ Telegram; სხვა საჭიროებს განახლებას (HTTP 402).
- ობოტი პასუხს არ იძლევა — შემოწმება: (1) ტოკენი სწორად არის ჩასმული და ტელეგრამის ბარათი არის სტატუსში «ონლაინ»; (2) არხი დაკავშირებულია აგენტთან «კავშირებში»; (3) გამგზავნი რეგისტრირებულია სისტემაში (ნაგულისხმევად აგენტი პასუხობს მხოლოდ ცნობილი მომხმარებლები).
- პასუხები ეჩვენება სხრილოვანად — სავარაუდოდ, ტესტური მოდელი ჯერ კიდევ აქტივია; შეაერთეთ მიწოდებელი მოდელები გვერდი.
- “აუკრძალავია” / ტოკენი უარყოფილია — ტოკენი არასწორია ან უკან მოწვეულა; გააკეთეთ ახალი
ახალი ს @BotFather (
/token) და ჩასვით ეს ისევ. - ვებჰუკი არ მოდის — ვებჰუკის რეჟიმში გეიტვეი უნდა იყოს ხელმისაწვდომი საჯარო HTTPS URL; პრივატურ ქსელში გამოიყენეთ გრძელი გამოკითხვა, რომელიც არ საჭიროებს შემომავალი კავშირის პორტი ან TLS.
სად შემდეგ?
- გაიგივეთ არხები მაქს, ბიტრიქს24 და SIP-ტელეფონია გიდები.
- დაკავშირებები და წვდომის კონფიგურაცია — არხები.
- ცენზურასთან არ დაკავშირებული წყაროებისთვის, იხ. საერთო შემომავალი.
- ქვესტთინი API-ს წინააღმდეგ? შეხედეთ ჩატი/დასრულება.