איך לחבר Base44 Superagent ל-Financy ולדבר עם הכסף דרך WhatsApp

מה אם במקום לפתוח אפליקציה, לבחור חשבון ולהוריד דוח, היה אפשר פשוט לשלוח הודעה ב-WhatsApp: ״כמה כסף יש לי בחשבונות?״, ״אילו חיובים חוזרים החודש?״ או ״לאילו הוצאות עדיין חסרה חשבונית?״

זה החיבור שנבנה כאן. Base44 Superagent הוא סוכן AI מתמשך שאפשר לחבר לכלים ולמקורות מידע, להפעיל ממנו תהליכים ולדבר איתו דרך WhatsApp. כשמחברים אותו ל-Financy, הוא יכול למשוך נתונים מהחשבונות והעסקאות שחיברתם ולענות על שאלות פיננסיות מתוך השיחה שכבר נמצאת בטלפון.

במדריך נציג שתי דרכים לחבר את Financy:

1. המסלול הרגיל והנגיש יותר: ה-Superagent יוצר Skill שמשתמש ב-Financy API וב-CLI, וההרשאות נשמרות ב-Secrets. המסלול הזה אינו משתמש ביכולת Custom MCP של Base44 ולכן אינו מחייב תוכנית Builder לצורך הוספת שרת MCP.
2. חיבור MCP ישיר: חיבור OAuth קצר יותר דרך Plugins, הזמין ב-Base44 בתוכנית Builder ומעלה.

בשני המקרים עובדים מול אותם נתונים פיננסיים. ההבדל הוא בדרך שבה ה-Superagent מתחבר אליהם.

לפני שמחברים: החיבור נותן לשירות AI חיצוני אפשרות לעבד מידע פיננסי רגיש. נתונים שנשלפים מ-Financy עשויים לעבור לסביבת Base44, ותוצאות עשויות להישלח דרך WhatsApp או להסתמך על מידע מ-Gmail. חברו רק חשבונות שאתם מורשים לחשוף, הפעילו רק את החיבורים הנחוצים ובדקו שהשימוש מתאים למדיניות הארגון ולמדיניות הפרטיות של השירותים המעורבים.

לפני שמתחילים

צריך:

• חשבון Financy Starter ומעלה, עם חשבונות בנק או כרטיסי אשראי שכבר חוברו
• חשבון Base44 ו-Superagent פעיל
• WhatsApp בטלפון
• חשבון Gmail מחובר ל-Superagent רק אם רוצים לבצע התאמת חשבוניות מהמייל

יכולות, מגבלות תוכנית ומכסות קרדיטים עשויות להשתנות. אפשר לבדוק את המצב העדכני בתיעוד ה-Superagents של Base44 ובתיעוד Financy.

מה Superagent יכול לעשות עוד לפני Financy

Superagent אינו רק חלון צ׳אט. אפשר לחבר אליו Gmail, יומן, מסמכים וכלים נוספים, להגדיר משימות מתוזמנות ולתת לו לפעול גם כשהדפדפן סגור. למשל:

• לסכם מיילים שלא נקראו ולשלוח תקציר
• למצוא מסמכים ולחלץ מהם פרטים
• לעקוב אחר משימה ולשלוח עדכון כשמשהו השתנה
• להכין סיכום שבועי קבוע
• לקבל בקשות ועדכונים דרך WhatsApp

אחרי שמוסיפים את Financy, אותם תהליכים יכולים להשתמש גם בנתוני חשבונות, יתרות ועסקאות.

המסלול הראשי: מחברים את Financy דרך Skill ו-Secrets

המסלול הזה מתאים למי שרוצה להתחיל בלי יכולת Custom MCP של Base44. ה-Superagent יוצר Skill קטן שמשתמש ב-CLI הרשמי של Financy וקורא את פרטי הגישה מ-Secrets — לא מתוך הצ׳אט.

1. מבקשים מה-Superagent להכין את החיבור

פתחו שיחה חדשה עם ה-Superagent ושלחו:

צור Skill בשם Financy שמאפשר לך לקרוא את נתוני החשבונות והעסקאות שלי באמצעות ה-CLI הרשמי npx financy. קרא את פרטי הגישה רק ממשתני הסביבה FINANCY_USER_ID, FINANCY_CLIENT_ID ו-FINANCY_CLIENT_SECRET. אל תציג סודות בצ׳אט, אל תשמור אותם בקובץ ואל תבצע רענון נתונים בלי לבקש ממני אישור מראש.

הסוכן יכול ליצור את ה-Skill והפונקציות הדרושות בעצמו. אם הוא מבקש את ערכי המפתחות בהודעה רגילה, אל תדביקו אותם שם — מוסיפים אותם במסך ה-Secrets בשלב הבא.

חשוב להבין שהוראה שכותבים בפרומפט, כמו ״אל תבצע פעולה בלי אישור״, היא כלל התנהגות לסוכן ולא מנגנון הרשאה טכני. עברו על ה-Skill שנוצר, ודאו שהוא משתמש רק בפקודות ובנתונים שהתכוונתם לחשוף ואל תאשרו קוד או חבילות שאינכם מזהים.

2. מעתיקים את פרטי הגישה מ-Financy

ב-Financy היכנסו ל-הגדרות ← גישה ל-API. העתיקו את שלושת הערכים:

ב-Financy	שם ה-Secret ב-Base44
User ID	FINANCY_USER_ID
Client ID	FINANCY_CLIENT_ID
Client Secret	FINANCY_CLIENT_SECRET

3. שומרים את הערכים כ-Secrets

ב-Base44 פתחו Agent Settings בסרגל הצד.

עברו אל Security → Secrets, הוסיפו את שלושת המשתנים ושמרו כל ערך בשדה המתאים. Base44 מציג את הערכים כשהם ממוסכים.

ה-Client Secret הוא סיסמה לכל דבר. אל תפרסמו אותו, אל תצלמו אותו כשהוא גלוי ואל תעבירו אותו בהודעת WhatsApp. אם הוא נחשף, חזרו ל-Financy, לחצו סובב מפתח, ועדכנו מיד את ה-Secret ב-Base44.

שמירת Secret ב-Base44 מאפשרת לפונקציות שרצות בסביבת הסוכן להשתמש בו. התייחסו למפתח כאילו הוא מעניק לסוכן את כל היכולות שה-API המשויך אליו מאפשר, ואל תחברו אותו לסוכן משותף או לסוכן שאנשים נוספים יכולים לערוך. כשמפסיקים להשתמש בחיבור, מחקו את ה-Secrets וסובבו את המפתח ב-Financy.

4. בודקים שהחיבור עובד

חזרו לשיחה עם ה-Superagent ושלחו:

בדוק את החיבור ל-Financy. הרץ בדיקת status, אמור לי עד איזה תאריך כל חיבור מעודכן וודא שאתה מצליח לקרוא את רשימת החשבונות. אל תבצע refresh.

חשוב לבדוק את תאריך העדכון לפני ניתוח. בנקים וחברות אשראי עשויים לפרסם נתונים באיחור, ותשובה המבוססת על תקופה חלקית עלולה להיות מטעה.

מחברים את ה-Superagent ל-WhatsApp

פתחו ב-Base44 את Agent Settings → Channels → WhatsApp. אפשר לסרוק את קוד ה-QR, או לפתוח את WhatsApp ולשלוח את הודעת ההפעלה שמופיעה במסך.

מרגע שהערוץ מחובר, אפשר לדבר עם הסוכן מתוך WhatsApp כמו בכל שיחה אחרת. אין צורך לציין בכל הודעה את שם ה-Skill; אם הבקשה עוסקת בחשבונות או בעסקאות, הסוכן אמור לבחור בחיבור ל-Financy.

השתמשו בצ׳אט פרטי בלבד. כל מי שיש לו גישה לטלפון, ל-WhatsApp Web, למכשיר מקושר או לתצוגה המקדימה במסך הנעילה עלול לראות יתרות ועסקאות שמתקבלות בתשובה. מומלץ להפעיל נעילת מכשיר ואימות דו-שלבי, לבדוק מכשירים מקושרים ולבטל תצוגה מקדימה של הודעות רגישות. לעולם אל תשלחו לסוכן סיסמה, קוד חד-פעמי או פרטי כרטיס מלאים.

פרומפטים שאפשר לשלוח ב-WhatsApp

כמה כסף יש לי עכשיו?

בדוק דרך Financy עד מתי כל חיבור מעודכן. הצג את היתרה בכל חשבון ואת הסכום הכולל. הפרד בין עו״ש פרטי, עו״ש עסקי וכרטיסי אשראי, ואל תכלול מסגרות אשראי כאילו הן כסף זמין.

אילו הוצאות חוזרות בכל חודש?

שלוף דרך Financy את כל העסקאות בארבעת החודשים המלאים האחרונים. מצא חיובים שחוזרים מדי חודש אצל אותו ספק או בסכום דומה. חלק אותם למנויים, שכר דירה, משכורות, מסים והוצאות קבועות אחרות. הצג את הסכום החודשי המשוער וסמן מקרים שאינם ודאיים.

מה השתנה החודש?

השווה את החודש המלא האחרון לחודש שקדם לו. הוצא העברות פנימיות, הצג זיכויים בנפרד ואל תספור גם את עסקאות הכרטיס וגם את החיוב המרוכז בבנק. הצג את חמש הקטגוריות שהשתנו הכי הרבה ואת העסקאות שמסבירות כל שינוי.

יש עסקאות חריגות או כפולות?

בדוק את 60 הימים האחרונים דרך Financy. מצא חיובים כפולים לפי ספק, סכום ותאריך, והוצאות שחריגות משמעותית מהדפוס הרגיל שלי. אל תקבע שחיוב הוא טעות אם אין מספיק ראיות; הצג בנפרד חשדות חזקים ומקרים לבדיקה.

סיכום קבוע ל-WhatsApp

בכל יום ראשון בשעה 08:00 בדוק תחילה עד מתי נתוני Financy מעודכנים. שלח לי ב-WhatsApp סיכום קצר של יתרות, הוצאות השבוע האחרון, חיובים חריגים ושלושת התשלומים הגדולים הצפויים. אם הנתונים אינם עדכניים, אמור זאת ואל תציג את הסיכום כאילו הוא מלא. אל תבצע refresh בלי אישור.

לפני ששומרים Workflow אוטומטי, בדקו פעם אחת את אותה בקשה ידנית. כך אפשר לראות אילו חשבונות נכללים, איך הסוכן מטפל בהעברות פנימיות ומה אורך ההודעה שמתקבלת ב-WhatsApp.

בסיכומים אוטומטיים עדיף להימנע ממספרי חשבון, שמות מלאים ופירוט עסקאות שאינו נחוץ. ודאו מראש את הנמען, אזור הזמן והתדירות, וזכרו שהודעה אוטומטית עלולה להגיע כשהטלפון פתוח או נמצא בידי אדם אחר. כבו את ה-Workflow כשאין בו עוד צורך.

התאמת חשבוניות מהמייל מול חיובי האשראי

זה אחד החיבורים השימושיים ביותר: Gmail מחזיק את החשבוניות והקבלות, ו-Financy מחזיק את העסקאות. ה-Superagent יכול לקרוא את שני המקורות ולבנות רשימת התאמות לבדיקה.

1. מחברים Gmail לקריאה בלבד

פתחו Plugins → Add Connector → Apps, בחרו Gmail והפעילו Read only. עברו על ההרשאות לפני האישור. לצורך ההתאמה אין צורך לאפשר לסוכן לשלוח או למחוק הודעות.

גישה לתיבת דואר עשויה לחשוף הרבה יותר מחשבוניות: חוזים, פרטים אישיים, התכתבויות וקבצים מצורפים. העדיפו הרשאה מצומצמת ככל האפשר, הגדירו בפרומפט טווח תאריכים וסוגי מסמכים ברורים, ואל תחברו תיבה ארגונית ללא אישור מתאים. אם ההתאמה היא חד-פעמית, נתקו את Gmail לאחר סיום הבדיקה.

2. שולחים בקשת התאמה מדויקת

קרא ב-Gmail בלבד את החשבוניות והקבלות שהתקבלו בחודש המלא האחרון, כולל קובצי PDF ותמונות מצורפות. חלץ מכל מסמך את שם הספק, מספר המסמך, תאריך, סכום כולל ומטבע. דרך Financy שלוף את עסקאות כרטיסי האשראי מאותה תקופה וגם שבעה ימים לפניה ואחריה. התאם לפי סכום ומטבע, תאריך חיוב ושם ספק מנורמל. חלק את התוצאה לשלוש קבוצות: ״התאמה״, ״התאמה אפשרית״ ו״לא נמצא חיוב״. אם יש כמה עסקאות באותו סכום, אל תנחש. אל תמחק, תעביר או תסמן מיילים, ואל תקבע אם הוצאה מוכרת לצורכי מס.

החלון של שבעה ימים עוזר להתמודד עם מצב שבו תאריך החשבונית ותאריך קליטת העסקה אינם זהים. בעסקאות במטבע חוץ ייתכן הבדל בין סכום המסמך לסכום שחויב בפועל, ולכן הן עשויות להופיע כ״התאמה אפשרית״.

3. מבקשים לראות את מה שחסר

אחרי שמקבלים את הטבלה, אפשר להמשיך:

מתוך התוצאות, הצג רק חיובי אשראי מעל 100 ₪ שלא נמצאה להם חשבונית. מיין מהסכום הגבוה לנמוך, קבץ לפי ספק וציין אילו מילות חיפוש כדאי לנסות ב-Gmail. אל תפנה לספק ואל תשלח הודעה בשמי.

ההתאמה היא כלי לאיתור מסמכים חסרים וטעויות אפשריות, לא הנהלת חשבונות ולא קביעה מיסויית. התאמה אפשרית עדיין דורשת בדיקה אנושית.

חלופה למנויי Base44 Builder: חיבור MCP ישיר

אם יש לכם תוכנית Base44 Builder ומעלה, אפשר לחבר את שרת ה-MCP של Financy ישירות, בלי להעתיק Client ID או Client Secret.

פתחו Plugins, לחצו Add Connector, עברו ללשונית MCP ובחרו Add a MCP server. מלאו:

שדה	ערך
Name	Financy
URL	https://mcp.open-finance.ai/mcp
Authentication	OAuth
Custom Headers	להשאיר ריק

לחצו Authorize & Add.

אם Base44 מציג הודעה שה-Popup נחסם, אשרו Pop-ups ו-redirects עבור app.base44.com, לחצו Done ונסו שוב.

אשרו חלונות קופצים רק עבור הדומיין המדויק app.base44.com. בחלון ההרשאה ודאו ששורת הכתובת מציגה את auth.open-finance.ai, בדקו לאיזה חשבון אתם מחוברים וקראו את ההרשאות לפני לחיצה על Accept. אם הדומיין או ההרשאות אינם צפויים, סגרו את החלון ואל תמשיכו.

בחלון של Financy עברו על הרשאות הקריאה ולחצו Accept. לאחר החזרה ל-Base44, Financy צריך להופיע ברשימת שרתי ה-MCP המחוברים.

החיבור הישיר משתמש ב-OAuth של Financy ונותן ל-Superagent גישת קריאה לחשבונות, עסקאות, יתרות, הלוואות וניירות ערך. הוא אינו מאפשר העברת כסף, תשלום או שינוי בחשבון הבנק.

מה חשוב לדעת על פרטיות והרשאות

• חיבור שירות אינו רק ״הצגת נתונים״: הוא מאפשר לסוכן לשלוף ולעבד מידע בהתאם להרשאות שקיבל. בפרומפטים ובאוטומציות בקשו רק את המידע שבאמת נחוץ.
• בחיבור Gmail, השתמשו ב-Read only אם המטרה היא חיפוש והתאמת מסמכים.
• אל תשלחו סודות, סיסמאות בנק או קודי אימות בשיחת WhatsApp או בצ׳אט של הסוכן.
• חיבור ה-OAuth הישיר ל-Financy המתואר כאן מעניק הרשאות קריאה ואינו מאפשר לסוכן להעביר כסף. במסלול ה-Secrets יש להתייחס למפתח בהתאם לכל היכולות שה-API מאפשר בפועל.
• הנתונים שה-Superagent שולף עוברים לסביבת Base44 לצורך ביצוע הבקשה, בהתאם להרשאות שנתתם ולמדיניות הפרטיות של Base44.
• מידע שמופיע בתשובת WhatsApp כפוף גם לאבטחת החשבון, המכשירים המקושרים והגדרות השמירה של WhatsApp. אל תבקשו פירוט רגיש יותר ממה שנדרש למשימה.
• בדקו מדי פעם אילו Connectors,‏ Secrets ו-Workflows עדיין פעילים. נתקו חיבורים שאינם בשימוש, מחקו Secrets ישנים וסובבו מפתח שנחשף או נשמר במקום לא נכון.
• תשובות הסוכן מבוססות על הנתונים שהיו זמינים בזמן השליפה. בדקו תמיד את תאריך העדכון ואת העסקאות שמאחורי הסיכום.
• סוכן AI עלול לטעות בהתאמה, בסיווג או בסיכום. אל תבטלו חיוב, תפנו לספק, תגישו דיווח מס או תקבלו החלטה פיננסית מהותית בלי לבדוק את המקור ולאשר את הפעולה בעצמכם.

מתחילים משאלה אחת

לא צריך לבנות אוטומציה מורכבת ביום הראשון. חברו את Financy, בדקו שהנתונים עדכניים ושלחו ב-WhatsApp שאלה אחת שאתם כבר שואלים את עצמכם — למשל ״אילו הוצאות חוזרות בכל חודש?״.

אחרי שהתשובה נכונה וברורה, אפשר להפוך אותה לסיכום שבועי, לצרף Gmail כדי למצוא חשבוניות חסרות, או להוסיף כללים שמתאימים לעסק ולדרך שבה אתם עובדים. המטרה אינה עוד דשבורד שצריך לזכור לפתוח, אלא שיחה שימושית עם הנתונים הפיננסיים שכבר נאספים ב-Financy.

לשימושים נוספים אפשר לקרוא גם את המדריך לחיבור Financy ל-ChatGPT ולבניית סימולציית חיסכון.