ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Αρχιτεκτονική AI agent SaaS: φτάστε τους πελάτες των πελατών σας στο WhatsApp, Instagram και TikTok

Ένα AI agent SaaS που φτάνει στους πελάτες των πελατών σας λειτουργεί σε πέντε επίπεδα: συνδέσεις, όπου κάθε πελάτης συνδέει το WhatsApp, το Instagram, το TikTok και άλλα κανάλια μέσω του Partner API της easyCoexistence· λήψη, που επαληθεύει και βάζει στην ουρά τα webhooks· μια αποθήκη συνομιλιών που σας ανήκει· ένας worker του agent που τρέχει το δικό σας μοντέλο· και εξερχόμενα, που στέλνουν απαντήσεις, δημοσιεύουν και παρακολουθούν τα γεγονότα κατάστασης μέσω του επίσημου API κάθε δικτύου.

smb_message_echoes

Το webhook που περιγράφει μήνυμα που έστειλε η επιχείρηση από την εφαρμογή WhatsApp Business σε αριθμό Coexistence.

7 days

Για πόσο χρόνο ο Meta επαναλαμβάνει ένα webhook του WhatsApp που το endpoint σας δεν δέχτηκε, κάτι που μπορεί να παραδώσει το ίδιο μήνυμα δύο φορές.

1 attempt

Παραδόσεις κάθε προωθημένου γεγονότος Instagram, Facebook ή TikTok, χωρίς επανάληψη και χωρίς αντίγραφο που να διατηρείται.

24 hours

Το παράθυρο εξυπηρέτησης πελατών του WhatsApp μετά από μήνυμα ενός ατόμου· εκτός αυτού, η επιχείρηση στέλνει μόνο εγκεκριμένα πρότυπα μηνυμάτων.

20 mps

Σταθερός ρυθμός μετάδοσης ενός αριθμού που χρησιμοποιείται και με την εφαρμογή WhatsApp Business και με το Cloud API.

Ποια είναι τα επίπεδα ενός AI agent SaaS;

Πέντε, με έναν ρόλο το καθένα, ώστε ένα αργό μοντέλο να μην χάνει ποτέ μήνυμα και ένας λογαριασμός που αποσυνδέεται να μην ρίχνει ποτέ ολόκληρο το προϊόν. Η easyCoexistence βρίσκεται στο πρώτο και στο τελευταίο: συνδέει τους λογαριασμούς και τους κρατά σε λειτουργία, ενώ η λογική των συνομιλιών και το μοντέλο μένουν στο backend σας.

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

Πώς μοντελοποιείτε τους tenants, τα κανάλια και τις συνομιλίες;

Σε τρεις πίνακες. Ο tenant είναι ο πελάτης σας, και το id του στέλνεται ως external_ref σε κάθε session σύνδεσης, ώστε κάθε σύνδεση και κάθε γεγονός κατάστασης να επιστρέφει με αυτή την ετικέτα. Μια γραμμή καναλιού κρατά το connection_id ενός αριθμού WhatsApp ή το channel_id ενός λογαριασμού κοινωνικού δικτύου, μαζί με το δίκτυο και την κατάστασή του. Μια συνομιλία ταυτοποιείται από το κανάλι και το ID του ατόμου στο συγκεκριμένο δίκτυο: τον αριθμό WhatsApp στο from, το ID με εμβέλεια Instagram σε ένα DM, ή το νήμα του σχολίου στο TikTok.

Πού πρέπει να πηγαίνουν πρώτα τα εισερχόμενα γεγονότα;

Σε μια ανθεκτική ουρά, πριν τρέξει οποιοδήποτε μοντέλο. Το endpoint λήψης ελέγχει το μυστικό στη διαδρομή URL στις παραδόσεις WhatsApp και το X-EC-Signature στα προωθημένα γεγονότα κοινωνικών δικτύων, γράφει το γεγονός στην ουρά και απαντά 2xx. Οι δύο πηγές συμπεριφέρονται διαφορετικά: ο Meta επαναλαμβάνει ένα webhook του WhatsApp για έως 7 ημέρες, οπότε το ίδιο μήνυμα μπορεί να φτάσει δύο φορές, ενώ ένα προωθημένο γεγονός Instagram, Facebook ή TikTok στέλνεται μία φορά και δεν διατηρείται ποτέ, άρα ένα γεγονός που το endpoint σας απορρίπτει χάνεται οριστικά. Αφαιρέστε τα διπλότυπα με βάση το δικό ID μηνύματος ή σχολίου του δικτύου.

Πώς κρατάτε τις απαντήσεις σε σειρά και στην ώρα τους;

Ένας worker ανά συνομιλία, και ένας έλεγχος πριν από κάθε αποστολή. Κλειδώστε τη συνομιλία όσο δουλεύει ο agent, ώστε δύο μηνύματα από το ίδιο άτομο να απαντώνται με τη σειρά τους και ποτέ δύο φορές. Πριν φύγει μια απάντηση WhatsApp, συγκρίνετε το τελευταίο μήνυμα του ατόμου με το παράθυρο 24 ωρών και μεταβείτε σε εγκεκριμένο πρότυπο μηνύματος μόλις αυτό κλείσει. Βάλτε στην ουρά τις αποστολές κάθε αριθμού με το πολύ 20 μηνύματα το δευτερόλεπτο, τον σταθερό ρυθμό ενός αριθμού Coexistence, και θυμηθείτε ότι μια απάντηση στο TikTok είναι δημόσιο σχόλιο.

Πώς ο άνθρωπος παίρνει τη συνομιλία από τον agent;

Μέσα από το ίδιο το κανάλι. Με το Coexistence, το προσωπικό του πελάτη σας συνεχίζει να χρησιμοποιεί την εφαρμογή WhatsApp Business στον ίδιο αριθμό, και κάθε μήνυμα που στέλνει φτάνει στο webhook σας ως smb_message_echoes. Αντιμετωπίστε το echo ως μεταβίβαση: παύστε τον agent σε εκείνη τη συνομιλία, δώστε την απάντηση του προσωπικού στο μοντέλο ως context και συνεχίστε μετά από μια ήσυχη περίοδο ή όταν το προσωπικό την επιστρέψει μέσα στο προϊόν σας. Το Instagram επιστρέφει επίσης τα δικά του DMs του λογαριασμού ως echo, οπότε ο ίδιος κανόνας εμποδίζει τον agent να απαντά στον εαυτό του.

Μπορεί ο agent και να δημοσιεύει, όχι μόνο να απαντά;

Μπορεί, με το ίδιο κλειδί. Ο agent συντάσσει αναρτήσεις και το backend σας τις βάζει στην ουρά με POST /channels/:id/posts σε Instagram, Facebook, TikTok και LinkedIn, με χρονική απόσταση από 1 λεπτό έως 90 ημέρες, ενώ τα post.published και post.failed επιστρέφουν στην αποθήκη συνομιλιών. Οι αναρτήσεις στο LinkedIn δημοσιεύονται μόνο αφού ένα άτομο εγκρίνει την καθεμία στο προϊόν σας, επειδή οι Όροι του API του LinkedIn περιορίζουν την αυτοματοποιημένη δημοσίευση.

Πώς αντιδρά το προϊόν όταν χάνεται μια σύνδεση;

Μέσω μιας κατάστασης στη γραμμή του καναλιού. Ένα γεγονός κατάστασης τη μεταφέρει σε disconnected, removed ή suspended, ο agent σταματά να στέλνει σε αυτό το κανάλι, και η διεπαφή σας ζητά από τον tenant να συνδεθεί ξανά μέσω νέου session σύνδεσης. Ένα γεγονός connection.token_missing αφήνει έναν αριθμό να λαμβάνει αλλά να μη μπορεί να στέλνει, οπότε ο agent συντάσσει προσχέδια απαντήσεων για το προσωπικό. Το connection.connected ή το channel.connected επαναφέρει τη γραμμή σε active, και ο worker φέρνει νέα διαπιστευτήρια πριν από την επόμενη απάντηση.

Ποια δεδομένα αποθηκεύετε, και ποια κρατά η easyCoexistence;

Το προϊόν σας αποθηκεύει τις συνομιλίες. Τα μηνύματα ενός αριθμού WhatsApp πηγαίνουν από τον Meta κατευθείαν στο webhook σας, και τα προωθημένα γεγονότα κοινωνικών δικτύων περνούν από την easyCoexistence χωρίς αντίγραφο. Η easyCoexistence κρατά ό,τι χρειάζεται για να εξυπηρετεί τη σύνδεση: την εγγραφή του λογαριασμού, τα tokens του, το ιστορικό υγείας του και τις αναρτήσεις που δημοσιεύει. Αν ο λογαριασμός σας ενεργοποιήσει και τα δικά της αυτοματισμούς, το κείμενο των μηνυμάτων τους διατηρείται 7 ημέρες και τα αρχεία εκτέλεσής τους 30.

Συνηθισμένα λάθη

  • Ταυτοποίηση συνομιλιών μόνο με τον τηλεφωνικό αριθμό του ατόμου. Το ίδιο άτομο μπορεί να γράφει σε δύο από τους tenants σας, οπότε κλειδώστε κάθε νήμα με το κανάλι και το ID του ατόμου μαζί.
  • Το να αφήνετε δύο workers να απαντούν σε μία συνομιλία. Οι παράλληλοι workers μπορεί να στείλουν απαντήσεις εκτός σειράς ή δύο φορές, οπότε κλειδώστε κάθε νήμα όσο δουλεύει ο agent.
  • Το να μένει ο agent ενεργός όταν το προσωπικό απαντά από την εφαρμογή WhatsApp Business. Το echo δείχνει ότι ένα άτομο έχει αναλάβει το νήμα, οπότε παύστε τον agent εκεί μέχρι να τον επαναφέρει ο κανόνας μεταβίβασής σας.
  • Η δημοσίευση των προσχεδίων LinkedIn του agent με χρονοδιακόπτη. Ένα άτομο εγκρίνει κάθε ανάρτηση στο LinkedIn, οπότε στείλτε αυτά τα προσχέδια σε βήμα ελέγχου πριν φτάσουν στην ουρά.
Κάντε το με EasyCoexistence

Η easyCoexistence είναι το επίπεδο σύνδεσης για το προϊόν agent σας: τους αριθμούς WhatsApp των πελατών σας και τους λογαριασμούς τους σε Instagram, Facebook, TikTok, YouTube και LinkedIn, και άλλα κανάλια, συνδεδεμένα μέσω φιλοξενούμενων συνδέσμων, με νέα διαπιστευτήρια, webhooks, ουρά δημοσίευσης και υπογεγραμμένα γεγονότα κατάστασης, με κάθε σύνδεση παρακολουθούμενη όλο το 24ωρο. Από US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.

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

Χρειάζεται να εγκαταστήσουν κάτι οι πελάτες των πελατών μου;

Όχι. Γράφουν στην επιχείρηση όπως ήδη κάνουν, στο WhatsApp, στα DMs του Instagram ή στο Messenger, ή στα σχόλια, και ο agent σας απαντά στο ίδιο κανάλι.

Μπορεί το προσωπικό των πελατών μου να συνεχίσει να απαντά με το χέρι;

Ναι. Με το Coexistence, η εφαρμογή WhatsApp Business συνεχίζει να λειτουργεί στον ίδιο αριθμό, και κάθε μήνυμα που στέλνει το προσωπικό φτάνει στο webhook σας ως echo, ώστε ο agent να μπορεί να υποχωρήσει.

Η easyCoexistence τρέχει το μοντέλο;

Όχι. Το μοντέλο, τα prompts και η μνήμη του τρέχουν στο backend σας. Η easyCoexistence συνδέει τους λογαριασμούς, παραδίδει τα γεγονότα τους και κρατά σε λειτουργία την πρόσβασή τους.

Πόσο χρεώνει η easyCoexistence ανά πελάτη ενός agent SaaS;

Κάθε συνδεδεμένος αριθμός ή λογαριασμός κοστίζει από US$ 9 έως US$ 0.75 τον μήνα, με μείωση όσο αυξάνεται το σύνολό σας, οπότε ένας πελάτης με WhatsApp και Instagram μετράει δύο φορές. Οι πρώτες 3 ημέρες είναι δωρεάν.

Συνεχίστε την ανάγνωση

Πώς να δημιουργήσετε ένα προϊόν AI agent στα WhatsApp, Instagram και TikTok των πελατών σαςΦτιάξτε προϊόν AI agent για WhatsApp, Instagram, Facebook και TikTok των πελατών σας, με το Partner API και τους κανόνες κάθε δικτύου.Πώς να φτιάξετε scheduler για social media με API: την ουρά, τα media και τις καταστάσεις των αναρτήσεωνΦτιάξτε scheduler για social media με το posts API του easyCoexistence: publish_at έως 90 ημέρες μπροστά, αντιγραφή media, έξι καταστάσεις και events.Μεταπώληση λειτουργιών κοινωνικών δικτύων στο SaaS σας: περιθώρια κέρδους από US$ 9 έως US$ 0,75 ανά σύνδεσηΤι κερδίζει ένα SaaS από μεταπώληση λειτουργιών κοινωνικών δικτύων σε US$ 9 έως US$ 0,75 ανά σύνδεση, με υπολογισμένα περιθώρια κέρδους.Social Media API για γραφεία: διαχειριστείτε τους λογαριασμούς των πελατών σας από το δικό σας λογισμικόAPI για γραφεία: συνδέστε τους λογαριασμούς κάθε πελάτη με σύνδεσμο, δημοσιεύστε με έγκριση, δρομολογήστε απαντήσεις και δείτε αναφορές.Πώς λαμβάνετε τα μηνύματα WhatsApp και τα σχόλια των πελατών σας μέσω του webhookΈνα webhook για κάθε σύνδεση: μηνύματα WhatsApp απευθείας από τη Meta, με μυστικό στο URL, και σχόλια και DMs υπογεγραμμένα με X-EC-Signature.Πώς να μάθετε πότε αποσυνδέεται η σύνδεση WhatsApp ή social ενός πελάτη;Γεγονότα connection.* και channel.*: payloads, αιτίες όπως PRIMARY_INACTIVITY, X-EC-Signature, επαναλήψεις για περίπου 33 ώρες και έλεγχος διπλών με το id.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις