Telegram ბოტის ინტეგრაცია
ეს სახელმძღვანელო განმარტავს, თუ როგორ დააკავშიროთ თქვენი Telegram Bot chat.smsbat.com პანელთან.
1. ბოტის დამატება პანელზე
საინფორმაციო დაფაზე გადადით ჩემი ანგარიშები -> ტელეგრამის ბოტები.
- დააწკაპუნეთ Add Bot.
- შეავსეთ Telegram-ის ბოტის მონაცემები (სახელი, ჟეტონი) და შეინახეთ სისტემაში.
- შენახვის შემდეგ გადადით ბოტის პარამეტრებზე და მიიღეთ მისი ID, რათა ჩამოაყალიბოთ გამოძახების URL.
2. ინტეგრაციის ვარიანტები Chat.SMSBAT-თან
ვარიანტი 2.1: პროქსი გამოძახება Telegram-დან Omni Chat-ში
ამ ნაკადში, თქვენი სერვერი პირდაპირ იღებს Telegram webhook-ს და შემდეგ გადასცემს დატვირთვას SMSBAT-ზე.
sequenceDiagram
participant Client as Client Server
participant Tg as Telegram
participant Proxy as SMSBAT Proxy
participant Chat as Omni Chat
actor Operator
Client->>Tg: Send data to bot
Tg->>Client: Callback from Telegram
Client->>Proxy: Forward Telegram callback to SMSBAT
Proxy->>Chat: Reaction to trigger message
Operator->>Chat: Review and respond
Chat->>Tg: Interaction with Telegram
** მოთხოვნები: **
- დარწმუნდით, რომ კლიენტის სისტემამ შემომავალი გამოხმაურება პირდაპირ chat.smsbat.com ვებ-ჰუკზე.
- მიუთითეთ ღილაკის "Start Chat" ზუსტი ტექსტი/მოქმედება.
- მიუთითეთ ღილაკის "დასრულება ჩატის" ზუსტი ტექსტი/მოქმედება.
ვარიანტი 2.2: პროქსიირებული ლოგიკა დაუბრუნდება კლიენტს
ამ ნაკადში, SMSBAT დაყენებულია, როგორც პირდაპირი webhook Telegram-ში. SMSBAT იღებს მოვლენას და შემდეგ უბრუნებს თქვენს სისტემაში გამოძახებას.
sequenceDiagram
participant Client as Client Server
participant Tg as Telegram
participant Proxy as SMSBAT Proxy
participant Chat as Omni Chat
actor Operator
Client->>Tg: Send data to bot
Tg->>Proxy: Callback on events from Telegram
Proxy->>Client: Forward Telegram callback to Client
Proxy->>Chat: Reaction to trigger message
Operator->>Chat: Review and respond
Chat->>Tg: Operator interaction with Telegram
** მოთხოვნები: **
- მიაწოდეთ გენერირებული გამოძახების URL, რომელიც ჩამოყალიბებულია ბოტის დამატების შემდეგ. URL ასე გამოიყურება:
https://restapi.smsbat.com/api/tg_callback/{ID}
- მიუთითეთ ღილაკის "Start Chat" ზუსტი ტექსტი/მოქმედება.
- მიუთითეთ ღილაკის "დასრულება ჩატის" ზუსტი ტექსტი/მოქმედება.