Αρχική›API, webhooks και MCP
Τα δεδομένα σας στο Helios, στην υπόλοιπη επιχείρησή σας.
Το Installer Pro περιλαμβάνει τεκμηριωμένο REST API και webhooks. Τα δικά σας συστήματα μπορούν να δημιουργούν και να ενημερώνουν leads, πελάτες, εταιρείες και εργασίες, να διαβάζουν προτάσεις, τιμολόγια, συστήματα και την ημερήσια ενέργειά τους, και να μαθαίνουν τι συμβαίνει — ένα lead που γίνεται πελάτης, ένα τιμολόγιο που εξοφλείται, ένα σύστημα που χάνει τη σύνδεσή του — τη στιγμή που συμβαίνει. Και κάθε μέλος της ομάδας σας μπορεί να συνδέσει το Claude, το ChatGPT ή το Copilot με το Helios μέσω του MCP server του. Αυτή η σελίδα εξηγεί σε τι έχει πρόσβαση το καθένα και πώς προστατεύεται· η τεκμηρίωση αναφοράς περιέχει κάθε endpoint.
Συνδέστε το Claude, το ChatGPT ή το Copilot: ο MCP server του Helios
Το Helios διαθέτει δικό του MCP server. Προσθέστε τον στο Claude, στο ChatGPT, στο Copilot ή σε όποια εφαρμογή ΤΝ δέχεται προσαρμοσμένους connectors, και ρωτήστε σε απλή γλώσσα για τον στόλο, τους πελάτες, τα leads, τις προτάσεις και τα τιμολόγιά σας — με απαντήσεις από τις εγγραφές σας στο Helios, δίπλα στο email και τα έγγραφά σας.
Σύνδεση σε τρία βήματα
- Ένας διαχειριστής του λογαριασμού ενεργοποιεί το πρόσθετο Σύνδεση των εφαρμογών AI σας από τις Ρυθμίσεις. Δεν έχει δική του χρέωση.
- Στην εφαρμογή ΤΝ σας, προσθέστε έναν προσαρμοσμένο connector (MCP server) με τη διεύθυνση που εμφανίζεται στις Ρυθμίσεις › Συνδεδεμένες εφαρμογές AI.
- Η εφαρμογή ανοίγει μια σελίδα του Helios: συνδεθείτε και επιλέξτε Να επιτραπεί.
Τι μπορεί και τι δεν μπορεί να κάνει
- Μόνο ανάγνωση. Η εφαρμογή μπορεί να αναζητά εγγραφές και να εκτελεί ερωτήματα· δεν μπορεί να δημιουργήσει, να αλλάξει ή να διαγράψει τίποτα.
- Ως εσείς. Κάθε άτομο συνδέει τη δική του εφαρμογή, και αυτή βλέπει ακριβώς ό,τι του επιτρέπει ο ρόλος του.
- Πέντε εργαλεία. Λίστα με ό,τι μπορεί να αναζητηθεί, περιγραφή ενός τύπου εγγραφής, εκτέλεση ερωτήματος, βαθμολογίες υγείας πελατών, και οδηγίες για το πώς γίνεται κάτι στο Helios.
- Τυπική σύνδεση, χωρίς κλειδί για επικόλληση. OAuth με PKCE και δυναμική εγγραφή πελάτη. Τα access tokens ισχύουν μία ώρα· τα refresh tokens ανανεώνονται σε κάθε χρήση, και μια εφαρμογή που μένει αχρησιμοποίητη 30 ημέρες πρέπει να εγκριθεί ξανά. Κάθε κλήση ελέγχει εκ νέου το άτομο, τον οργανισμό, το πρόσθετο και τον διακόπτη του διαχειριστή.
- Τα δεδομένα email και ημερολογίου μένουν στο Helios. Τα email που αρχειοθετούνται από συνδεδεμένο γραμματοκιβώτιο, τα γεγονότα ημερολογίου και οι άδειες δεν δίνονται ποτέ σε εφαρμογή ΤΝ.
- Το απενεργοποιείτε όποτε θέλετε. Ο καθένας μπορεί να αποσυνδέσει την εφαρμογή του από τις Ρυθμίσεις › Συνδεδεμένες εφαρμογές AI. Ένας διαχειριστής βλέπει κάθε συνδεδεμένη εφαρμογή του οργανισμού και μπορεί να απενεργοποιήσει τις συνδέσεις για όλους μαζί.
- Εσείς επιλέγετε ποιος μπορεί να συνδεθεί. Από προεπιλογή οι ρόλοι Owner, Admin, Manager και Staff· ποτέ οι Read-only ή Accountant. Οι προσαρμοσμένοι ρόλοι ξεκινούν χωρίς αυτό.
- Καταγράφεται. Κάθε κλήση μιας εφαρμογής ΤΝ εμφανίζεται στο αρχείο ελέγχου.
- Η εφαρμογή σας, η συνδρομή ΤΝ σας. Οι απαντήσεις πηγαίνουν στην εφαρμογή που συνδέσατε, όχι στον δικό μας πάροχο ΤΝ, και δεν χρησιμοποιούν το όριο ΤΝ του Helios. Τι κάνει η εφαρμογή με αυτές ορίζεται από τους δικούς της όρους.
Σε τι έχει πρόσβαση το API
JSON μέσω HTTPS στο api.helios-energy.app, με τις ίδιες εγγραφές που χρησιμοποιεί η ομάδα σας μέσα στο Helios.
| Εγγραφές | Τι μπορεί να κάνει ένα κλειδί |
|---|---|
| Leads | Λίστα, ανάγνωση, δημιουργία, ενημέρωση |
| Πελάτες | Λίστα, ανάγνωση, δημιουργία, ενημέρωση |
| Εταιρείες | Λίστα, ανάγνωση, δημιουργία, ενημέρωση |
| Εργασίες | Λίστα, ανάγνωση, δημιουργία |
| Προτάσεις | Λίστα, ανάγνωση |
| Τιμολόγια | Λίστα, ανάγνωση |
| Στάδια pipeline | Λίστα |
| Συστήματα | Λίστα, ανάγνωση, και η ημερήσια ενέργεια κάθε συστήματος |
| Συνδρομές webhook | Λίστα, δημιουργία, διαγραφή — και τα γεγονότα που μπορεί να λάβει το κλειδί |
Ένα endpoint me λέει σε μια ενσωμάτωση ως ποιος ενεργεί και σε ποιες εγγραφές έχει πρόσβαση, ώστε να μη χρειάζεται ποτέ να μαντεύει.
Webhooks: 20 γεγονότα
Επιλέγετε τα γεγονότα που λαμβάνει κάθε webhook. Κάθε αποστολή λέει τι συνέβη και σε ποια εγγραφή.
| Εγγραφή | Γεγονότα |
|---|---|
| Lead | δημιουργία, ενημέρωση, αλλαγή σταδίου, μετατροπή σε πελάτη |
| Πελάτης | δημιουργία, ενημέρωση, αλλαγή σταδίου |
| Εταιρεία | δημιουργία, ενημέρωση |
| Εργασία | δημιουργία, αλλαγή κατάστασης |
| Πρόταση | δημιουργία, αλλαγή κατάστασης, αποδοχή |
| Τιμολόγιο | δημιουργία, αλλαγή κατάστασης, εξόφληση, καθυστέρηση πληρωμής |
| Σύστημα | απώλεια σύνδεσης, επανασύνδεση |
Από προεπιλογή μια αποστολή περιέχει τον κωδικό της εγγραφής και το πού θα τη βρείτε, ώστε η ίδια η εγγραφή να ταξιδεύει μόνο μέσα από αυθεντικοποιημένη κλήση του API. Αν προτιμάτε να λαμβάνετε την εγγραφή μέσα στο webhook, επιλέξτε πλήρες περιεχόμενο. Ένα webhook που δημιουργήθηκε με κλειδί λαμβάνει γεγονότα μόνο για εγγραφές που επιτρέπεται να βλέπει ο ρόλος του κλειδιού.
Αποστολές στις οποίες μπορείτε να βασιστείτε
- Υπογεγραμμένες. Κάθε αποστολή φέρει την κεφαλίδα
X-Webhook-Signature: ένα HMAC-SHA256 μιας χρονοσφραγίδας και του ακατέργαστου σώματος, με το μυστικό του webhook σας, ώστε το endpoint σας να ελέγχει ότι προέρχεται από το Helios και ότι είναι πρόσφατη. Μπορείτε να προσθέσετε και δική σας κεφαλίδα εξουσιοδότησης. Όταν αλλάζετε το μυστικό, το παλιό συνεχίζει να υπογράφει μαζί με το νέο για 24 ώρες, ώστε να κάνετε την αλλαγή χωρίς να χάσετε τίποτα. - Μόνο σε endpoints που είναι δικά σας. Τίποτα δεν αποστέλλεται πριν το endpoint σας απαντήσει σε μια πρόκληση επαλήθευσης, που επαναλαμβάνεται κάθε 30 ημέρες. Ο οργανισμός σας μπορεί να περιορίσει τα webhooks σε domains που ορίζει, και οι γνωστές υπηρεσίες επιθεώρησης αιτημάτων απορρίπτονται.
- Επαναλαμβάνονται και δεν χάνονται. Μια αποτυχημένη αποστολή επαναλαμβάνεται μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά και στη συνέχεια 2, 6, 12 και 24 ώρες — οκτώ προσπάθειες σε περίπου 45 ώρες. Το αρχείο αποστολών δείχνει κάθε προσπάθεια· ξαναστείλτε μία ή όλες τις αποτυχημένες μαζί.
- Απενεργοποιούνται μόνο σε πραγματική διακοπή. Ένα webhook απενεργοποιείται μόνο μετά από 20 συνεχόμενες αποτυχίες και 24 ώρες χωρίς καμία επιτυχημένη αποστολή. Όσο είναι απενεργοποιημένο, οι αποστολές περιμένουν αντί να αποτυγχάνουν, και φεύγουν μόλις το ενεργοποιήσετε ξανά· ένα webhook που απενεργοποιήθηκε αυτόματα συνεχίζει να συγκεντρώνει γεγονότα για επτά ημέρες.
- Οι αλλαγές θέλουν δεύτερο παράγοντα. Η δημιουργία webhook, η αλλαγή της διεύθυνσής του ή της λίστας domains, ή το αίτημα για πλήρες περιεχόμενο ζητούν τον κωδικό δύο βημάτων σας (ή τον κωδικό πρόσβασής σας), και κάθε κάτοχος του λογαριασμού ενημερώνεται με email.
Κλειδιά και tokens
- Με όριο ρόλου. Ένας διαχειριστής του λογαριασμού δημιουργεί κλειδιά από τις Ρυθμίσεις › API και webhooks. Κάθε κλειδί έχει ρόλο και δεν μπορεί ποτέ να κάνει περισσότερα από αυτόν τον ρόλο ή από το πρόσωπο που το δημιούργησε — και ως προς το ποιες εγγραφές καλύπτει. Το κλειδί εμφανίζεται μία φορά.
- Προσωπικά δεδομένα μόνο αν το επιτρέψετε. Ένα νέο κλειδί δεν βλέπει προσωπικά δεδομένα — ονόματα, διευθύνσεις email, τηλέφωνα, διευθύνσεις και ελεύθερες σημειώσεις επιστρέφουν κενά — εκτός αν δηλώσετε ότι επιτρέπεται.
- Περιορισμένα στα δίκτυά σας. Περιορίστε ένα κλειδί στις διευθύνσεις ή στα εύρη IP από τα οποία καλεί η ενσωμάτωσή σας.
- Πάντα με λήξη. Τα νέα κλειδιά λήγουν από προεπιλογή σε 90 ημέρες και μπορούν να διαρκέσουν έως έναν χρόνο. Όποιος δημιούργησε το κλειδί και οι κάτοχοι του λογαριασμού λαμβάνουν υπενθύμιση 14 και 3 ημέρες πριν τη λήξη.
- Υπό παρακολούθηση. Η δημιουργία ή η ανανέωση κλειδιού ζητά τον κωδικό δύο βημάτων σας (ή τον κωδικό πρόσβασης), και οι κάτοχοι ενημερώνονται με email. Ενημερώνονται ξανά όταν ένα κλειδί χρησιμοποιείται ασυνήθιστα — από νέο δίκτυο ή χώρα, με απότομη αύξηση ή με επαναλαμβανόμενες απορρίψεις — και ένα κλειδί μπορεί να ρυθμιστεί να αναστέλλεται μόνο του σε τέτοια περίπτωση.
- Tokens σύντομης διάρκειας, αν τα προτιμάτε. Μια ενσωμάτωση μπορεί να ανταλλάξει το κλειδί της με access token μίας ώρας (OAuth 2.0 client credentials), με το ίδιο το κλειδί ή με assertion υπογεγραμμένο από ιδιωτικό κλειδί που καταχωρείτε (
private_key_jwt). - Δίκαιη χρήση. Έως δέκα κλειδιά μπορούν να είναι ενεργά, και όλα μαζί μοιράζονται το όριο του πλάνου σας, 120 αιτήματα το λεπτό· ένα μεμονωμένο κλειδί μπορεί να περιοριστεί σε λιγότερα.
Τι χρειάζεται
Το API και τα webhooks είναι μέρος του Installer Pro. Τα Xero, QuickBooks και 3CX συνδέονται από τις Ρυθμίσεις στο ίδιο πλάνο, χωρίς καμία δουλειά με το API. Η σύνδεση MCP είναι πρόσθετο χωρίς δική του χρέωση. Για οτιδήποτε άλλο, κάθε εργαλείο ή υπηρεσία που μπορεί να κάνει ένα αίτημα HTTPS μπορεί να χρησιμοποιήσει το API, και κάθε endpoint που μπορεί να απαντήσει στην πρόκληση επαλήθευσης μπορεί να λαμβάνει webhooks.
Η τεκμηρίωση αναφοράς
Κάθε endpoint και το περιεχόμενο κάθε γεγονότος είναι τεκμηριωμένα, με αναζήτηση και σελίδα για κάθε endpoint: το API στο api.helios-energy.app/api/public/v1/docs και τα webhooks στο api.helios-energy.app/api/public/v1/docs/webhooks. Η τεκμηρίωση είναι στα αγγλικά.
Διαβάστε στη συνέχεια
Η σελίδα της Πλατφόρμας Helios περιγράφει τις εγγραφές που εκθέτει το API. Η τιμολόγηση έχει τα πλάνα. Στις συχνές ερωτήσεις απαντώνται τα υπόλοιπα.
Σχεδιάζετε μια ενσωμάτωση;
Πείτε μας τι θέλετε να συνδέσετε και θα το δούμε μαζί σε ένα demo.