Πώς να δημιουργήσετε ένα προϊόν AI agent στα WhatsApp, Instagram και TikTok των πελατών σας
Ένα προϊόν AI agent στα κανάλια των πελατών σας στηρίζεται σε τρία στοιχεία: έναν φιλοξενούμενο σύνδεσμο σύνδεσης για τον αριθμό WhatsApp ή τον λογαριασμό κοινωνικού δικτύου κάθε πελάτη, τα webhooks που φέρνουν τα μηνύματα και τα σχόλιά τους στο backend σας, όπου το δικό σας μοντέλο γράφει απαντήσεις που στέλνονται μέσω του επίσημου API κάθε δικτύου με το token του πελάτη, και συμβάντα κατάστασης για συνδέσεις που διακόπτονται. Ο agent τηρεί τους κανόνες κάθε δικτύου, όπως το παράθυρο 24 ωρών του WhatsApp.
Το easyCoexistence δίνει φωνή στους AI agents του προϊόντος σας στους αριθμούς WhatsApp των πελατών σας και στους λογαριασμούς τους σε Instagram, Facebook, TikTok, YouTube και LinkedIn, και περισσότερα κανάλια: φιλοξενούμενους συνδέσμους σύνδεσης, νέα διαπιστευτήρια, webhooks και υπογεγραμμένα συμβάντα κατάστασης μέσω του επίσημου API κάθε δικτύου, με κάθε σύνδεση να παρακολουθείται 24/7.
Το παράθυρο εξυπηρέτησης πελατών του WhatsApp ανοίγει μετά από μήνυμα ή κλήση του χρήστη· κάθε νέο μήνυμα το επαναφέρει.
Τι μπορεί να στείλει μια επιχείρηση WhatsApp όταν κλείσει το παράθυρο εξυπηρέτησης πελατών: προεγκεκριμένα μηνύματα template.
Οι όροι της Meta απαγορεύουν στους παρόχους AI να χρησιμοποιούν το WhatsApp για να προσφέρουν AI ως κύρια, και όχι παρεπόμενη, λειτουργία.
Παράθυρο για τη μία ιδιωτική απάντηση σε σχόλιο λογαριασμού Instagram, μετρούμενο από τη στιγμή που έγινε το σχόλιο.
Σταθερός ρυθμός αποστολής ενός αριθμού που χρησιμοποιείται και με την εφαρμογή WhatsApp Business και με το Cloud API.
Τι χρειάζεται ένα προϊόν AI agent από το κανάλι κάθε πελάτη;
Τέσσερα πράγματα: τρόπο να συνδέσει ο πελάτης το κανάλι, τα μηνύματά του να φτάνουν στο backend σας, ένα token για να απαντήσετε και ειδοποίηση όταν η σύνδεση σταματά να λειτουργεί. Το Partner API καλύπτει καθένα από αυτά, ενώ το μοντέλο, τα prompts και η λογική συνομιλίας μένουν δικά σας. Το easyCoexistence συνδέει τον λογαριασμό, ανανεώνει την πρόσβαση και την παρακολουθεί, και οι απαντήσεις σας πηγαίνουν από το backend σας κατευθείαν στο API του δικτύου.
Πώς συνδέεται κάθε πελάτης;
Το backend σας δημιουργεί μια συνεδρία σύνδεσης με POST /connect-sessions, ορίζοντας το κανάλι, το redirect_url και το external_ref για τον πελάτη σας, και για έναν αριθμό το webhook_url και το webhook_verify_token. Ο πελάτης ανοίγει τον φιλοξενούμενο σύνδεσμο, συνδέεται με Meta, TikTok, Google ή LinkedIn και επιστρέφει στην εφαρμογή σας με connection_id ή channel_id. Δεν χρειάζεται λογαριασμό easyCoexistence, email ή κάρτα, και κάθε σύνδεση που γίνεται με το κλειδί σας ανήκει στον λογαριασμό σας.
Πώς φτάνουν τα μηνύματα και τα σχόλια στο μοντέλο σας;
Μέσω webhook, στα δίκτυα που τα στέλνουν. Η Meta παραδίδει τα μηνύματα ενός αριθμού κατευθείαν στο webhook_url του, και ό,τι στέλνει το προσωπικό της επιχείρησης από την εφαρμογή WhatsApp Business φτάνει εκεί ως smb_message_echoes. Τα σχόλια, οι αναφορές και τα DMs του Instagram και του Facebook, καθώς και τα σχόλια του TikTok, προωθούνται στον προορισμό κάθε καναλιού, υπογεγραμμένα με το μυστικό του. Το YouTube και το LinkedIn δεν στέλνουν συμβάντα σχολίων, οπότε ο agent διαβάζει τα νέα σχόλια μέσω των API τους σε χρονοδιάγραμμα. Απαντήστε σε κάθε παράδοση με 2xx αμέσως και αφήστε έναν worker να καλέσει το μοντέλο.
Πώς απαντά ο agent;
Μέσω του δικού API του δικτύου, με τα διαπιστευτήρια που έχει ανακτήσει το backend σας. Μια απάντηση WhatsApp είναι POST στο send_endpoint του αριθμού με το token του πελάτη· ένα DM στο Instagram ή στο Facebook πηγαίνει στο messages edge του λογαριασμού· μια απάντηση TikTok πηγαίνει κάτω από το σχόλιο μέσω του business/comment/reply/create/. Το παρακάτω σχέδιο κώδικα απαντά σε μηνύματα WhatsApp: ελέγχει το μυστικό στη διαδρομή του URL, βάζει στην ουρά κάθε εισερχόμενο μήνυμα και απαντά με ό,τι επιστρέφει το μοντέλο σας.
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"] # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {} # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)
@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
if not hmac.compare_digest(secret, PATH_SECRET):
abort(404)
if request.method == "GET": # Meta's handshake when the destination is set
if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
abort(403)
return request.args.get("hub.challenge", "")
for entry in request.get_json().get("entry", []):
for change in entry.get("changes", []):
if change.get("field") == "messages": # echoes and history are context, not prompts
value = change["value"]
for msg in value.get("messages", []):
jobs.put((value["metadata"]["phone_number_id"], msg))
return "", 200 # answer at once; dedupe on msg["id"], since Meta can deliver twice
def worker() -> None:
while True:
phone_number_id, msg = jobs.get()
conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
headers=KEY, params={"credentials": 1}).json()
creds = conn["credentials"]
if not creds["access_token"]: # token_ready is false: a new connect session issues one
continue
reply = my_model(conn["external_ref"], msg) # your model, your prompt, your memory
requests.post(creds["send_endpoint"], # a reply to a fresh message is inside the 24 hours
headers={"Authorization": f"Bearer {creds['access_token']}"},
json={"messaging_product": "whatsapp", "to": msg["from"],
"type": "text", "text": {"body": reply}})
threading.Thread(target=worker, daemon=True).start()MCP server ή Partner API: ποιο χρησιμοποιεί ο agent;
Το Partner API, όταν ο agent είναι το προϊόν σας και οι πελάτες σας φέρνουν τα κανάλια: το backend σας κρατά το κλειδί, λαμβάνει τα συμβάντα και τρέχει όποιο μοντέλο επιλέξετε. Το MCP server στο https://easycoexistence.com/api/mcp ταιριάζει σε έναν βοηθό όπως το Claude ή το ChatGPT που ενεργεί στον δικό σας λογαριασμό easyCoexistence, μέσω εργαλείων που καλεί κατόπιν αιτήματος μετά από σύνδεση OAuth. Οι αριθμοί και τα κανάλια που συνδέονται με το κλειδί σας βρίσκονται επίσης σε εκείνον τον λογαριασμό, οπότε μια συνεδρία MCP μπορεί να τα αγγίξει για τη δουλειά της δικής σας ομάδας.
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
Πώς τα πρακτορεία τρέχουν agents για πολλούς πελάτες;
Σε έναν λογαριασμό, με κάθε πελάτη να έχει ετικέτα. Περάστε το ID του πελάτη ως external_ref σε κάθε συνεδρία σύνδεσης, δείξτε το όνομα του πρακτορείου σας στη φιλοξενούμενη σελίδα με partner_name, και καταγράψτε τις συνδέσεις ενός πελάτη με GET /connections?external_ref= και GET /channels?external_ref=. Κάθε σύνδεση χρεώνεται στο πρακτορείο US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προστίθενται συνδέσεις, ενώ η Meta χρεώνει τις χρεώσεις συνομιλιών WhatsApp στον λογαριασμό WhatsApp Business του πελάτη. Με το Coexistence, το προσωπικό του πελάτη συνεχίζει να απαντά στην εφαρμογή WhatsApp Business δίπλα στον agent.
Ποιους κανόνες πρέπει να τηρεί ο agent;
Τους κανόνες των ίδιων των δικτύων, τους οποίους ο κώδικάς σας πρέπει να ελέγχει πριν βγει η απάντηση του μοντέλου. Οι πλατφόρμες τους τηρούν εκ μέρους των πελατών τους, αφού η επιβολή της Meta πέφτει στον λογαριασμό του πελάτη:
- WhatsApp: ελεύθερο κείμενο μόνο εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη· μετά από αυτό, ένα εγκεκριμένο template, που στέλνεται μέσω του API, επειδή η εφαρμογή WhatsApp Business δεν μπορεί να στείλει templates στο Coexistence.
- WhatsApp: οι όροι της Meta απαγορεύουν την προσφορά AI ως κύριας λειτουργίας, που η αναφορά του Partner API ορίζει ως απαγόρευση bots AI γενικής χρήσης, και επιτρέπουν το fine-tuning σε δεδομένα WhatsApp μόνο για την αποκλειστική χρήση της επιχείρησης.
- Instagram και Facebook: DMs εντός 24 ωρών από το τελευταίο μήνυμα του ατόμου, και μία ιδιωτική απάντηση ανά σχόλιο εντός 7 ημερών από αυτό.
- TikTok: οι απαντήσεις σε σχόλια είναι δημόσιες, αφού μια σύνδεση TikTok δεν έχει DMs.
- Όγκος: 20 μηνύματα ανά δευτερόλεπτο ανά αριθμό Coexistence, και τα marketing templates χρειάζονται μέθοδο πληρωμής στον λογαριασμό WhatsApp Business του πελάτη.
Πώς ο agent μαθαίνει ότι ένα κανάλι σταμάτησε να λειτουργεί;
Από συμβάντα κατάστασης. Το connection.disconnected ή το channel.disconnected σημαίνει ότι οι απαντήσεις αποτυγχάνουν μέχρι να επανασυνδεθεί ο πελάτης, οπότε παύστε τον agent αυτού του πελάτη, ενημερώστε τον και στείλτε νέο σύνδεσμο σύνδεσης· το connection.token_missing σημαίνει ότι ο αριθμός μπορεί να λαμβάνει αλλά δεν μπορεί ακόμη να στείλει. Όταν ξανάρθει το connection.connected ή το channel.connected, ανακτήστε νέα διαπιστευτήρια και συνεχίστε. Κάθε συμβάν υπογράφεται με το X-EC-Signature και επαναπροσπαθείται για περίπου 33 ώρες.
Συνηθισμένα λάθη
- Να αφήνετε το μοντέλο να απαντά σε μήνυμα WhatsApp παλαιότερο των 24 ωρών με ελεύθερο κείμενο. Το παράθυρο έχει κλείσει, οπότε ελέγξτε την ώρα του τελευταίου εισερχόμενου μηνύματος του πελάτη και περάστε σε εγκεκριμένο template.
- Η εκπαίδευση ενός κοινού μοντέλου πάνω σε συνομιλίες WhatsApp των πελατών σας. Οι όροι της Meta επιτρέπουν το fine-tuning σε δεδομένα της πλατφόρμας WhatsApp Business μόνο για την αποκλειστική χρήση της επιχείρησης, ποτέ για τη βελτίωση άλλων μοντέλων.
- Το να αντιμετωπίζετε τα smb_message_echoes ως μηνύματα πελατών. Είναι όσα έστειλε το προσωπικό της επιχείρησης από την εφαρμογή, οπότε δώστε τα στο μοντέλο ως πλαίσιο, όχι ως μηνύματα για απάντηση.
- Το να απαντά ο agent στις δικές του απαντήσεις του λογαριασμού. Τα DMs του Instagram που στέλνει επιστρέφουν ως echoes και οι απαντήσεις του TikTok ως συμβάντα σχολίων, οπότε παρακάμψτε ό,τι έγραψε ο ίδιος ο λογαριασμός, αλλιώς ο agent απαντά στον εαυτό του.
US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και δωρεάν δοκιμή τις πρώτες 3 ημέρες.
Συχνές ερωτήσεις
Μπορώ να χρησιμοποιήσω το δικό μου μοντέλο AI;
Ναι. Το backend σας λαμβάνει τα μηνύματα, καλεί όποιο μοντέλο επιλέξετε και απαντά μέσω του API του δικτύου με το token του πελάτη. Τα μηνύματα ενός αριθμού WhatsApp πηγαίνουν από τη Meta κατευθείαν στο webhook σας, ποτέ μέσω του easyCoexistence.
Τι σημαίνει η πολιτική AI της Meta για έναν agent WhatsApp;
Οι όροι της Meta απαγορεύουν στους παρόχους AI να χρησιμοποιούν την πλατφόρμα WhatsApp Business για να προσφέρουν τεχνολογία AI ως κύρια λειτουργία, και όχι ως παρεπόμενη ή δευτερεύουσα, όπως κρίνει η ίδια η Meta. Τηρήστε την εκ μέρους των πελατών σας, μαζί με το παράθυρο 24 ωρών και τα εγκεκριμένα templates.
Μπορεί ο agent να στέλνει DMs στο TikTok, το YouTube ή το LinkedIn;
Όχι. Σε αυτά τα δίκτυα ο agent δουλεύει στα σχόλια: οι απαντήσεις στο TikTok είναι δημόσιες, και τα σχόλια του YouTube και του LinkedIn διαβάζονται και απαντιούνται μέσω των API τους.
Πόσο κοστίζει το easyCoexistence για ένα προϊόν AI agent;
Ανά σύνδεση, το ίδιο σε κάθε δίκτυο: US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και δωρεάν δοκιμή τις πρώτες 3 ημέρες. Η Meta χρεώνει τις χρεώσεις συνομιλιών WhatsApp στον λογαριασμό WhatsApp Business κάθε πελάτη.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις