ერთი მოვლენის კონტრაქტი განსაზღვრეთ
- შესვლა: მოვლენის ტიპი, იდენტიფიკატორი, მომხმარებელი, შეთანხმებული მინიმალური ველები და მიღების დრო.
- მოქმედება: უფლებების შემოწმება, დამუშავებული მოვლენის მოძებნა და განაცხადის მდგომარეობის შენახვა.
- შედეგი: განაცხადის ნომერი, გარე გაცვლის სტატუსი და გასაგები პასუხი მომხმარებელს.
- შეცდომა: განმეორებისა და აღდგენის პასუხისმგებელი, დიაგნოსტიკური ჩანაწერის შენახვის ვადა ზედმეტი პირადი მონაცემების გარეშე.
მოვლენების მიღების ერთი გზა აირჩიეთ
getUpdates და webhook განახლებების მიღების ალტერნატიული გზებია. webhook-ზე Telegram HTTPS POST-ს აგზავნის; update_id განმეორებითი მოვლენების გარჩევას ეხმარება. არჩევანი გარემოსა და ექსპლუატაციას მოარგეთ, არა პროგრამირების ენის სახელს.
secret_token-ის გამოყენებისას შესაბამისი შემომავალი სათაური შეამოწმეთ. ბოტის ტოკენი და საიდუმლოებები სერვერზე შეინახეთ, საჯარო გვერდებისა და ჟურნალებისგან ცალკე. განსაზღვრეთ ბოტის, დამმუშავებლის მისამართისა და გარემოს წვდომის მფლობელი.
ოფიციალური წყარო: Telegram Bot API: მოვლენების მიღება
განმეორება და გარე შეფერხება შეამოწმეთ
პირობით სცენარში იგივე იდენტიფიკატორის მოვლენა შენახულ შედეგს უნდა აბრუნებდეს. სხვა მიმართვას საკუთარი ბიზნეს-იდენტიფიკატორი სჭირდება: ერთნაირი ტექსტი ყოველთვის დუბლიკატი არ არის. ასინქრონული დამუშავებისას გარე გაცვლამდე მოვლენა საიმედოდ შეინახეთ.
თუ CRM არ პასუხობს, ნუ დაწერთ „CRM-ში განაცხადი შეიქმნა“. გაურკვეველი სტატუსი შეინახეთ, შედეგი იდენტიფიკატორით შეამოწმეთ და მხოლოდ შემდეგ გადაწყვიტეთ განმეორება. HTTP დადასტურება სრული პროცესის დასრულებას ან ადამიანის მიერ პასუხის მიღებას არ ამტკიცებს.
Mini App-ის ბრაუზერს ნუ ენდობით
სერვერზე გამოყენებამდე initData Telegram-ის ოფიციალური წესით შეამოწმეთ. initDataUnsafe მომხმარებლის დადასტურებულ ვინაობად არ ითვლება. შემოწმების შემდეგ საკუთარი უფლებებიც გამოიყენეთ: მომხმარებლის ვინაობის დადასტურება სხვის განაცხადებზე წვდომას არ იძლევა.
თანხა, შეკვეთის სტატუსი და ჩანაწერის მფლობელი სერვერის მონაცემებით განსაზღვრეთ. მომხმარებლის ველები შეთანხმებული ფორმატით შეზღუდეთ. API პასუხი ან გადახდის ეკრანი ფაქტობრივ გადახდას არ ადასტურებს; დადასტურება შეთანხმებული წყაროდან უნდა მოვიდეს.
ოფიციალური წყარო: Telegram Mini Apps: მონაცემების შემოწმება
გაშვება ხუთ სცენარზე მიიღეთ
- ახალი სწორი მიმართვა: ერთი განაცხადია შენახული, ნომერი და მდგომარეობა შემოწმებადია.
- განმეორებითი მოვლენა: ზედმეტი განაცხადი ან არასასურველი მეორე შეტყობინება არ იქმნება.
- გარე შეფერხება: სტატუსი ჩანს, პასუხისმგებელი დანიშნულია და განმეორების გზა მუშაობს.
- სხვისი ჩანაწერი ან არასწორი ველები: წვდომა აკრძალულია, შეცდომა გასაგებია და საიდუმლო არ გამჟღავნდა.
- დამმუშავებლის გადატვირთვა: შენახული განაცხადი და დამუშავების მდგომარეობა რჩება; გუნდმა აღდგენის წესი იცის.
თქვენი ამოცანა განვიხილოთ
გვითხარით მიზანი, ენები და საჭირო ფუნქციები. სამუშაოების მოცულობასა და შემდეგ ნაბიჯებს შევათანხმებთ.