Nextcloud Talk

დაუკავშირეთ PRX Nextcloud Talk-ს OCS API-ისა და webhook-ზე დაფუძნებული შეტყობინებების მიტანის გამოყენებით თვითჰოსტინგის გუნდური შეტყობინებებისთვის.

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

• Nextcloud ინსტანცია (რეკომენდებულია ვერსია 25 ან უფრო ახალი) Talk აპლიკაციით ჩართული
• ბოტის აპლიკაციის ტოკენი OCS API ავთენტიფიკაციისთვის
• Webhook კონფიგურაცია შემომავალი შეტყობინებების მიტანისთვის

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

1. ბოტის აპლიკაციის ტოკენის შექმნა

Nextcloud-ში შექმენით აპლიკაციის პაროლი:

1. გადადით Settings > Security > Devices & Sessions
2. შექმენით ახალი აპლიკაციის პაროლი აღწერითი სახელით (მაგ., "PRX Bot")
3. დააკოპირეთ შექმნილი ტოკენი

ალტერნატივად, Nextcloud Talk Bot API-სთვის (Nextcloud 27+):

1. გამოიყენეთ occ ბოტის დასარეგისტრირებლად: php occ talk:bot:setup "PRX" <secret> <webhook-url>

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

[channels_config.nextcloud_talk]
base_url = "https://cloud.example.com"
app_token = "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
allowed_users = ["admin", "alice"]

3. Webhook-ების გამართვა

კონფიგურირეთ თქვენი Nextcloud Talk ბოტი webhook მოვლენების PRX გეითვეის ენდფოინთზე გასაგზავნად:

POST https://your-prx-domain.com/nextcloud-talk

4. შემოწმება

prx channel doctor nextcloud_talk

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

ველი	ტიპი	ნაგულისხმევი	აღწერა
base_url	String	სავალდებულო	Nextcloud-ის საბაზო URL (მაგ., "https://cloud.example.com")
app_token	String	სავალდებულო	ბოტის აპლიკაციის ტოკენი OCS API bearer ავთენტიფიკაციისთვის
webhook_secret	String	null	საერთო საიდუმლო HMAC-SHA256 webhook ხელმოწერის ვერიფიკაციისთვის. ასევე შეიძლება ZEROCLAW_NEXTCLOUD_TALK_WEBHOOK_SECRET env ცვლადით
allowed_users	[String]	[]	ნებადართული Nextcloud აქტორის ID-ები. ცარიელი = ყველას უარყოფა. "*" = ყველას დაშვება

ფუნქციები

• Webhook-ზე დაფუძნებული მიტანა -- შეტყობინებების მიღება HTTP webhook push-ით Nextcloud Talk-იდან
• OCS API პასუხები -- პასუხების გაგზავნა Nextcloud Talk OCS REST API-ის მეშვეობით
• HMAC-SHA256 ვერიფიკაცია -- არასავალდებულო webhook ხელმოწერის ვალიდაცია webhook_secret-ით
• მრავალი payload ფორმატი -- მხარს უჭერს ძველ/მორგებულ ფორმატსა და Activity Streams 2.0 ფორმატს (Nextcloud Talk ბოტის webhook-ები)
• თვითჰოსტინგი -- მუშაობს ნებისმიერ Nextcloud ინსტანციასთან, ყველა მონაცემი თქვენს ინფრასტრუქტურაზე რჩება

შეზღუდვები

• საჭიროა საჯაროდ ხელმისაწვდომი HTTPS ენდფოინთი webhook-ების მიტანისთვის (ან რევერს პროქსი)
• Nextcloud Talk ბოტის API ხელმისაწვდომია Nextcloud 27+-იდან; ძველი ვერსიები მორგებულ webhook გამართვას მოითხოვს
• ბოტი Talk ოთახში უნდა იყოს რეგისტრირებული შეტყობინებების მისაღებად
• ფაილებისა და მედია დანართების დამუშავება ამჟამად მხარდაჭერილი არ არის
• მილიწამიანი დროის ბეჭდის მქონე webhook payload-ები ავტომატურად ნორმალიზდება წამებად

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

Webhook მოვლენები არ მიიღება

• შეამოწმეთ webhook URL საჯაროდ ხელმისაწვდომია და https://your-domain/nextcloud-talk-ზე მიუთითებს
• დარწმუნდით, რომ ბოტი Talk ოთახში რეგისტრირებულია
• შეამოწმეთ Nextcloud სერვერის ლოგები webhook მიტანის შეცდომებისთვის

ხელმოწერის ვერიფიკაცია ვერ ხერხდება

• დარწმუნდით, რომ webhook_secret ემთხვევა ბოტის რეგისტრაციისას გამოყენებულ საიდუმლოს
• საიდუმლო შეიძლება კონფიგურაციით ან ZEROCLAW_NEXTCLOUD_TALK_WEBHOOK_SECRET გარემოს ცვლადით მითითდეს

პასუხები არ იგზავნება

• შეამოწმეთ base_url სწორია და ხელმისაწვდომია PRX სერვერიდან
• შეამოწმეთ app_token-ს აქვს ოთახში შეტყობინებების გაგზავნის ნებართვა
• გადახედეთ OCS API-ის პასუხს ავთენტიფიკაციის ან ნებართვის შეცდომებისთვის