DingTalk

დაუკავშირეთ PRX DingTalk-ს Stream Mode WebSocket API-ის გამოყენებით რეალურ დროში ბოტის შეტყობინებებისთვის Alibaba-ს სამუშაო პლატფორმაში.

წინაპირობები

• DingTalk ორგანიზაცია (საწარმო ან გუნდი)
• ბოტის აპლიკაცია შექმნილი DingTalk დეველოპერ კონსოლში
• Client ID (AppKey) და Client Secret (AppSecret) დეველოპერ კონსოლიდან

სწრაფი დაყენება

1. DingTalk ბოტის შექმნა

1. გადადით DingTalk Open Platform-ზე და შედით
2. შექმენით ახალი "Enterprise Internal Application" (ან "H5 Micro Application")
3. დაამატეთ "Robot" შესაძლებლობა თქვენს აპლიკაციას
4. "Credentials"-ში დააკოპირეთ Client ID (AppKey) და Client Secret (AppSecret)
5. ჩართეთ "Stream Mode" ბოტის კონფიგურაციაში

2. კონფიგურაცია

[channels_config.dingtalk]
client_id = "dingxxxxxxxxxxxxxxxxxx"
client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
allowed_users = ["manager1234"]

3. შემოწმება

prx channel doctor dingtalk

კონფიგურაციის მითითება

ველი	ტიპი	ნაგულისხმევი	აღწერა
client_id	String	სავალდებულო	Client ID (AppKey) DingTalk დეველოპერ კონსოლიდან
client_secret	String	სავალდებულო	Client Secret (AppSecret) დეველოპერ კონსოლიდან
allowed_users	[String]	[]	ნებადართული DingTalk თანამშრომლის ID-ები. ცარიელი = ყველას უარყოფა. "*" = ყველას დაშვება

ფუნქციები

• Stream Mode WebSocket -- მუდმივი WebSocket კავშირი DingTalk-ის გეითვეისთან რეალურ დროში შეტყობინებების მიტანისთვის
• საჯარო URL არ არის საჭირო -- Stream Mode ამყარებს გამავალ კავშირს, შემავალი webhook-ის გამართვა არ არის საჭირო
• პირადი და ჯგუფური ჩატები -- 1:1 საუბრებისა და ჯგუფური ჩატის შეტყობინებების დამუშავება
• სესიის webhook-ები -- პასუხები DingTalk-ის მიერ მოწოდებული თითო-შეტყობინების სესიის webhook URL-ებით
• გეითვეის ავტომატური რეგისტრაცია -- რეგისტრაცია DingTalk-ის გეითვეისთან WebSocket ენდფოინთისა და ბილეთის მისაღებად
• საუბრის ტიპის გამოვლენა -- განარჩევს პირად ჩატებსა და ჯგუფურ საუბრებს

შეზღუდვები

• Stream Mode საჭიროებს სტაბილურ გამავალ WebSocket კავშირს DingTalk სერვერებთან
• პასუხები თითო-შეტყობინების სესიის webhook-ებს იყენებს, რომლებმაც შეიძლება ვადა გაუვიდეს დროულად გამოუყენებლობისას
• ბოტი ჯგუფურ ჩატში ადმინისტრატორის მიერ უნდა იყოს დამატებული, სანამ ჯგუფის შეტყობინებებს მიიღებს
• DingTalk API-ები ძირითადად ჩინურადაა დოკუმენტირებული; საერთაშორისო მხარდაჭერა შეზღუდულია
• საწარმოს ადმინისტრატორის დამტკიცება შეიძლება საჭირო იყოს შიდა აპლიკაციების განთავსებისთვის

პრობლემების მოგვარება

ბოტი DingTalk-თან არ უკავშირდება

• შეამოწმეთ client_id და client_secret სწორია
• დარწმუნდით, რომ "Stream Mode" ჩართულია DingTalk დეველოპერ კონსოლში ბოტის პარამეტრებში
• შეამოწმეთ, რომ DingTalk სერვერებთან გამავალი კავშირები არ არის დაბლოკილი firewall-ით

შეტყობინებები მიიღება, მაგრამ პასუხები ვერ იგზავნება

• სესიის webhook-ები თითო-შეტყობინებისთვისაა და შეიძლება ვადა გაუვიდეს; დარწმუნდით, რომ პასუხები დროულად იგზავნება
• შეამოწმეთ, რომ ბოტს აქვს საჭირო API ნებართვები დეველოპერ კონსოლში

ჯგუფის შეტყობინებები არ მიიღება

• ბოტი ჯგუფში ადმინისტრატორის მიერ ცალსახად უნდა იყოს დამატებული
• შეამოწმეთ გამგზავნის თანამშრომლის ID allowed_users-შია, ან მიუთითეთ allowed_users = ["*"]