Φτιάξτε ένα WhatsApp bot με το Claude Code ή το Codex, στον αριθμό που κρατάτε στην εφαρμογή
Προσθέστε έναν WhatsApp MCP server στο Claude Code ή στο Codex και αφήστε τον coding agent να κάνει τη ρύθμιση: διαβάζει τα Cloud API credentials του αριθμού, δημιουργεί έναν webhook receiver, δρομολογεί τα εισερχόμενα μηνύματα σε αυτόν και στέλνει δοκιμαστική απάντηση σε όποιον έγραψε τις τελευταίες 24 ώρες. Αυτό που θα έχετε στο τέλος είναι δικός σας agent, που τρέχει ως δικός σας κώδικας στον δικό σας server.
Το easyCoexistence συνδέει τον αριθμό WhatsApp Business που κρατάτε στην εφαρμογή με το Cloud API της Meta μέσω Coexistence και δίνει στο Claude Code και στο Codex πάνω από 30 εργαλεία MCP για να χτίσετε: credentials, δρομολόγηση, templates, δοκιμαστικές αποστολές και αυτοματισμούς.
Η σημαία του Claude Code που φορτώνει έναν server σε όλα τα έργα σας· η προεπιλεγμένη τοπική εμβέλεια τον φορτώνει μόνο εκεί όπου προστέθηκε.
Η εντολή του Codex που αποθηκεύει τη σύνδεση OAuth ενός server· χωρίς credential, το Codex μπορεί να συνδεθεί χωρίς έλεγχο ταυτότητας.
Τι πρέπει να χρησιμοποιεί ένας άμεσος προορισμός webhook, και πρέπει να επαναλαμβάνει το hub.challenge στη χειραψία GET της Meta.
Πόσο περιμένει το βήμα «Call my webhook» για το {"reply"} του endpoint σας πριν αποτύχει το βήμα.
Το παράθυρο εξυπηρέτησης πελατών μετά το τελευταίο μήνυμα του χρήστη· εκτός αυτού, η Meta δέχεται μόνο πρότυπα μηνυμάτων.
Η σταθερή απόδοση ενός αριθμού που χρησιμοποιείται και με την εφαρμογή WhatsApp Business και με το Cloud API.
Τι χρειάζεται ένας coding agent για να φτιάξει έναν WhatsApp agent;
Τέσσερα πράγματα. Ένας αριθμός WhatsApp Business συνδεδεμένος με το Cloud API της Meta μέσω Coexistence, ώστε η εφαρμογή να μένει στο τηλέφωνο ενώ ο κώδικας μπορεί να στέλνει και να λαμβάνει. Μια σύνδεση MCP από το Claude Code ή το Codex σε αυτόν τον αριθμό, που επιτρέπει στον coding agent να διαβάζει credentials, να αλλάζει τη δρομολόγηση και να στέλνει δοκιμαστικά μηνύματα χωρίς να ανοίξετε τον πίνακα ελέγχου. Μια δημόσια διεύθυνση HTTPS για τον receiver, από έναν host όπου κάνετε deploy ή από ένα tunnel όσο αναπτύσσετε. Και ένα κλειδί μοντέλου για τον agent που φτιάχνετε.
Κρατήστε τους δύο agents χωριστά στο μυαλό σας. Το Claude Code ή το Codex είναι ο δημιουργός: ενεργεί μόνο όσο δουλεύετε μαζί του στο τερματικό. Το πρόγραμμα που γράφει είναι αυτό που απαντά στους πελάτες, και συνεχίζει να τρέχει αφού κλείσετε τη συνεδρία.
Πώς προσθέτετε τα εργαλεία WhatsApp στο Claude Code και στο Codex;
Το καθένα παίρνει ένα URL από το τερματικό και συνδέεται με OAuth, οπότε κανένα κλειδί δεν μπαίνει σε αρχείο. Στο Claude Code, προσθέστε τον server με --scope user ώστε να φορτώνεται σε κάθε έργο, μετά εκτελέστε claude, τρέξτε /mcp, επιλέξτε easycoexistence και συνδεθείτε στο πρόγραμμα περιήγησης. Στο Codex, προσθέστε τον server και τρέξτε codex mcp login, που αποθηκεύει τη σύνδεση· η codex mcp list δείχνει τι είναι ρυθμισμένο. Το Codex κρατά την εγγραφή στο ~/.codex/config.toml, το οποίο διαβάζουν και η εφαρμογή ChatGPT για desktop και η επέκταση Codex IDE.
Ελέγξτε ότι λειτούργησε ζητώντας κάτι που μόνο τα εργαλεία μπορούν να απαντήσουν, όπως «δείξε μου τους αριθμούς WhatsApp μου». Ο agent καλεί το list_numbers και παίρνει το connection_id κάθε αριθμού, το οποίο χρησιμοποιούν όλα τα άλλα εργαλεία.
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp
# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp listΠοια διαδρομή πρέπει να χτίσει ο agent;
Τρεις διαδρομές φέρνουν το μήνυμα ενός πελάτη στον κώδικά σας, και διαφέρουν στο πόσα πρέπει να χειριστεί ο κώδικας. Για μια πρώτη έκδοση, το βήμα «Call my webhook» είναι το συντομότερο: το easyCoexistence παραλείπει τα διπλότυπα, κάνει πίσω όταν απαντάτε από το τηλέφωνο και ελέγχει το παράθυρο 24 ωρών πριν καλέσει το endpoint σας, ώστε ο κώδικάς σας γράφει μόνο την απάντηση. Περάστε σε Forward URL ή σε άμεσο προορισμό όταν ο agent χρειάζεται κάθε συμβάν, και όχι μόνο τα μηνύματα που επιλέγει ένας αυτοματισμός.
Τι πρέπει να ζητήσετε από τον coding agent;
Δώστε του τη διαδρομή, τη γλώσσα και τους κανόνες από την αρχή, και ζητήστε ένα σχέδιο πριν γράψει κώδικα. Πείτε του ποιες κλήσεις εργαλείων μπορεί να κάνει μόνος του: η ανάγνωση credentials και τεκμηρίωσης είναι ακίνδυνη, ενώ η αλλαγή του προορισμού των μηνυμάτων επηρεάζει τον ζωντανό αριθμό. Το get_docs επιστρέφει την τεκμηρίωση του easyCoexistence, συμπεριλαμβανομένου του τρόπου με τον οποίο ένας receiver πιστοποιεί τις παραδόσεις, ώστε ο agent να διαβάζει τους κανόνες αντί να τους μαντεύει. Ένα αίτημα σαν αυτό παράγει έναν receiver που μπορείτε να ελέγξετε μέσα σε μία συνεδρία:
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
Skip message ids already handled.
On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.Πώς συνδέετε τον receiver και τον δοκιμάζετε;
Ξεκινήστε τον server εκεί όπου η Meta και το easyCoexistence μπορούν να τον φτάσουν μέσω HTTPS, και μετά αφήστε τον agent να κάνει τη δρομολόγηση. Για τη διαδρομή Forward URL, καλεί το set_inbound_mode με το URL σας σε έναν αριθμό με το Automations ενεργό· το forward secret επιστρέφει μία φορά και ο agent το γράφει στο .env σας. Για την άμεση διαδρομή, το endpoint πρέπει πρώτα να απαντά στη χειραψία GET της Meta, και μετά ο agent καλεί το set_webhook_destination με το URL, ένα μακρύ τυχαίο μυστικό στη διαδρομή του και το verify token σας.
Για δοκιμή, στείλτε μήνυμα στον επιχειρηματικό αριθμό από το δικό σας τηλέφωνο και παρακολουθήστε τα logs: ο receiver πρέπει να δει το συμβάν, το μοντέλο να απαντήσει και η απάντηση να εμφανιστεί στη συνομιλία. Επειδή μόλις γράψατε, το παράθυρο 24 ωρών είναι ανοιχτό, οπότε ο coding agent μπορεί να δοκιμάσει και το send_message στον δικό σας αριθμό.
Χρειάζεται ακόμα ο τελικός agent τον MCP server;
Όχι. Ο MCP server είναι το εργαλείο του δημιουργού, συνδεδεμένο ως εσείς. Ο agent που κάνετε deploy στέλνει μέσω του Graph API της Meta με το send_endpoint και το access_token που επέστρεψε το get_api_credentials, δηλαδή το δικό του token της επιχείρησης, περιορισμένο στα WhatsApp assets της, και λαμβάνει από τη διαδρομή που ρυθμίσατε. Αν το access_token επιστρέψει null, η επανασύνδεση του αριθμού από τον πίνακα ελέγχου εκδίδει ένα νέο, χωρίς να αντικαθιστά token που ήδη λειτουργεί.
Κρατήστε τη σύνδεση MCP για τη δουλειά γύρω από τον agent: δημιουργία προτύπων με το create_template, έλεγχο με το get_number_health όταν κάτι φαίνεται λάθος, και ανάγνωση του run log κάθε αυτοματισμού που παραδίδει μηνύματα στον κώδικά σας.
Πώς να το ρυθμίσετε
- Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
- Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
- Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
- Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
- Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
- Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.
Συνηθισμένα λάθη
- Η αποθήκευση ενός προσωρινού tunnel ως άμεσου προορισμού τις πρώτες 24 ώρες. Η εφάπαξ εισαγωγή επαφών και έως 6 μηνών συνομιλιών από τη Meta στέλνεται σε αυτό το URL και χάνεται όταν κλείσει το tunnel
- Ορισμός άμεσου προορισμού σε αριθμό που τρέχει αυτοματισμούς. Ο αριθμός περνά σε άμεση λειτουργία και οι αυτοματισμοί του σταματούν· χρησιμοποιήστε Forward URL με το Automations ενεργό, για να κρατήσετε και τα δύο
- Το commit του .env που έγραψε ο agent. Προσθέστε το στο .gitignore πρώτα, επειδή όποιος κρατά το access token μπορεί να στέλνει μηνύματα σε πελάτες ως η επιχείρηση
- Δοκιμή του send_message σε επαφή που δεν έχει γράψει τις τελευταίες 24 ώρες. Η Meta αρνείται ελεύθερο κείμενο εκτός του παραθύρου, οπότε στείλτε πρώτα μήνυμα στον αριθμό από το δικό σας τηλέφωνο
Ο agent σας τρέχει έπειτα στον δικό σας server, και κάθε αριθμός παρακολουθείται 24/7 με ειδοποιήσεις. Από US$ 9 έως US$ 0,75 ανά αριθμό τον μήνα, μειούμενη καθώς προσθέτετε αριθμούς, με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Λειτουργεί αυτό στο Cursor ή σε άλλα εργαλεία προγραμματισμού;
Ναι. Κάθε εφαρμογή που συνδέεται σε απομακρυσμένους servers μέσω Streamable HTTP με OAuth μπορεί να χρησιμοποιήσει το ίδιο URL, συμπεριλαμβανομένων των Cursor, VS Code, Gemini CLI και Antigravity. Αλλάζει μόνο η μορφή ρύθμισης ανά εφαρμογή.
Σε ποια γλώσσα πρέπει να γράψει ο agent;
Σε οποιαδήποτε γλώσσα μπορεί να σερβίρει HTTPS και να υπολογίζει HMAC-SHA256. Το Node.js και η Python είναι οι συνήθεις επιλογές, και δοκιμασμένα δείγματα για τις δύο, με ελέγχους υπογραφής, διαχείριση διπλοτύπων και την παύση όταν απαντάτε από το τηλέφωνο, βρίσκονται στη σελίδα του agent για Node.js και Python.
Χρειάζομαι δική μου εφαρμογή Meta ή έλεγχο App Review;
Όχι. Ο αριθμός εντάσσεται στο Cloud API μέσω της εφαρμογής Meta του easyCoexistence και παραμένει στο Business Portfolio της επιχείρησης. Το token με το οποίο στέλνει ο κώδικάς σας είναι του ίδιου της επιχείρησης, οπότε καμία δική σας εφαρμογή Meta δεν εμπλέκεται.
Μπορεί ο coding agent να δημιουργήσει τα templates που χρειάζεται ο agent σας;
Ναι, με το create_template, και μετά με το get_template_status μέχρι να απαντήσει η Meta, συνήθως μέσα σε λίγα λεπτά και το πολύ περίπου 24 ώρες. Ο agent σας χρειάζεται εγκεκριμένο template για να ξεκινήσει μια συνομιλία ή για να γράψει μετά το κλείσιμο του παραθύρου 24 ωρών.
Συνεχίστε την ανάγνωση
Έτοιμοι να ξεκινήσετε;
Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.
Ξεκινήστε δωρεάν δοκιμήΕπαληθεύτηκε στις