מדריך לכלי MCP
המחבר חושף אחד עשר כלים לכל המספרים בחשבון. list_numbers מופיע ראשון, כי כל כלי אחר מקבל ממנו connection_id. ארבעה כלים פועלים מול העולם החיצוני ונחסמים כשהחיוב פג; שבעת האחרים קוראים מידע ונשארים פתוחים.
הכלים שהמחבר חושף.
הכלים שנחסמים כשהחיוב פג. כל פעולות הקריאה נשארות זמינות.
כניסה באמצעות OAuth, המכסה את כל המספרים בחשבון.
מה עושה כל כלי?
קריאה: list_numbers מחזיר את המספרים המחוברים עם סטטוס, דירוג איכות ורמת הודעות, וממנו מתחילה כל קריאה אחרת. get_number_health מחזיר תמונת מצב עדכנית של Meta יחד עם ציר הזמן האחרון של הניטור, אירועי וובהוק (Webhook) ובדיקות ה-poller. get_api_credentials מחזיר את כתובת הבסיס של Graph API, מזהה WABA, מזהה מספר הטלפון, ואם זמין, את אסימון הגישה (Access Token) של החשבון.
שליחה: send_message שולח טקסט חופשי בתוך חלון של 24 שעות, שבו התשובות חינמיות. send_template שולח תבנית מאושרת, וכך מתחילים שיחה עם מי שעדיין לא כתב. list_templates, create_template ו-get_template_status מכסים את מחזור החיים של התבנית.
חיבור: set_webhook_destination מנתב הודעות נכנסות והדים מהאפליקציה למערכת שלכם, והעברת null מאפסת את ההגדרה. get_connect_link מחזיר קישור ללוח הבקרה ואת השלבים לחיבור מספר חדש. get_docs מחזיר את תיעוד המוצר בפורמט markdown.
למה connection_id חשוב?
כי הוא מקשר הוראה למספר מסוים, ועוזר לא יכול לנחש אותו.
כל כלי שפועל על מספר מקבל connection_id, ורק list_numbers מספק אותו. בפועל, עוזר שהתבקש לשלוח הודעה יקרא קודם ל-list_numbers, ולכן הבקשה הראשונה בסשן לרוב איטית יותר מהאחרות.
כך גם חשבון עם כמה מספרים נשאר חד-משמעי. אין מספר ברירת מחדל ואין בחירה משתמעת, לכן הוראה שלא מזהה על איזה מספר מדובר מחייבת שאלה ולא ניחוש.
מה קורה כשהחיוב פג?
ארבעת הכלים שפועלים מול העולם החיצוני נחסמים: send_message, send_template, create_template ו-set_webhook_destination. כל מה שקורא מידע נשאר זמין.
זו החלטה מכוונת, לא תקלה. חשבון שלא יכול לראות למה הוא חסום או לבדוק אם המספרים שלו תקינים נשאר בלי דרך לחזור לפעילות מלבד פנייה לתמיכה. אותן פעולות קריאה הן גם הבסיס לניטור התקינות, ולכן חסימתן הייתה מכבה את הניטור בדיוק כשצריך אותו יותר מכל.
בפועל, חשבון שהחיוב שלו פג עדיין עונה על שאלות לגבי מצבו ועדיין מנוטר. מה שנעצר הוא כל דבר שמגיע ללקוח.
טעויות נפוצות
- לצפות שהמחבר יקבל הודעות. MCP עובד בבקשות ובתגובות; תעבורה נכנסת דורשת וובהוק (Webhook).
- לקבע מראש connection_id. הוא מגיע מ-list_numbers ואינו ערך שצריך לרשום.
- להניח שחשבון שהחיוב שלו פג מנותק לחלוטין. הקריאה והניטור ממשיכים בכוונה.
מחבר אחד מכסה את כל המספרים בחשבון, עם הרשאה דרך OAuth וללא מפתח להדבקה. המחיר מתחיל ב-US$ 9 למספר בחודש ויורד ל-US$ 2 בכמות גדולה, עם 7 ימי ניסיון חינם.
שאלות נפוצות
האם אני בוחר איזה כלי להפעיל?
לא. מתארים את הצורך בשפה פשוטה, והעוזר בוחר את הכלי. לשם כך נכתבו תיאורי הכלים.
האם הוא יכול לקרוא את השיחות שלי?
לא. הודעות נכנסות מנותבות ליעד הוובהוק שאתם מגדירים. המחבר קורא את מצב החשבון והמספרים.
האם get_docs שימושי?
יותר ממה שנדמה. הוא מוסר לעוזר את תיעוד המוצר שלנו בפורמט markdown, כך שהתשובות על כללי Coexistence מגיעות מהתיעוד שלנו ולא מהזיכרון.
האם מחבר אחד מכסה כמה לקוחות?
כן. חשבון אחד יכול להכיל כמה מספרים שצריך, ו-list_numbers מחזיר את כולם.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-