# הוואטסאפ של המשתמשים שלכם, בתוך סוכן של Composio

> Composio נותן לסוכן יותר מ-1,500 כלים דרך session אחד. Circles מוסיף לו את הוואטסאפ של האדם עצמו, כ-toolkit מסוג Custom MCP: השיחות שהוא פותח, מוכנות לקריאה, ולכתיבה איפה שהוא מרשה.

**איך נותנים לסוכן של Composio וואטסאפ אישי:** יוצרים toolkit מסוג Custom MCP עם הכתובת `https://app.usecircles.app/api/mcp` והכותרת `Authorization: Bearer {{generic_api_key}}`, וכל משתמש מתחבר עם המפתח שלו מ-Circles. מעכשיו הסוכן קורא את השיחות שאותו משתמש פתח ב-Circles: Free ל-2 שיחות עד 3 חודשים מהחיבור, Plus ב-₪39 ו-Pro ב-₪79 לחודש לכל מספר, 14 ימים של Pro בחינם, נכון לנובמבר 2026.

מקור: https://usecircles.app/agents/composio · עודכן 2026-11-01

## ה-toolkit של Composio לוואטסאפ, או Circles?

ה-toolkit של Composio לוואטסאפ עובד דרך WhatsApp Business API, והעמוד שלו אומר שהוא לא תומך בחשבונות אישיים (נכון לנובמבר 2026). הוא הבחירה הנכונה למספר עסקי: תבניות, הודעות ללקוחות בהיקף גדול, ה-API הרשמי. Circles מיועד למספר האישי: הקבוצות, שיחות המשפחה וההודעות הקוליות בטלפון שכבר בשימוש, שיחה אחר שיחה, לסוכן של האדם.

## ארבעה צעדים: שניים לכל משתמש, שניים לכם

1. **כל משתמש מקשר את הוואטסאפ שלו ב-Circles**: המשתמש מתחיל ניסיון ב-usecircles.app ומקשר את המספר כמכשיר מקושר: קוד שמקלידים בטלפון, או QR שסורקים במחשב. הוא בוחר אילו שיחות הסוכנים יכולים לקרוא, ובאילו גם לשלוח.
2. **הוא יוצר מפתח**: בעמוד הסוכנים ב-Circles: *New token*, בוחרים Other, משאירים MCP ובוחרים מה המפתח מאפשר. המפתח מתחיל ב-`circ_` ומוצג פעם אחת.
3. **אתם מוסיפים את Circles כ-Custom MCP, פעם אחת**: בפרויקט שלכם ב-Composio יוצרים toolkit עם הכתובת של Circles והכותרת `Authorization: Bearer {{generic_api_key}}`, משותף עם `user_id="all"`. Composio ממלא את המפתח של כל משתמש כשהוא פונה ל-Circles.
4. **כל משתמש מתחבר, והסוכן שואל**: Composio מבקש מכל משתמש את המפתח שלו דרך קישור החיבור, והכלים מסתנכרנים בחיבור הראשון. מוסיפים את ה-slug של ה-toolkit ל-session, והסוכן מוצא את הכלים עם `COMPOSIO_SEARCH_TOOLS`.

## הקוד

Python, עם ה-SDK של Composio. ב-TypeScript אותן קריאות נמצאות תחת `composio.experimental.customToolkits`.

את `mcp_url` כותבים בדיוק כמו הכתובת, בלי מפתח בתוכה. Composio מקבע בזמן היצירה את הכתובת, את שיטת האימות ואת `user_id`, ולכן כדי לשנות אחד מהם מוחקים את ה-toolkit ויוצרים אותו מחדש. כש-Circles מוסיף כלי, מסנכרנים את ה-toolkit שוב.

```
from composio import Composio

composio = Composio()  # reads COMPOSIO_API_KEY

# Once per project: Circles as a shared Custom MCP toolkit
toolkit = composio.experimental.custom_toolkits.create(
    name="Circles (personal WhatsApp)",
    mcp_url="https://app.usecircles.app/api/mcp",
    auth_schemes=[{
        "mode": "API_KEY",
        "headers": {"Authorization": "Bearer {{generic_api_key}}"},
    }],
    user_id="all",
)
print(toolkit.slug)  # keep it: CUSTOM_CIRCLES...

# Per user: a session with Circles beside your other toolkits
session = composio.sessions.create(user_id="user_123", toolkits=[toolkit.slug])
tools = session.tools()
```

## התחברות לפי כתובת במקום מפתח

ה-Custom MCP של Composio מקבל גם OAuth עם רישום דינמי של לקוח: `"mode": "DCR_OAUTH"` עם `"discovery_url": "https://app.usecircles.app/.well-known/oauth-authorization-server"`. Circles רושם לקוחות בדרך הזו, וכל אדם מאשר בעמוד של Circles ובוחר אם הסוכן יכול לשלוח. את השילוב הזה עוד לא ניסינו, אז בינתיים מתחברים עם מפתח.

## מה המשתמשים יכולים לשאול

דוגמאות מומצאות, בצורות אמיתיות.

- **"מה פספסתי בקבוצת ועד הבית?"**: `catch_up` על קבוצה אחת מאז זמן מסוים, הודעות קוליות כבר כטקסט.
- **"תכניס ליומן את התאריכים מקבוצת בית הספר"**: Circles קורא את הקבוצה, וה-toolkit של Google Calendar כותב את האירועים.
- **"תמצא את החשבונית שרואה החשבון שלח ותשמור אותה ב-Drive"**: `documents` מוצא אותה, `get_media` מביא אותה, ו-toolkit אחר שומר.
- **"תגיד לקבוצת הריצה שאני לא מגיע ביום חמישי"**: רק אם המפתח מאפשר שליחה והקבוצה פתוחה לשליחה.

## מה סוכן של Composio יכול ולא יכול לעשות כאן

**מה הסוכן יכול לעשות:**

- לראות אילו שיחות פתחתם, ובאילו מהן היה משהו חדש מאז זמן מסוים, במספרים בלבד (`allowed_chats`, `activity`).
- להתעדכן ולחפש, בשיחה אחת או בכולן, עם שמות השולחים והודעות קוליות שכבר תומללו (`catch_up`, `search`).
- לראות עם מי אתם מדברים ומי חבר בקבוצה, לפי השם בלבד (`people`, `group_members`).
- לראות את המסמכים שנשלחו בשיחות ולפתוח תמונה, PDF או קובץ, עד 50 MB (`documents`, `get_media`). Circles מעביר את הקובץ, ו-הסוכן קורא אותו בעצמו.
- לשלוח הודעה או קובץ בשיחות הפתוחות לשליחה, ובמספר חדש אלה כל השיחות (`send`).

**מה הסוכן לא יכול לעשות:**

- לראות שיחה מוסתרת. היא לא מופיעה ברשימה, לא עולה בחיפוש, ולא מוזכרת בשמה, גם לא בסירוב.
- לשלוח בשיחה שהשארתם לקריאה בלבד, או להגיע לשיחה שהסתרתם. ושליחה אף פעם לא חוזרת על עצמה אוטומטית.
- להגיב עם ציטוט או עם אימוג'י. את זה אפשר לעשות רק [ב-API](https://usecircles.app/whatsapp-api-personal-number).
- להמשיך לגשת אחרי שניתקתם אותו. הניתוק מיידי, וכל בקשה ששלח נשארת ביומן הפעילות.

## שינוי הגישה, מסלולים והזמנות

**משנים מה הסוכנים יכולים לעשות.** כל סוכן שמחברים קורא וכותב כברירת מחדל בשיחות שנשארו פתוחות, מההתחלה. כדי לצמצם, מסמנים שיחה כקריאה בלבד או מסתירים אותה בעמוד השיחות באפליקציה של Circles, או כותבים לשירות הלקוחות של סירקלס, השירות הווירטואלי במספר של Circles: [wa.me/972553091640](https://wa.me/972553091640). כותבים אליו מהוואטסאפ שלכם. הסוכן יכול לנסח לכם את ההודעה. הוא לא יכול לפתוח את השיחה הזאת, לקרוא בה או לשלוח בה, כי יש בה את קישורי הכניסה שלכם.

**חבילות.** כל חבילה קוראת וכותבת ורואה את כל ההיסטוריה הזמינה: 2 צ׳אטים ב-Free, עד 3 חודשים מהחיבור, 10 ב-Plus, וכל הצ׳אטים שתאפשרו ב-Pro. כל הרשמה מתחילה ב-14 ימי Pro, בלי כרטיס אשראי. שום תשלום לא יוצא בלי שבחרתם חבילה. [החבילות והמחירים](https://usecircles.app/pricing).

**הזמנות.** חבר שמזמינים מקבל 28 ימי Pro במקום 14, מהיום שהוא מקשר את הוואטסאפ. אתם מקבלים 14 ימים כשהסוכן שלו קורא לראשונה דרך Circles, עד 10 חברים בשבוע. את קישור ההזמנה מבקשים משירות הלקוחות של סירקלס.

## שאלות ותשובות

### יש ל-Composio toolkit לוואטסאפ?

כן, לחשבונות WhatsApp Business דרך ה-Business API, והעמוד שלו אומר שחשבונות אישיים לא נתמכים (נכון לנובמבר 2026). Circles מוסיף ל-Composio מספר אישי כ-toolkit מסוג Custom MCP.

### כל משתמש יכול לחבר את הוואטסאפ שלו?

כן. משתפים toolkit אחד של Circles עם `user_id="all"`; כל משתמש מתחבר עם המפתח שלו מ-Circles, והסוכן שלו רואה רק את השיחות שהוא פתח ב-Circles.

### Circles נמצא בקטלוג ה-toolkits של Composio?

עוד לא, נכון לנובמבר 2026. מוסיפים אותו כ-toolkit מסוג Custom MCP; לפי התיעוד של Composio, toolkits משותפים עובדים בכל המסלולים שלו.

### אפשר להתחבר עם OAuth במקום מפתח?

Composio תומך ב-OAuth עם רישום דינמי, וגם Circles, אבל את השניים עוד לא ניסינו יחד. עד אז מתחברים עם מפתח.

### הסוכן יכול לשלוח הודעות בוואטסאפ?

רק אם המפתח של המשתמש מאפשר שליחה, ורק בשיחות שפתוחות לשליחה (כל השיחות, כברירת מחדל). שליחה אף פעם לא חוזרת על עצמה אוטומטית.

### כמה זה עולה?

Circles מתומחר לפי מספר וואטסאפ: Free ל-2 שיחות עד 3 חודשים מהחיבור, Plus ב-₪39 לחודש, או Pro ב-₪79 לחודש, עם 14 ימים של Pro בחינם. המסלול של Composio נפרד.

## להמשך קריאה

- [כל לקוח MCP](https://usecircles.app/en/agents/grok): אותה כתובת ואותו מפתח, ללקוחות שמקבלים שרת מרוחק.
- [ה-API](https://usecircles.app/whatsapp-api-personal-number): אותן שיחות כ-JSON, עם תשובה בציטוט ותגובות.
- [למה הסוכן מגיע](https://usecircles.app/security): הרשאות לכל שיחה ויומן הפעילות.

---

14 ימים לנסות הכול, בחינם ובלי כרטיס אשראי. אחר כך בוחרים חבילה לפי השימוש שלכם. Start: https://usecircles.app/start?lang=he