Κανάλια & ενσωματώσεις

Κανάλι API

Συνδέστε το Entagl με τη δική σας app ή με το Make: στείλτε μηνύματα, λάβετε απαντήσεις και διαχειριστείτε το workspace σας.

Επισκόπηση

Το κανάλι API σας επιτρέπει να τρέχετε τον ίδιο AI agent που τροφοδοτεί τα DMs σας από το δικό σας website chat, mobile app ή backend. Στέλνετε ένα μήνυμα, ο agent επεξεργάζεται (με το ίδιο buffering και τις ανθρώπινες, multi-message απαντήσεις όπως σε ένα πραγματικό DM), και η απάντηση φτάνει λίγο αργότερα, μέσω webhook callback ή με polling. Ρυθμίστε το από Κανάλια → API: δημιουργήστε ένα API key, ενεργοποιήστε το κανάλι και μετά επιλέξτε callback ή polling. Το ίδιο API επιτρέπει επίσης στον developer σας, ή στο Make, να δουλεύει με contacts, conversations, bookings, orders και πολλά άλλα. Δείτε την καρτέλα Workspace API.

Για developers: αναφορά API

Κάθε endpoint, πεδίο και webhook event, με δείγματα κώδικα.

Tabs σε αυτήν τη σελίδα

Το API δεν είναι μόνο για chat. Ο developer σας, ή ένα εργαλείο όπως το Make, μπορεί να το χρησιμοποιήσει για να διαβάζει και να ενημερώνει το μεγαλύτερο μέρος του workspace σας.

Τι μπορείτε να κάνετε με αυτό

Εκτός από την αποστολή μηνυμάτων, το API καλύπτει:

Contacts: δημιουργία, ενημέρωση, αναζήτηση, συγχώνευση, προσθήκη σημειώσεων, σήμανση ως do-not-contact
Tags και lifecycle stages: προσθήκη ή αφαίρεση tags, μετακίνηση contact σε άλλο stage
Conversations: ανάθεση σε teammate, κλείσιμο με closing note, παύση ή επανεκκίνηση του AI, προσθήκη team comments, αποστολή μηνύματος ως η επιχείρησή σας
Bookings και reminders: έλεγχος διαθέσιμων ωρών, κράτηση, επαναπρογραμματισμός, ακύρωση, δημιουργία και κλείσιμο reminders
Orders και products: δημιουργία και ενημέρωση orders και των items τους, διαχείριση του καταλόγου σας
Calls: έναρξη AI τηλεφωνικής κλήσης ή προσθήκη σε ουρά, ανάγνωση του αποτελέσματος
Campaigns: προβολή των campaigns σας και αποστολή ενός

Όταν κάτι αλλάζει, το Entagl μπορεί να ενημερώνει αμέσως τα εργαλεία σας μέσω webhooks.

Δύο τρόποι σύνδεσης

Make. Όταν συνδέετε το Make, συνδέεστε με τον δικό σας Entagl λογαριασμό. Στη συνέχεια το Make ενεργεί ως εσείς, με ακριβώς τα δικαιώματά σας: ένας owner ή admin μπορεί να κάνει τα πάντα, ενώ ένα team member μόνο ό,τι επιτρέπουν τα δικαιώματά του. Αν το login σας έχει περισσότερα από ένα workspace, επιλέγετε ποιο θα χρησιμοποιήσετε.

API key. Για τον δικό σας server, δημιουργήστε ένα key στο Κανάλια → API ή στο Ρυθμίσεις → API keys και στείλτε το ως Authorization: Bearer <your key>. Ένα key ανήκει σε ένα workspace και έχει πλήρη πρόσβαση owner σε αυτό, οπότε αντιμετωπίστε το σαν κωδικό πρόσβασης.

Ασφαλές για retry: το header Idempotency-Key

Μερικές φορές ένα request περνάει, αλλά η απάντηση χάνεται στην επιστροφή. Αν το σύστημά σας δεν είναι σίγουρο ότι ένα request πέτυχε, μπορεί να το στείλει ξανά με το ίδιο Idempotency-Key header. Μέσα σε 24 ώρες το Entagl αναγνωρίζει το key, παραλείπει τη δουλειά και επιστρέφει την πρώτη απάντηση, ώστε να μη βρεθείτε με δύο orders ή δύο contacts. Η χρήση του ίδιου key για διαφορετικό request απορρίπτεται με error.

Πόσα requests μπορείτε να στείλετε

Έως 120 requests ανά λεπτό για κάθε workspace. Αν το ξεπεράσετε, το Entagl απαντά με error 429 (rate_limited). Περιμένετε λίγο και δοκιμάστε ξανά. Οι περισσότερες αυτοματοποιήσεις δεν πλησιάζουν καν αυτό το όριο.

Η πλήρης API reference

Κάθε endpoint, field και error code βρίσκεται στην Entagl API reference. Αν ο developer σας δεν την έχει ακόμη, στείλτε email στο support@entagl.com και ζητήστε την API reference.

Ένα API key δίνει πλήρη πρόσβαση owner στο workspace του. Κρατήστε το στον server σας, ποτέ μέσα σε website ή app που μπορούν να ανοίξουν οι πελάτες σας, και ανακαλέστε το αμέσως αν υποψιάζεστε ότι διέρρευσε.

Οι αλλαγές που γίνονται μέσω του API επισημαίνονται στα webhook events σας ως προερχόμενες από το API, ώστε ένα Make scenario να μπορεί να αγνοεί τις δικές του αλλαγές αντί να δημιουργεί βρόχο.

Δυνατότητες

Ρύθμιση και έλεγχος ταυτότητας

Δημιουργήστε ένα κλειδί API από το Channels → API, ενεργοποιήστε τον διακόπτη του καναλιού και μετά καλέστε το API στο https://api.entagl.com με την κεφαλίδα Authorization: Bearer <το κλειδί σας>. Τα κλειδιά περιορίζονται στον χώρο εργασίας.

Αποστολή μηνύματος

Κάντε POST /api/v1/messages με { message, externalUserId }. Παίρνετε αμέσως ένα 202 και ένα conversationId. Χρησιμοποιήστε ξανά αυτό το conversationId για να συνεχίσετε τη συζήτηση. Η απάντηση του agent έρχεται αργότερα, όχι σε αυτό το response.

Webhook (callback) (συνιστάται)

Προσθέστε μια δημόσια διεύθυνση callback HTTPS και η Entagl θα στέλνει κάθε απάντηση του πράκτορα εκεί μέσω POST, υπογεγραμμένη με την κεφαλίδα X-Entagl-Signature (HMAC-SHA256). Επαληθεύστε την υπογραφή και απαντήστε 2xx μέσα σε ~5 δευτερόλεπτα. Δεν υπάρχει αυτόματη επανάληψη.

Polling

Αν δεν μπορείτε να φιλοξενήσετε διεύθυνση callback, καλέστε GET /api/v1/conversations/:id/messages?since=<cursor> για να λάβετε τις νέες απαντήσεις. Περάστε το cursor από κάθε απόκριση ως ?since= ώστε να λαμβάνετε μόνο νέα μηνύματα.

Ασφάλεια και απομόνωση

Τα API keys αποθηκεύονται hashed και το signing secret κρυπτογραφείται (και τα δύο εμφανίζονται μόνο μία φορά). Κάθε αναζήτηση περιορίζεται στο workspace: ένα conversation ID από άλλο workspace επιστρέφει 404 και δεν μπορείτε να περάσετε user ID (προκύπτει από το key σας).

Συχνές εργασίες

Ρύθμιση του καναλιού API

Περίπου 3 λεπτά

Μεταβείτε στο Channels → API και κάντε κλικ στο Generate API Key. Αντιγράψτε το τώρα, γιατί εμφανίζεται μόνο μία φορά.
Ενεργοποιήστε τον διακόπτη του καναλιού στην κεφαλίδα της κάρτας API.
Συνιστάται: αναπτύξτε την κάρτα, επικολλήστε μια δημόσια διεύθυνση callback HTTPS, αποθηκεύστε και αντιγράψτε το μυστικό υπογραφής.
Από την εφαρμογή σας, στείλτε μηνύματα μέσω POST στο https://api.entagl.com/api/v1/messages και λάβετε τις απαντήσεις μέσω callback ή polling.

Συμβουλές

Οι απαντήσεις είναι ασύγχρονες. Το POST επιστρέφει 202 και η απάντηση του agent φτάνει μέσω του callback ή του polling σας, όχι στο response.

Ένα μήνυμα μπορεί να παράγει πολλές απαντήσεις μετά από μια σύντομη καθυστέρηση buffering (περίπου 8 δευτερόλεπτα, ρυθμιζόμενη έως ~5 λεπτά). Εμφανίστε τις όλες, με τη σειρά.

Το 202 δεν εγγυάται απάντηση. Ο agent μπορεί να μην απαντήσει αν η αυτοματοποίηση είναι σε παύση, αν ένα guardrail μπλοκάρει το μήνυμα ή αν το workspace έχει εξαντλήσει τα credits του.

Τα callbacks δεν έχουν αυτόματη επανάληψη. Κρατήστε το polling ως εφεδρεία και επαληθεύετε πάντα την κεφαλίδα X-Entagl-Signature πριν εμπιστευτείτε μια παράδοση.

Επαναχρησιμοποιήστε το conversationId για να συνεχίσετε μια συνομιλία· το externalUserId είναι απλώς η δική σας ετικέτα για τον τελικό χρήστη.

Προς το παρόν μόνο κείμενο. Κρατήστε ασφαλή το API key και το signing secret σας: και τα δύο εμφανίζονται μόνο μία φορά.

Συχνές ερωτήσεις

Ήταν χρήσιμη αυτή η σελίδα;