ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
Meta Tech Provider

WhatsApp API για AI agents: επίσημη πρόσβαση σε λίγα λεπτά, χωρίς να γίνετε Tech Provider

Ένας AI agent παίρνει επίσημη πρόσβαση στο WhatsApp μέσω του Cloud API της Meta, και ένας αριθμός που παραμένει στην εφαρμογή WhatsApp Business συνδέεται σε αυτό μέσω Tech Provider ή Solution Partner. Μπορείτε να γίνετε ένας από αυτούς, με επαλήθευση της επιχείρησης, βίντεο App Review και ένα build Embedded Signup, ή να συνδεθείτε μέσω παρόχου που ήδη είναι τέτοιος: ο αριθμός συνδέεται σε λίγα λεπτά και ο agent παίρνει εργαλεία MCP ή credentials API.

Το easyCoexistence είναι ανεξάρτητος Tech Provider της Meta: συνδέει έναν αριθμό WhatsApp Business με το Cloud API μέσω Coexistence σε λίγα λεπτά, ώστε ο agent σας να αποκτά επίσημη πρόσβαση ενώ η επιχείρηση κρατά την εφαρμογή.

Tech Provider

Τι απαιτεί η Meta από όποιον ενσωματώνει έναν αριθμό που παραμένει στην εφαρμογή WhatsApp Business: καθεστώς Tech Provider ή Solution Partner.

2 videos

Το App Review ζητά ένα βίντεο ενός μηνύματος που στέλνεται από την εφαρμογή σας και ένα βίντεο της δημιουργίας ενός template από την εφαρμογή σας.

Advanced access

Τι εγκρίνει το App Review για τα whatsapp_business_messaging και whatsapp_business_management, και τα δύο απαραίτητα για να γίνει κανείς Tech Provider.

October 15, 2026

Όταν η Meta απενεργοποίησε τα Embedded Signup v2 και v3, ζητώντας από τις ενσωματώσεις να μεταβούν στην έκδοση v4.

20 msg/s

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

1 hour

Πόσο παραμένει έγκυρος ένας hosted connect link όταν μια πλατφόρμα ενσωματώνει τον αριθμό ενός πελάτη της μέσω του Partner API.

Τι χρειάζεται ένας AI agent για να χρησιμοποιεί το WhatsApp επίσημα;

Τέσσερα πράγματα από το Cloud API της Meta. Ένα phone number ID και ένα access token με το δικαίωμα whatsapp_business_messaging, ώστε ο agent να μπορεί να καλεί το endpoint των μηνυμάτων. Ένα webhook endpoint όπου η Meta παραδίδει τα εισερχόμενα μηνύματα και, σε αριθμό κοινόχρηστο με την εφαρμογή, το smb_message_echoes για τις απαντήσεις που πληκτρολογεί ένας άνθρωπος στο τηλέφωνο. Εγκεκριμένα templates, επειδή ένα πληκτρολογημένο μήνυμα φτάνει μόνο σε όποιον έγραψε τις τελευταίες 24 ώρες. Και ένας τρόπος να μαθαίνετε πότε διακόπτεται η σύνδεση, αφού η εφαρμογή στο τηλέφωνο συνεχίζει να λειτουργεί όταν σταματά η πλευρά του API.

Η συντόμευση που βρίσκουν πρώτη οι άνθρωποι είναι ο αυτοματισμός του WhatsApp Web, που συνδέεται ως συνδεδεμένη συσκευή. Αυτό παραβιάζει τους όρους του WhatsApp και θέτει τον αριθμό σε κίνδυνο αποκλεισμού, ανεξάρτητα από το τι κάνει ο agent από πάνω.

Τι περιλαμβάνει η διαδρομή Tech Provider;

Η ακολουθία της ίδιας της Meta, με αυτή τη σειρά. Κάθε βήμα είναι δωρεάν και κανένα δεν αγοράζεται πιο γρήγορα: οι έλεγχοι γίνονται με το χρονοδιάγραμμα της Meta, και η Meta δεν δημοσιεύει χρονοδιάγραμμα, οπότε υπολογίστε εβδομάδες αντί για μέρες μέχρι να συνδεθεί ο πρώτος αριθμός πελάτη. Μετά από αυτό, το backend πρέπει να συνεχίζει να τρέχει: την ανταλλαγή token μετά από κάθε εγγραφή, έναν λήπτη webhook, δρομολόγηση ανά αριθμό και παρακολούθηση για αποσυνδέσεις, όπως ο κανόνας αδράνειας 14 ημερών της Meta.

1Business verificationName, address, phone, email and website checked by Meta
2Meta appThe WhatsApp use case and a connected business portfolio
3App ReviewTwo videos, then advanced access to both WhatsApp permissions
4Embedded SignupVersion 4 or later, with WhatsApp Business app onboarding
5Your backendToken exchange, webhooks, routing and monitoring

Ποια είναι η συντομότερη διαδρομή;

Συνδέστε τον αριθμό μέσω ενός παρόχου που έχει ήδη περάσει από αυτή τη διαδικασία. Με το easyCoexistence, η επιχείρηση εκτελεί το Embedded Signup της Meta και σαρώνει έναν κωδικό με την εφαρμογή WhatsApp Business, κάτι που διαρκεί περίπου δύο λεπτά. Ο αριθμός προστίθεται στο Cloud API μέσα στο δικό της Business Portfolio, ενώ η εφαρμογή συνεχίζει να λειτουργεί. Ο agent παίρνει πρόσβαση στη μορφή που μιλά: εργαλεία MCP για έναν βοηθό όπως τα ChatGPT, Claude, Claude Code ή Codex, ή τα credentials και τα webhooks του αριθμού για κώδικα που εκτελείτε εσείς.

Connect through easyCoexistenceBecome a Tech Provider
Meta app and App ReviewNot needed: the number joins through oursYours to build and pass
Embedded SignupHosted, with the QR scan in the appYou integrate version 4 and host the flow
First number connectedMinutes after signing upAfter verification and review
Webhook trustA secret in your URL, or X-EC-Signature on forwarded messagesYour app secret signs Meta's deliveries
Disconnection alertsEvery number watched 24/7, 14-day rule includedMonitoring you build and run
Who owns the WhatsApp Business AccountThe business, in its own portfolioThe business

Πώς ο agent παίρνει τα credentials του αριθμού;

Μέσω του get_api_credentials, ή από τη σελίδα του αριθμού στο dashboard. Το εργαλείο επιστρέφει τη βασική διεύθυνση του Graph API, το WhatsApp Business Account ID, το phone number ID, το send endpoint και, όταν υπάρχει, το δικό του access token της επιχείρησης, περιορισμένο στα assets WhatsApp της. Όταν δεν έχει εκδοθεί client token, το token επιστρέφει null με σημείωση ότι η επανασύνδεση του αριθμού από το dashboard εκδίδει ένα, χωρίς να αντικαθιστά ένα token που λειτουργεί. Δεν υπάρχει app secret να ανακτηθεί, επειδή η Meta υπογράφει τα webhooks με το app secret του easyCoexistence, το οποίο δεν μοιράζεται ποτέ. Το εργαλείο χρειάζεται ενεργό πλάνο, αφού το token μπορεί να στέλνει.

Send a reply with the returned credentials
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511999998888",
    "type": "text",
    "text": { "body": "Your order #1042 is ready for pickup." }
  }'

Πώς φτάνουν τα εισερχόμενα μηνύματα στον agent;

Κάθε αριθμός έχει δύο λειτουργίες, που αλλάζουν με το set_inbound_mode ή από τη σελίδα του αριθμού. Απευθείας στον server σας: το set_webhook_destination δείχνει τη Meta κατευθείαν στο HTTPS endpoint σας, το οποίο πρέπει να απαντά στο GET handshake της Meta. Το easyCoexistence δεν βλέπει ποτέ τα μηνύματα, οπότε οι αυτοματισμοί είναι απενεργοποιημένοι. Επειδή η Meta υπογράφει αυτές τις παραδόσεις με το app secret μας, βάλτε ένα μακρύ τυχαίο μυστικό στη διαδρομή του URL και απορρίπτετε τα αιτήματα που δεν το έχουν.

Αυτοματισμοί ενεργοί: η Meta παραδίδει στο easyCoexistence, οι αυτοματισμοί μπορούν να απαντούν, και ένα προαιρετικό Forward URL λαμβάνει το αρχικό payload της Meta κάτω από το "value", υπογεγραμμένο με X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 του "<t>.<body>">, χρησιμοποιώντας ένα μυστικό που εμφανίζεται μία φορά. Το βήμα αυτοματισμού «Call my webhook» στέλνει επίσης το μήνυμα και τα τελευταία 10 μηνύματα της συνομιλίας στον agent σας, και στέλνει την απάντησή του όταν η απάντησή σας είναι {"reply": "..."} μέσα σε 20 δευτερόλεπτα.

Ποια όρια πρέπει να σέβεται ο agent;

Αυτά της Meta, και είναι τα ίδια μέσω οποιουδήποτε παρόχου. Ένας agent που τα γνωρίζει εκ των προτέρων αποφεύγει τις αποτυχίες που μοιάζουν με σφάλματα κώδικα:

  • 20 μηνύματα το δευτερόλεπτο ανά αριθμό, καθορισμένα από τη Meta για αριθμούς κοινόχρηστους με την εφαρμογή WhatsApp Business.
  • Πληκτρολογημένα μηνύματα μόνο εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη· μετά, ένα εγκεκριμένο template.
  • Τα templates στέλνονται μόνο μέσω του API, επειδή η εφαρμογή σε έναν αριθμό Coexistence δεν μπορεί να τα στείλει.
  • Οι απαντήσεις που πληκτρολογεί κάποιος στην εφαρμογή φτάνουν ως smb_message_echoes· παύστε τον agent σε εκείνη τη συνομιλία, αλλιώς ο πελάτης παίρνει δύο απαντήσεις.
  • Οι ομαδικές συνομιλίες δεν συγχρονίζονται με το API, οπότε ο agent δουλεύει σε συνομιλίες ένα προς ένα.
  • Οι επαφές και έως 6 μήνες συνομιλιών ένα προς ένα εισάγονται μία φορά, μόνο αν έχει αποθηκευτεί άμεσος προορισμός webhook μέσα σε 24 ώρες από τη σύνδεση· ένας αριθμός με ενεργούς αυτοματισμούς δεν λαμβάνει την εισαγωγή.
  • Οι φωνητικές και οι βιντεοκλήσεις συνεχίζουν να λειτουργούν στην εφαρμογή, αλλά το Cloud API δεν μεταφέρει κλήσεις σε αριθμό Coexistence, οπότε ο agent δουλεύει με κείμενο.

Μπορεί μια πλατφόρμα να συνδέει με αυτόν τον τρόπο τους αριθμούς των δικών της πελατών;

Ναι, μέσω του Partner API, που είναι ο τρόπος με τον οποίο μια SaaS ή ένα πρακτορείο ενσωματώνει τους πελάτες του χωρίς δικό του καθεστώς Tech Provider. Δημιουργήστε το κλειδί με create_api_key (ξεκινά με ec_live_ και εμφανίζεται μία φορά), και μετά καλέστε POST /api/v1/connect-sessions από το backend σας, ή create_connect_link από τον βοηθό, για έναν hosted σύνδεσμο έγκυρο για 1 ώρα. Ο πελάτης εκτελεί εκεί το popup της Meta και τη σάρωση QR και επιστρέφει στο redirect_url σας με ένα connection_id. Το GET /api/v1/connections/:id?credentials=1 επιστρέφει έπειτα το δικό του token του πελάτη, και τα συμβάντα κατάστασης, όπως το connection.disconnected, φτάνουν υπογεγραμμένα με X-EC-Signature. Κάθε αριθμός χρεώνεται στον λογαριασμό σας με τις ίδιες βαθμίδες ανά αριθμό.

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

  • Επικύρωση του X-Hub-Signature-256 σε άμεσο προορισμό. Η Meta υπογράφει με το app secret του easyCoexistence, το οποίο δεν μοιράζεται ποτέ, οπότε οι γνήσιες παραδόσεις αποτυγχάνουν στον έλεγχο· εμπιστευτείτε ένα μακρύ τυχαίο μυστικό στο URL ή χρησιμοποιήστε προώθηση με X-EC-Signature.
  • Λήψη με τον κόμβο WhatsApp Trigger του n8n. Αυτός απαιτεί τη δική σας εφαρμογή Meta· χρησιμοποιήστε αντί αυτού τον γενικό κόμβο Webhook με μυστικό στο URL του.
  • Αγνόηση των smb_message_echoes. Τότε ο agent απαντά πάνω σε έναν άνθρωπο που έχει ήδη απαντήσει από το τηλέφωνο, και ο πελάτης διαβάζει δύο απαντήσεις.
  • Αποθήκευση του άμεσου προορισμού webhook μέρες μετά τη σύνδεση, ή διατήρηση του αριθμού με ενεργούς αυτοματισμούς. Η εφάπαξ εισαγωγή της Meta για επαφές και έως 6 μήνες συνομιλιών χρειάζεται άμεσο προορισμό αποθηκευμένο μέσα σε 24 ώρες από τη σύνδεση.
Κάντε το με EasyCoexistence

Ο agent δουλεύει μέσω περισσότερων από 30 εργαλείων MCP ή μέσω των credentials και των webhooks κάθε αριθμού, και κάθε αριθμός παρακολουθείται 24/7 με ειδοποιήσεις. Από US$ 9 έως US$ 0,75 ανά αριθμό τον μήνα, με μείωση όσο προσθέτετε αριθμούς, και οι πρώτες 3 ημέρες δωρεάν.

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

Χρειάζομαι δική μου εφαρμογή Meta;

Όχι. Ο αριθμός ενσωματώνεται μέσω της εφαρμογής Meta του easyCoexistence και παραμένει στο δικό της Business Portfolio και στον δικό της WhatsApp Business Account. Ο κώδικάς σας στέλνει με το δικό της token από το get_api_credentials, οπότε καμία δική σας εφαρμογή δεν εμπλέκεται, εκτός αν αργότερα φτιάξετε μία.

Μπορούν ο agent και η ομάδα να χρησιμοποιούν τον αριθμό ταυτόχρονα;

Ναι. Η Meta αντικατοπτρίζει τα μηνύματα μεταξύ του Cloud API και της εφαρμογής WhatsApp Business, οπότε ό,τι στέλνει ο agent εμφανίζεται στο νήμα της συνομιλίας στο τηλέφωνο, και ό,τι πληκτρολογεί η ομάδα στην εφαρμογή φτάνει στο σύστημά σας ως smb_message_echoes.

Ποια frameworks agent λειτουργούν μαζί του;

Κάθε client που μιλά MCP μέσω HTTP με OAuth, όπως τα ChatGPT, Claude, Claude Code, Codex και Cursor, και κάθε κώδικας που καλεί το Graph API της Meta: Node.js, Python, n8n, LangChain, το OpenAI Agents SDK ή το Vercel AI SDK. Το API από κάτω είναι της ίδιας της Meta, οπότε δεν υπάρχει κάτι ιδιόκτητο μέσα στον agent.

Επιτρέπεται ένας AI βοηθός γενικής χρήσης στο WhatsApp;

Η ενότητα 4.7 των όρων της Meta για επιχειρήσεις απαγορεύει στους παρόχους AI βοηθών γενικής χρήσης να τους προσφέρουν στην πλατφόρμα WhatsApp Business όταν η AI είναι η κύρια λειτουργία, όπως κρίνει η Meta. Ισχύει από 15 Ιανουαρίου 2026. Μια επιχείρηση που χρησιμοποιεί AI για τους δικούς της πελάτες, για υποστήριξη, πωλήσεις ή κρατήσεις, δεν είναι ο στόχος, και οι ρυθμιστικές αρχές στην ΕΕ και τη Βραζιλία έχουν διατάξει τη Meta να αναστείλει ή να ανακαλέσει τον κανόνα για τους ανταγωνιστικούς βοηθούς.

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

Δημιουργία AI agent για WhatsApp σε Node.js και Python, με αριθμό CoexistenceΚώδικας Node.js και Python για WhatsApp AI agent σε αριθμό Coexistence: έλεγχος υπογραφής, παύση όταν απαντά άνθρωπος, αφαίρεση διπλοτύπων, έλεγχος παραθύρου.Πώς φτάνουν τα μηνύματα WhatsApp στον διακομιστή σας: άμεσα ή διαχειριζόμενα, και επαλήθευση της υπογραφήςΆμεσα: η Meta στέλνει στον διακομιστή σας. Διαχειριζόμενα: αυτοματισμοί και υπογεγραμμένη προώθηση στο Forward URL. Payload, X-EC-Signature και επαναδοκιμές.Επιτρέπονται τα AI chatbots στο WhatsApp το 2026; Ο κανόνας της Meta, η ΕΕ και η ΒραζιλίαΟ όρος 4.7 της Meta αποκλείει τους βοηθούς AI γενικής χρήσης, όχι τις επιχειρήσεις που εξυπηρετούν τους πελάτες τους με AI.WhatsApp connector για Claude: εκτελέστε και αυτοματοποιήστε το WhatsApp από το ClaudeΠροσθέστε το WhatsApp στο Claude ως custom connector στο Customize > Connectors, σε δωρεάν ή επί πληρωμή πλάνα, με εντολές για Claude Code και Codex.Τι σημαίνει να είστε Meta Tech Provider και γιατί έχει σημασίαΈνας Tech Provider συνδέει αριθμούς WhatsApp άλλων επιχειρήσεων μέσω της δικής του εφαρμογής Meta. Τι απαιτεί η κατάσταση και τι αλλάζει για τον πελάτη.Ανεπίσημα WhatsApp API: τι οδηγεί πραγματικά σε αποκλεισμό αριθμώνΟι ανεπίσημες πύλες WhatsApp συνδέονται ως συνδεδεμένη συσκευή και παραβιάζουν τους όρους της Meta. Δείτε το κόστος και την επίσημη λύση.

Έτοιμοι να ξεκινήσετε;

Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.

Ξεκινήστε δωρεάν δοκιμή

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