בנו בוט WhatsApp עם Claude Code או Codex, על המספר שאתם שומרים באפליקציה
הוסיפו שרת MCP של WhatsApp ל-Claude Code או ל-Codex, ותנו לסוכן הקוד לבצע את ההקמה: הוא קורא את פרטי ה-Cloud API של המספר, מקים מקלט וובהוק (Webhook), מנתב אליו הודעות נכנסות ושולח הודעת בדיקה למי שכתב ב-24 השעות האחרונות. מה שנשאר לכם הוא סוכן משלכם, שפועל כקוד שלכם על השרת שלכם.
easyCoexistence מחברת את מספר ה-WhatsApp Business שאתם שומרים באפליקציה ל-Cloud API של Meta דרך Coexistence, ונותנת ל-Claude Code ול-Codex יותר מ-30 כלי MCP לבנייה: פרטי גישה, ניתוב, תבניות, שליחות בדיקה ואוטומציות.
דגל של Claude Code שטוען שרת בכל הפרויקטים שלכם; ברירת המחדל, טווח מקומי, טוענת אותו רק במקום שבו נוסף.
פקודה של Codex ששומרת את כניסת ה-OAuth של שרת; בלי אישור, Codex יכול להתחבר ללא אימות.
מה יעד וובהוק ישיר חייב להשתמש בו, ומה עליו להחזיר ב-GET של Meta: את hub.challenge כמו שהוא.
כמה זמן שלב הקריאה לנקודת הקצה שלי ממתין לתשובה {"reply"} מנקודת הקצה שלכם לפני שהשלב נכשל.
חלון שירות הלקוחות שנפתח אחרי ההודעה האחרונה של המשתמש; מחוץ לו Meta מקבלת רק הודעות תבנית.
תפוקה קבועה למספר שמשמש גם ב-WhatsApp Business app וגם ב-Cloud API במקביל.
מה סוכן קוד צריך כדי לבנות סוכן WhatsApp?
ארבעה דברים. מספר WhatsApp Business המחובר ל-Cloud API של Meta דרך Coexistence, כך שהאפליקציה נשארת בטלפון והקוד יכול לשלוח ולקבל. חיבור MCP מ-Claude Code או מ-Codex למספר הזה, שמאפשר לסוכן הקוד לקרוא פרטי גישה, לשנות ניתוב ולשלוח הודעות בדיקה בלי שתפתחו לוח בקרה. כתובת HTTPS ציבורית למקלט, משרת שאליו אתם מפרסמים או מנהרה בזמן הפיתוח. ומפתח מודל לסוכן שאתם בונים.
שימו לב להבדל בין שני הסוכנים. Claude Code או Codex הם הבונה: הוא פועל רק כשאתם עובדים איתו בטרמינל. התוכנית שהוא כותב היא זו שעונה ללקוחות, והיא ממשיכה לרוץ גם אחרי שסגרתם את הסשן.
איך מוסיפים את כלי WhatsApp ל-Claude Code ול-Codex?
בכל אחד מהם מוסיפים את כתובת ה-URL מהטרמינל ומתחברים עם OAuth, כך שאף מפתח לא נשמר בקובץ. ב-Claude Code מוסיפים את השרת עם --scope user כדי שייטען בכל פרויקט, מפעילים את claude, מריצים /mcp, בוחרים את easycoexistence ומתחברים בדפדפן. ב-Codex מוסיפים את השרת ומריצים codex mcp login, שמאחסן את הכניסה; codex mcp list מציג את מה שמוגדר. Codex שומר את הרשומה בקובץ ~/.codex/config.toml, שגם אפליקציית שולחן העבודה של ChatGPT ותוסף ה-Codex ל-IDE קוראים.
לבדיקה, בקשו משהו שרק הכלים יכולים לענות עליו, כמו "הציגו את מספרי ה-WhatsApp שלי". הסוכן קורא ל-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באיזה ניתוב הסוכן צריך לבנות?
שלושה ניתובים מביאים הודעה של לקוח לקוד שלכם, והם נבדלים בכמות העבודה שהקוד צריך לטפל בה. לגרסה הראשונה, שלב הקריאה לנקודת הקצה שלי הוא הקצר ביותר: easyCoexistence מדלגת על כפילויות, משהה את עצמה כשאתם עונים מהטלפון ובודקת את חלון ה-24 שעות לפני שנקודת הקצה נקראת, כך שהקוד שלכם רק כותב את התשובה. עברו ל-Forward URL או ליעד ישיר כשהסוכן צריך כל אירוע, לא רק את ההודעות שאוטומציה בוחרת.
מה כדאי לבקש מסוכן הקוד לעשות?
תנו לו את הניתוב, השפה והכללים מראש, ובקשו תוכנית לפני שהוא כותב קוד. ציינו אילו קריאות לכלים הוא רשאי לבצע לבד: קריאת פרטי גישה ותיעוד לא מזיקה, אבל שינוי כתובת היעד של ההודעות משפיע על המספר החי. get_docs מחזיר את התיעוד של easyCoexistence, כולל איך מקלט מאמת משלוחים, כך שהסוכן יקרא את הכללים במקום לנחש אותם. בקשה כזו מניבה מקלט שאפשר לבדוק בישיבה אחת:
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.איך מחברים את המקלט ובודקים אותו?
הפעילו את השרת במקום ש-Meta ו-easyCoexistence יכולים להגיע אליו דרך HTTPS, ואז תנו לסוכן לבצע את הניתוב. בניתוב Forward URL הוא קורא ל-set_inbound_mode עם הכתובת שלכם על מספר ב-Automations במצב on; סוד ההעברה חוזר פעם אחת, והסוכן כותב אותו ל-.env שלכם. בניתוב הישיר נקודת הקצה צריכה להשיב קודם ללחיצת היד (GET handshake) של Meta, ורק אז הסוכן קורא ל-set_webhook_destination עם הכתובת, סוד ארוך ואקראי בנתיב שלה ואסימון האימות (verify token) שלכם.
כדי לבדוק, שלחו הודעה למספר העסקי מהטלפון שלכם ועקבו אחרי הלוגים: המקלט אמור לראות את האירוע, המודל אמור לענות, והתשובה אמורה להופיע בצ'אט. מכיוון שרק כתבתם, חלון ה-24 השעות פתוח, ולכן סוכן הקוד יכול לנסות גם send_message למספר שלכם.
האם הסוכן שנבנה עדיין צריך את שרת ה-MCP?
לא. שרת ה-MCP הוא הכלי של הבונה, והוא מחובר בשמכם. הסוכן שאתם מפרסמים שולח דרך Graph API של Meta עם send_endpoint ו-access_token שחזרו מ-get_api_credentials, האסימון של העסק עצמו שמוגבל לנכסי WhatsApp שלו, ומקבל דרך הניתוב שהגדרתם. אם access_token חזר כ-null, חיבור מחדש של המספר מלוח הבקרה מנפיק אחד בלי להחליף אסימון שכבר עובד.
שמרו את חיבור ה-MCP לעבודה סביב הסוכן: יצירת תבניות עם create_template, בדיקת get_number_health כשמשהו נראה לא תקין, וקריאת יומן הריצה של כל אוטומציה שמעבירה הודעות לקוד שלכם.
איך מגדירים
- 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.
טעויות נפוצות
- שמירת מנהרה זמנית כיעד ישיר ב-24 השעות הראשונות. ייבוא חד-פעמי של Meta של אנשי קשר ועד 6 חודשי צ'אטים נשלח לכתובת הזו ואובד כשהמנהרה נסגרת.
- הגדרת יעד ישיר על מספר שמריץ אוטומציות. המספר עובר למצב ישיר והאוטומציות שלו נעצרות; השתמשו ב-Forward URL באוטומציות במצב on כדי לשמור על שניהם.
- העלאה ל-git של קובץ ה-.env שהסוכן כתב. הוסיפו אותו קודם ל-.gitignore, כי כל מי שמחזיק באסימון הגישה יכול לשלוח הודעות ללקוחות בשם העסק.
- בדיקת send_message לאיש קשר שלא כתב ב-24 השעות האחרונות. Meta דוחה טקסט חופשי מחוץ לחלון, ולכן שלחו קודם הודעה למספר מהטלפון שלכם.
הסוכן שלכם רץ אחר כך על השרת שלכם, וכל מספר נבדק 24/7 עם התראות. US$ 9 עד US$ 0.75 לכל מספר בחודש, יורד ככל שמוסיפים מספרים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם זה עובד ב-Cursor או בכלי קוד אחרים?
כן. כל לקוח MCP שמתחבר לשרתים מרוחקים דרך Streamable HTTP עם OAuth יכול להשתמש באותה כתובת, כולל Cursor, VS Code, Gemini CLI ו-Antigravity. רק פורמט ההגדרה משתנה מלקוח ללקוח.
באיזו שפה הסוכן צריך לכתוב?
בכל שפה שיכולה לשרת HTTPS ולחשב HMAC-SHA256. Node.js ו-Python הן הבחירות הנפוצות, ודוגמאות בדוקות לשתיהן, עם בדיקות חתימה, טיפול בכפילויות והשהיית הטלפון, נמצאות בעמוד הסוכנים ל-Node.js ול-Python באתר.
האם צריך אפליקציית Meta משלי ואישור App Review מראש?
לא. המספר מצטרף ל-Cloud API דרך אפליקציית Meta של easyCoexistence ונשאר ב-Business Portfolio של העסק עצמו. האסימון שהקוד שלכם שולח איתו שייך לעסק, ולכן אפליקציית Meta משלכם לא מעורבת בכלל.
האם סוכן הקוד יכול ליצור את התבניות שהסוכן צריך?
כן, עם create_template, ואז get_template_status עד ש-Meta עונה, בדרך כלל בתוך דקות ולכל היותר בערך 24 שעות. הסוכן שלכם צריך תבנית מאושרת כדי להתחיל שיחה או כדי לכתוב אחרי שחלון ה-24 השעות נסגר.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-