Αν διαχειρίζεστε υπηρεσίες στον δικό σας server — είτε πρόκειται για Nextcloud, Audiobookshelf, Plex, Proxmox ή οτιδήποτε άλλο — γνωρίζετε πόσο σημαντικό είναι να μαθαίνετε αμέσως όταν κάτι πάει στραβά. Η αναμονή να ανακαλύψετε τυχαία ότι μια υπηρεσία «έπεσε» δεν είναι διαχείριση — είναι τύχη.

Σε αυτό το άρθρο θα δούμε πώς να συνδέσουμε το Uptime Kuma v2 με το Nextcloud Talk, ώστε κάθε φορά που μια υπηρεσία αποτυγχάνει ή ανακάμπτει, να λαμβάνετε αυτόματη ειδοποίηση απευθείας σε μια συνομιλία του Talk. Όλα αυτά χωρίς εξωτερικές υπηρεσίες, χωρίς συνδρομές, 100% open source.

Πώς λειτουργεί η ενσωμάτωση

Η επικοινωνία μεταξύ Uptime Kuma και Nextcloud Talk γίνεται μέσω ενός Talk Bot: το Uptime Kuma στέλνει HTTP αιτήματα υπογεγραμμένα με ένα shared secret απευθείας στο Talk API, και το bot δημοσιεύει το μήνυμα στην επιλεγμένη συνομιλία. Δεν απαιτείται κανένας ενδιάμεσος server ή webhook service.

Τα μηνύματα που λαμβάνετε έχουν αυτή τη μορφή:

Προαπαιτούμενα

Πριν ξεκινήσουμε, βεβαιωθείτε ότι έχετε:

• Nextcloud 32.x εγκατεστημένο μέσω Nextcloud AIO (All-in-One Docker)
• Την εφαρμογή Nextcloud Talk εγκατεστημένη και ενεργοποιημένη
• Uptime Kuma v2 σε λειτουργία (π.χ. μέσω Docker)
• Διαχειριστική πρόσβαση στο Nextcloud (admin account)
• Πρόσβαση σε τερματικό SSH στον server σας

1 Δημιουργία συνομιλίας στο Nextcloud Talk

Το πρώτο βήμα είναι να δημιουργήσουμε μια αποκλειστική συνομιλία (conversation / room) στο Talk, μέσα στην οποία θα αποστέλλονται οι ειδοποιήσεις monitoring. Συνιστούμε να μην χρησιμοποιείτε υπάρχουσα ομαδική συνομιλία, για να κρατάτε τις ειδοποιήσεις οργανωμένες.

1. Συνδεθείτε στη διεπαφή web του Nextcloud.
2. Ανοίξτε την εφαρμογή Talk.
3. Κάντε κλικ στο «Νέα συνομιλία» (New conversation).
4. Δώστε ένα περιγραφικό όνομα, π.χ. infra-alerts ή monitoring.
5. Δημιουργήστε τη συνομιλία.

2 Εύρεση του Conversation Token

Κάθε συνομιλία στο Talk ταυτοποιείται με ένα μοναδικό token που εμφανίζεται στη διεύθυνση URL της συνομιλίας. Αυτό το token θα το χρειαστούμε αργότερα για να «πούμε» στο Uptime Kuma πού να στέλνει τις ειδοποιήσεις.

Αφού ανοίξετε τη νέα συνομιλία, κοιτάξτε τη διεύθυνση URL στον browser σας. Θα μοιάζει κάπως έτσι:

Το τμήμα μετά το /call/ είναι το Conversation Token — στο παράδειγμά μας το abcd1234. Αντιγράψτε το και κρατήστε το.

3 Δημιουργία του Talk Bot

Τώρα πρέπει να δημιουργήσουμε το bot που θα στέλνει μηνύματα στη συνομιλία. Αυτό γίνεται αποκλειστικά μέσω γραμμής εντολών, μέσα στο Docker container του Nextcloud AIO.

Το Nextcloud Talk προσφέρει δύο εντολές για τη δημιουργία bot:

• talk:bot:create — δημιουργεί bot με αυτόματα παραγόμενο secret, με τη δυνατότητα response μόνο (το bot μπορεί να στέλνει μηνύματα στο chat).
• talk:bot:install — πιο προχωρημένη εντολή που απαιτεί και webhook URL, για bots που θέλουν επίσης να λαμβάνουν μηνύματα.

Για το Uptime Kuma, αρκεί η talk:bot:create, γιατί το bot μόνο αποστέλλει ειδοποιήσεις — δεν χρειάζεται να λαμβάνει ή να απαντά σε μηνύματα. Εκτελέστε την παρακάτω εντολή:

Μπορείτε επίσης να ορίσετε εσείς το secret (πρέπει να είναι μεταξύ 40 και 128 χαρακτήρων) χρησιμοποιώντας την παράμετρο --secret:

Αν δεν ορίσετε secret, το Nextcloud θα δημιουργήσει αυτόματα ένα τυχαίο string 64 χαρακτήρων. Το αποτέλεσμα θα μοιάζει κάπως έτσι:

4 Προσθήκη του Bot στη συνομιλία

Το bot δημιουργήθηκε στο σύστημα, αλλά δεν έχει ακόμα πρόσβαση σε καμία συνομιλία. Πρέπει να το «συνδέσουμε» με τη συνομιλία που δημιουργήσαμε. Αυτό γίνεται με την εντολή talk:bot:setup, η οποία δέχεται το Bot ID και το Conversation Token:

Αντικαταστήστε 16 με το πραγματικό Bot ID σας και abcd1234 με το Conversation Token της συνομιλίας σας. Αν η εντολή εκτελεστεί σωστά, θα δείτε:

Το bot είναι τώρα μέλος της συνομιλίας και έχει δικαίωμα αποστολής μηνυμάτων.

5 Επαλήθευση της ρύθμισης του Bot

Για να επιβεβαιώσουμε ότι το bot εγκαταστάθηκε σωστά, μπορούμε να εκτελέσουμε την εντολή talk:bot:list που εμφανίζει όλα τα bots του συστήματος:

Παράδειγμα εξόδου:

Η στήλη features δείχνει response, που σημαίνει ότι το bot μπορεί να δημοσιεύει μηνύματα στις συνομιλίες — ακριβώς αυτό που χρειαζόμαστε για το Uptime Kuma.

Μπορείτε επίσης να φιλτράρετε τη λίστα για μια συγκεκριμένη συνομιλία περνώντας το token ως παράμετρο: php occ talk:bot:list abcd1234. Αυτό είναι χρήσιμο αν έχετε πολλά bots και θέλετε να δείτε ποια είναι ενεργά σε συγκεκριμένη συνομιλία.

6 Ρύθμιση notification στο Uptime Kuma

Ανοίξτε τη web διεπαφή του Uptime Kuma και μεταβείτε στις ρυθμίσεις ειδοποιήσεων:

Στη λίστα τύπων notification, επιλέξτε «Nextcloud Talk». Θα εμφανιστεί φόρμα με τα εξής πεδία:

Αποθηκεύστε τη ρύθμιση κάνοντας κλικ στο «Save».

7 Δοκιμή της ειδοποίησης

Κάντε κλικ στο κουμπί «Test» δίπλα στη νέα ειδοποίηση. Αν όλα έχουν ρυθμιστεί σωστά, σε λίγα δευτερόλεπτα θα εμφανιστεί ένα δοκιμαστικό μήνυμα στη συνομιλία του Talk:

Αν δεν εμφανιστεί μήνυμα, ελέγξτε:

• Ότι το Bot Secret που πληκτρολογήσατε είναι ακριβώς το ίδιο με αυτό που παράχθηκε (χωρίς κενά).
• Ότι το Conversation Token αντιστοιχεί στη σωστή συνομιλία.
• Ότι η διεύθυνση Nextcloud Host είναι προσβάσιμη από τον server του Uptime Kuma (DNS, firewall, κ.λπ.).
• Ότι εκτελέσατε το talk:bot:setup με το σωστό token.

8 Ανάθεση της ειδοποίησης σε monitors

Η ειδοποίηση δεν ενεργοποιείται αυτόματα για όλα τα monitors. Πρέπει να την αναθέσετε ξεχωριστά σε κάθε monitor που θέλετε να παρακολουθείτε:

1. Ανοίξτε ένα monitor στο Uptime Kuma.
2. Κάντε κλικ στο «Edit».
3. Κυλήστε κάτω στην ενότητα «Notifications».
4. Επιλέξτε «Nextcloud Talk Alerts» (ή το όνομα που δώσατε).
5. Αποθηκεύστε τις αλλαγές.

Από εδώ και πέρα, κάθε φορά που η κατάσταση αυτού του monitor αλλάζει (Down ↔ Up), το Uptime Kuma θα στέλνει αυτόματα ειδοποίηση στο Talk.

💡 Συμβουλές για καλύτερες ειδοποιήσεις

Η ποιότητα μιας ειδοποίησης εξαρτάται σε μεγάλο βαθμό από το όνομα που δίνετε στο monitor. Αντί για γενικά ονόματα όπως «Server 1» ή «HTTP Check», χρησιμοποιήστε περιγραφικά ονόματα που σας λένε αμέσως ποια υπηρεσία επηρεάζεται. Χρήση emoji βοηθά στην οπτική γρήγορη αναγνώριση:

Με αυτά τα ονόματα, οι ειδοποιήσεις στο Talk θα εμφανίζονται έτσι:

Είναι αμέσως κατανοητό ποια υπηρεσία έχει πρόβλημα, χωρίς να χρειαστεί να ανοίξετε το dashboard του Uptime Kuma.

🔧 Χρήσιμες εντολές διαχείρισης

Αν χρειαστεί να διαχειριστείτε τα bots σας στο μέλλον, οι παρακάτω εντολές θα σας φανούν χρήσιμες:

Θυμηθείτε να προσθέτετε πάντα το prefix sudo docker exec -it nextcloud-aio-nextcloud πριν από κάθε php occ ... εντολή όταν χρησιμοποιείτε Nextcloud AIO.