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

Πώς να δημιουργήσετε ένα προϊόν 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.

24 hours

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

Templates only

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

Section 4.7

Οι όροι της Meta απαγορεύουν στους παρόχους AI να χρησιμοποιούν το WhatsApp για να προσφέρουν AI ως κύρια, και όχι παρεπόμενη, λειτουργία.

7 days

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

20 mps

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

Τι χρειάζεται ένα προϊόν AI agent από το κανάλι κάθε πελάτη;

Τέσσερα πράγματα: τρόπο να συνδέσει ο πελάτης το κανάλι, τα μηνύματά του να φτάνουν στο backend σας, ένα token για να απαντήσετε και ειδοποίηση όταν η σύνδεση σταματά να λειτουργεί. Το Partner API καλύπτει καθένα από αυτά, ενώ το μοντέλο, τα prompts και η λογική συνομιλίας μένουν δικά σας. Το easyCoexistence συνδέει τον λογαριασμό, ανανεώνει την πρόσβαση και την παρακολουθεί, και οι απαντήσεις σας πηγαίνουν από το backend σας κατευθείαν στο API του δικτύου.

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

Πώς συνδέεται κάθε πελάτης;

Το 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, βάζει στην ουρά κάθε εισερχόμενο μήνυμα και απαντά με ό,τι επιστρέφει το μοντέλο σας.

Python: a WhatsApp agent on your own model
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 APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools 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 απαντά στον εαυτό του.
Κάντε το με EasyCoexistence

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 κάθε πελάτη.

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

Πώς να πάρετε τα API tokens των πελατών σας για WhatsApp, Instagram και TikTokΤι επιστρέφει η κλήση διαπιστευτηρίων για έναν αριθμό WhatsApp και για κάθε λογαριασμό social, πεδίο προς πεδίο, και πώς λειτουργούν τα tokens.Πώς λαμβάνετε τα μηνύματα WhatsApp και τα σχόλια των πελατών σας μέσω του webhookΈνα webhook για κάθε σύνδεση: μηνύματα WhatsApp απευθείας από τη Meta, με μυστικό στο URL, και σχόλια και DMs υπογεγραμμένα με X-EC-Signature.Πώς να μάθετε πότε αποσυνδέεται η σύνδεση WhatsApp ή social ενός πελάτη;Γεγονότα connection.* και channel.*: payloads, αιτίες όπως PRIMARY_INACTIVITY, X-EC-Signature, επαναλήψεις για περίπου 33 ώρες και έλεγχος διπλών με το id.API κοινωνικών δικτύων για AI agents: δημοσίευση, προγραμματισμός, απαντήσεις και μέτρησηΈνα API και MCP server για AI agents: δημοσίευση, προγραμματισμός, απαντήσεις και αναλυτικά σε κοινωνικά δίκτυα μέσω επίσημων API.WhatsApp Coexistence για πρακτορεία και συμβουλευτικές εταιρείεςΣυνδέστε αριθμούς WhatsApp πελατών χωρίς μεταφορά ή επανεκπαίδευση προσωπικού. Ένας λογαριασμός, πολλοί αριθμοί, ο καθένας στο Business Portfolio του πελάτη.Το 24ωρο παράθυρο εξυπηρέτησης πελατώνΤι είναι το παράθυρο εξυπηρέτησης, πότε ανοίγει και κλείνει, τι στέλνετε μέσα ή έξω από αυτό και γιατί οι απαντήσεις δεν χρεώνονται.

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

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

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

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