WhatsApp API לסוכני AI: גישה רשמית תוך דקות, בלי להפוך ל-Tech Provider
סוכן AI מקבל גישה רשמית ל-WhatsApp דרך ה-Cloud API של Meta. מספר שממשיך לפעול ב-WhatsApp Business מצטרף אליו דרך Tech Provider או Solution Partner. אפשר להפוך לאחד מהם, עם אימות עסק, סרטוני App Review ובנייה של Embedded Signup, או להתחבר דרך ספק שכבר הוא כזה: המספר מצטרף תוך דקות, והסוכן מקבל כלי MCP או פרטי גישה ל-API.
easyCoexistence הוא Meta Tech Provider עצמאי: הוא מחבר מספר WhatsApp Business ל-Cloud API דרך Coexistence תוך דקות, כך שהסוכן מקבל גישה רשמית והעסק ממשיך להשתמש באפליקציה.
מה Meta דורשת ממי שמצרף מספר שנשאר ב-WhatsApp Business: סטטוס של Tech Provider או Solution Partner.
App Review מבקש סרטון אחד של שליחת הודעה מהאפליקציה שלכם, וסרטון אחד של יצירת תבנית באפליקציה.
מה ש-App Review מעניק עבור whatsapp_business_messaging ועבור whatsapp_business_management, שתיהן נדרשות כדי להפוך ל-Tech Provider.
כש-Meta הוציאה משימוש את גרסאות v2 ו-v3 של Embedded Signup, וביקשה מאינטגרציות לעבור ל-v4.
התפוקה הקבועה של מספר שבשימוש גם ב-WhatsApp Business וגם ב-Cloud API.
כמה זמן נשאר בתוקף קישור החיבור המתארח כשפלטפורמה מצרפת את המספר של לקוח דרך ה-Partner API.
מה סוכן AI צריך כדי להשתמש ב-WhatsApp באופן רשמי?
ארבעה דברים מה-Cloud API של Meta. מזהה המספר (phone_number_id) ואסימון גישה עם ההרשאה whatsapp_business_messaging, כדי שהסוכן יוכל לקרוא לנקודת הקצה של ההודעות. נקודת הקצה של וובהוק שאליה Meta שולחת הודעות נכנסות, וגם, במספר שמשותף עם האפליקציה, smb_message_echoes עבור התשובות שאדם מקליד בטלפון. תבניות מאושרות, כי הודעה שנכתבה ידנית מגיעה רק למי שכתב בתוך 24 השעות האחרונות. ודרך לדעת מתי החיבור נשבר, שכן האפליקציה בטלפון ממשיכה לעבוד גם כשצד ה-API מפסיק.
הקיצור שאנשים מוצאים קודם הוא אוטומציה של WhatsApp Web, שנכנסת כמכשיר מקושר. זה מפר את התנאים של WhatsApp ומסכן את המספר בחסימה, מה שלא משנה מה הסוכן שמעליו עושה.
מה כרוך במסלול Tech Provider?
הרצף של Meta עצמה, בסדר הזה. כל שלב בחינם, ואי אפשר לקנות אותו מהר יותר: הבדיקות מתנהלות לפי לוח הזמנים של Meta, ו-Meta לא מפרסמת לוח זמנים, לכן תכננו שבועות ולא ימים לפני שהמספר הראשון של לקוח מתחבר. אחר כך צד השרת חייב להמשיך לפעול: החלפת האסימון אחרי כל הרשמה, מקבל וובהוקים, ניתוב לכל מספר, וניטור לניתוקים, כמו כלל חוסר הפעילות של 14 ימים של Meta.
מה המסלול הקצר יותר?
מחברים את המספר דרך ספק שכבר עבר את התהליך הזה. עם easyCoexistence, העסק מפעיל את Embedded Signup של Meta וסורק קוד עם אפליקציית WhatsApp Business, מה שלוקח כשתי דקות, והמספר מצטרף ל-Cloud API ב-Business Portfolio של העסק עצמו, בעוד האפליקציה ממשיכה לעבוד. אחר כך הסוכן מקבל גישה בצורה שהוא מדבר: כלי MCP לעוזר כמו ChatGPT, Claude, Claude Code או Codex, או פרטי הגישה והוובהוקים של המספר לקוד שאתם מריצים.
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
איך הסוכן מקבל את פרטי הגישה של המספר?
דרך get_api_credentials, או מדף המספר בלוח הבקרה. הכלי מחזיר את כתובת הבסיס של ה-Graph API, מזהה חשבון WhatsApp Business, מזהה המספר (phone_number_id), נקודת הקצה לשליחה, ואת אסימון הגישה של העסק כשקיים, מוגבל לנכסי ה-WhatsApp שלו. כשלא הונפק אסימון לקוח, האסימון חוזר עם הערך null והערה שחיבור מחדש של המספר מלוח הבקרה יוצר אחד, בלי להחליף אסימון שעובד. אין סוד אפליקציה לשלוף, כי Meta חותמת על הוובהוקים עם סוד האפליקציה של easyCoexistence, שלא משותף לאף אחד. הכלי דורש תוכנית פעילה, כי האסימון יכול לשלוח.
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." }
}'איך הודעות נכנסות מגיעות לסוכן?
לכל מספר יש שני מצבים, שמחליפים עם set_inbound_mode או בדף המספר. ישירות לשרת שלכם: set_webhook_destination מכוון את Meta ישירות לנקודת הקצה ב-HTTPS שלכם, שחייבת לענות לבדיקת ה-GET של Meta, ו-easyCoexistence לעולם לא רואה את ההודעות, לכן האוטומציות כבויות. מכיוון ש-Meta חותמת על המשלוחים האלה עם סוד האפליקציה שלנו, שימו סוד אקראי ארוך בנתיב ה-URL, ודחו בקשות שאין בהן אותו.
אוטומציות מופעלות: Meta שולחת ל-easyCoexistence, האוטומציות יכולות לענות, וכתובת ההעברה (Forward URL) האופציונלית מקבלת את ה-payload המקורי של Meta תחת "value", עם כותרת X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 של "<t>.<body>"> באמצעות סוד שמוצג פעם אחת. הצעד של קריאה לוובהוק באוטומציה מעביר גם הוא לסוכן שלכם את ההודעה ואת 10 ההודעות האחרונות של השיחה, ושולח את התשובה שלו כשהתשובה היא {"reply": "..."} בתוך 20 שניות.
אילו מגבלות הסוכן צריך לכבד?
של Meta, והן זהות דרך כל ספק. סוכן שמכיר אותן מראש נמנע מהכשלים שנראים כמו באגים:
- 20 הודעות בשנייה לכל מספר, שנקבעו על ידי Meta למספרים משותפים עם אפליקציית WhatsApp Business.
- הודעות בטקסט חופשי רק בתוך 24 השעות מההודעה האחרונה של הלקוח; אחרי זה, תבנית מאושרת.
- תבניות נשלחות רק דרך ה-API, כי האפליקציה במספר Coexistence לא יכולה לשלוח אותן.
- תשובות שאדם מקליד באפליקציה מגיעות בתור
smb_message_echoes; השהו את הסוכן בשיחה הזו, אחרת הלקוח יקבל שתי תשובות. - שיחות קבוצתיות לא מסונכרנות ל-API, ולכן הסוכן עובד בשיחות אחד-על-אחד.
- אנשי קשר ועד 6 חודשים של שיחות אחד-על-אחד מיובאים פעם אחת, ורק אם יעד וובהוק ישיר נשמר תוך 24 שעות מהחיבור; מספר עם אוטומציות מופעלות לא מקבל את הייבוא.
- שיחות קוליות ווידאו ממשיכות לעבוד באפליקציה, אבל ה-Cloud API לא נושא שיחות במספר Coexistence, ולכן הסוכן עובד בטקסט.
האם פלטפורמה יכולה לחבר ככה את המספרים של הלקוחות שלה?
כן, דרך Partner API, וכך SaaS או סוכנות מצרפים לקוחות בלי סטטוס Tech Provider משלהם. יוצרים מפתח עם create_api_key (הוא מתחיל בתחילית ec_live_ ומוצג פעם אחת), ואז קוראים ל-POST /api/v1/connect-sessions מהשרת שלכם, או ל-create_connect_link מהעוזר, כדי לקבל קישור מתארח התקף שעה אחת. הלקוח מפעיל שם את החלון הקופץ של Meta וסריקת ה-QR, וחוזר לכתובת redirect_url שלכם עם connection_id. GET /api/v1/connections/:id?credentials=1 מחזיר אז את האסימון של הלקוח, ואירועי סטטוס כמו connection.disconnected מגיעים חתומים עם X-EC-Signature. כל מספר מחויב לחשבון שלכם לפי אותן מדרגות למספר.
טעויות נפוצות
- אימות X-Hub-Signature-256 ביעד ישיר. Meta חותמת עם סוד האפליקציה של easyCoexistence, שלא משותף, ולכן משלוחים אמיתיים נכשלים בבדיקה; סמכו על סוד אקראי ארוך בכתובת ה-URL, או השתמשו בהעברה עם X-EC-Signature.
- קבלה עם צומת WhatsApp Trigger של n8n. הוא מצפה לאפליקציית Meta משלכם; השתמשו בצומת Webhook הכללי עם סוד בכתובת ה-URL שלו במקום.
- התעלמות מהודעות smb_message_echoes. הסוכן עונה אז על גבי אדם שכבר ענה מהטלפון, והלקוח קורא שתי תשובות.
- שמירת יעד ישיר לוובהוק ימים אחרי החיבור, או השארת המספר באוטומציות. הייבוא החד-פעמי של Meta לאנשי קשר ועד 6 חודשי שיחות דורש יעד ישיר שנשמר תוך 24 שעות מהחיבור.
הסוכן עובד דרך יותר מ-30 כלי MCP או דרך פרטי הגישה והוובהוקים של כל מספר, וכל מספר מנוטר 24/7 עם התראות. US$ 9 עד US$ 0.75 לכל מספר בחודש, יורד ככל שמוסיפים מספרים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
צריך אפליקציית Meta משלי?
לא. המספר מצורף דרך אפליקציית Meta של easyCoexistence ונשאר ב-Business Portfolio ובחשבון WhatsApp Business של העסק. הקוד שלכם שולח עם האסימון של העסק מ-get_api_credentials, כך שלא מעורבת שום אפליקציה שלכם, אלא אם תבנו אחת בהמשך.
האם הסוכן והצוות יכולים להשתמש במספר בו זמנית?
כן. Meta משקפת הודעות בין Cloud API לאפליקציית WhatsApp Business, כך שמה שהסוכן שולח מופיע בשרשור השיחה באפליקציה בטלפון, ומה שהצוות מקליד באפליקציה מגיע למערכת שלכם בתור smb_message_echoes.
אילו מסגרות סוכן עובדות איתו?
כל לקוח שמדבר 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 עצמה, כך שאין שום דבר קנייני בתוך הסוכן.
האם עוזר AI כללי מותר ב-WhatsApp?
סעיף 4.7 בתנאי הפלטפורמה העסקית של Meta, Business Solution Terms, אוסר על ספקי עוזרי AI כלליים להציע אותם בפלטפורמה העסקית של WhatsApp כאשר ה-AI הוא הפונקציונליות העיקרית, כפי ש-Meta קובעת, ונכנס לתוקף ב-15 בינואר 2026. עסק שמשתמש ב-AI ללקוחות שלו, לתמיכה, מכירות או הזמנות, אינו היעד, ורגולטורים באיחוד האירופי ובברזיל הורו ל-Meta להשעות או לבטל את הכלל עבור עוזרים מתחרים.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-