מדריך לכלי MCP
המחבר חושף יותר מ-30 כלים לכל החיבורים בחשבון. list_numbers מופיע ראשון עבור WhatsApp, שכליו מקבלים ממנו connection_id, ו-list_social_accounts לערוצים האחרים, שכליהם מקבלים account_id. שישה כלים נחסמים כשהחיוב פג: ארבעת כלי ה-WhatsApp שפועלים מול העולם החיצוני, get_api_credentials, שמחזיר את אסימון הגישה, ו-create_connect_link. השאר נשארים פתוחים.
הכלים שהמחבר חושף.
הכלים שנחסמים כשהחיוב פג, כולל get_api_credentials, שמחזיר את אסימון הגישה.
כניסה באמצעות 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.
Partner API, לתוכנה או לסוכנות שהלקוחות שלה מחברים מספרים משלהם: get_partner_setup מציג את מצב החיוב, מפתח ה-API, כתובת ה-URL לאירועים והשלב הבא. create_api_key מנפיק את מפתח ה-Partner API ומציג אותו פעם אחת בלבד, ואינו מחליף מפתח קיים בלי אישור מפורש. revoke_api_key מבטל אותו, גם זה רק אחרי אישור. set_partner_events_url קובע לאן נשלחים אירועי הסטטוס ומחזיר את סוד החתימה פעם אחת. create_connect_link יוצר קישור חיבור מתארח ללקוח אחד, בתוקף לשעה אחת, בדיוק כמו POST /api/v1/connect-sessions.
למה connection_id חשוב?
כי הוא מקשר הוראה למספר מסוים, ועוזר לא יכול לנחש אותו.
כל כלי שפועל על מספר מקבל connection_id, ורק list_numbers מספק אותו. בפועל, עוזר שהתבקש לשלוח הודעה יקרא קודם ל-list_numbers, ולכן הבקשה הראשונה בסשן לרוב איטית יותר מהאחרות.
כך גם חשבון עם כמה מספרים נשאר חד-משמעי. אין מספר ברירת מחדל ואין בחירה משתמעת, לכן הוראה שלא מזהה על איזה מספר מדובר מחייבת שאלה ולא ניחוש.
מה קורה כשהחיוב פג?
שישה כלים נחסמים: send_message, send_template, create_template ו-set_webhook_destination, שפועלים מול העולם החיצוני; get_api_credentials, כי הוא מחזיר את אסימון הגישה של החשבון, שבעזרתו חשבון חסום היה יכול לשלוח ישירות דרך ה-Graph API; ו-create_connect_link, שמחבר מספר חדש. כל שאר פעולות הקריאה נשארות זמינות, וכך גם הגדרת ה-Partner API: get_partner_setup, create_api_key, revoke_api_key ו-set_partner_events_url.
זו החלטה מכוונת, לא תקלה. חשבון שלא יכול לראות למה הוא חסום או לבדוק אם המספרים שלו תקינים נשאר בלי דרך לחזור לפעילות מלבד פנייה לתמיכה. אותן פעולות קריאה הן גם הבסיס לניטור התקינות, ולכן חסימתן הייתה מכבה את הניטור בדיוק כשצריך אותו יותר מכל.
בפועל, חשבון שהחיוב שלו פג עדיין עונה על שאלות לגבי מצבו ועדיין מנוטר. מה שנעצר הוא כל דבר שמגיע ללקוח.
טעויות נפוצות
- לצפות שהמחבר יקבל הודעות. MCP עובד בבקשות ובתגובות; תעבורה נכנסת דורשת וובהוק (Webhook).
- לקבע מראש connection_id. הוא מגיע מ-list_numbers ואינו ערך שצריך לרשום.
- להניח שחשבון שהחיוב שלו פג מנותק לחלוטין. הקריאה והניטור ממשיכים בכוונה, חוץ מפרטי הגישה, שמכילים את האסימון שבו שולחים.
מחבר אחד מכסה את כל המספרים בחשבון, עם הרשאה דרך OAuth וללא מפתח להדבקה. המחיר מתחיל ב-US$ 9 למספר בחודש ויורד עד US$ 0.75 ככל שמוסיפים מספרים, עם 3 ימי ניסיון חינם.
שאלות נפוצות
האם אני בוחר איזה כלי להפעיל?
לא. מתארים את הצורך בשפה פשוטה, והעוזר בוחר את הכלי. לשם כך נכתבו תיאורי הכלים.
האם הוא יכול לקרוא את השיחות שלי?
לא. הודעות נכנסות מנותבות ליעד הוובהוק שאתם מגדירים. המחבר קורא את מצב החשבון והמספרים.
האם get_docs שימושי?
יותר ממה שנדמה. הוא מוסר לעוזר את תיעוד המוצר שלנו בפורמט markdown, כך שהתשובות על כללי Coexistence מגיעות מהתיעוד שלנו ולא מהזיכרון.
האם מחבר אחד מכסה כמה לקוחות?
כן. חשבון אחד יכול להכיל כמה מספרים שצריך, ו-list_numbers מחזיר את כולם.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-