פונקציות מותאמות אישית #

פונקציות מותאמות אישית מאפשרות לבוט ה-AI שלך להתחבר למערכות אחרות במהלך שיחות חיות. במקום לומר “אבדוק ואחזור אליך”, הבוט יכול לחפש סטטוס הזמנה, לבדוק מלאי או ליצור רשומה ב-CRM שלך (מערכת לניהול קשרי לקוחות - התוכנה שבה אתה משתמש כדי לעקוב אחר לידים ולקוחות, כגון HubSpot או Salesforce) - הכל בזמן אמת, בזמן שהלקוח ממתין.

פונקציות מותאמות אישית לעומת Webhooks #

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

מתי לבחור מה: אם אתה רק צריך להודיע למערכת אחרת שמשהו קרה, השתמש ב-webhook - הודעה אוטומטית חד-כיוונית שנשלחת למערכת אחרת (ראה הגדרות ← אינטגרציות ← Webhooks). אם הבוט צריך ללמוד משהו ממערכת אחרת לפני המשך השיחה, השתמש בפונקציה מותאמת אישית.

דוגמאות למה שפונקציות מותאמות אישית מאפשרות #

מכיוון שהתגובה מוזנת בחזרה לשיחה, פונקציות מותאמות אישית פותחות אפשרויות ש-webhooks פשוט לא יכולים לבצע:

• בדיקת מלאי חיה ב-Shopify או WooCommerce — לפני מתן הצעת מחיר ללקוח, הבוט בודק מלאי בזמן אמת ועונה “כן, יש לנו 12 במידה M” במקום “תן לי לבדוק ולחזור אליך”.
• תמחור דינמי מ-Google Sheet — צוות המכירות שלך מעדכן מחירים בגיליון; הבוט קורא את השורה העדכנית ביותר באמצע השיחה ומצטט את המחיר הנוכחי מבלי שאף אחד יצטרך לגעת בהגדרות ה-AI.
• סוכן חזרה קולי מבוסס AI — כאשר הבוט מסווג ליד (lead), הוא מפעיל סוכן קולי (למשל, מתקשר המופעל על ידי ElevenLabs) כדי לחזור לליד תוך דקות, ומאשר ללקוח “מעולה, צפה לשיחה ב-5 הדקות הקרובות”.
• הצעת מחיר ב-PDF, שנוצרת ונשלחת במייל באמצע הצ’אט — הבוט אוסף דרישות, קורא למחולל הצעות המחיר שלך, מקבל חזרה כתובת URL של PDF, ואומר ללקוח “זה עתה שלחתי את הצעת המחיר שלך במייל — בדוק את תיבת הדואר הנכנס שלך”.

מה פונקציות מותאמות אישית יכולות לעשות? #

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

• מעקב הזמנות - לקוח שואל “איפה ההזמנה שלי?” והבוט בודק במערכת המסחר האלקטרוני שלך ומשיב עם סטטוס המשלוח וקישור למעקב
• בדיקת מלאי - “האם יש לכם את זה במידה 10?” הבוט בודק במערכת המלאי שלך ונותן תשובה בזמן אמת
• עדכוני CRM - כאשר הבוט מסווג ליד, הוא יוצר או מעדכן אוטומטית רשומה ב-HubSpot, Salesforce או כל CRM אחר
• יצירת הצעת מחיר - הבוט אוסף את דרישות הלקוח ומייצר הצעת מחיר מותאמת אישית ממערכת התמחור שלך
• הזמנת תורים - הבוט יוצר פגישה במערכת הזמנת התורים החיצונית שלך
• אימות הנחות - “האם קוד הקופון הזה תקף?” הבוט בודק ומאשר
• חיפוש חשבון - לקוח חוזר מזוהה אוטומטית ופרטי החשבון שלו נשלפים

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

איך פונקציות מותאמות אישית עובדות (הגרסה הפשוטה) #

הנה מה שקורה כאשר פונקציה מותאמת אישית מופעלת במהלך שיחה:

1. הלקוח שואל משהו שדורש נתונים בזמן אמת (למשל, “איפה ההזמנה שלי?”)
2. הבוט מזהה שהוא צריך להשתמש בפונקציה מותאמת אישית כדי לענות
3. הבוט אוסף כל מידע חסר מהלקוח (למשל, “מהו מספר ההזמנה שלך?”)
4. הפלטפורמה שולחת בקשה למערכת שלך (האתר שלך, ה-CRM או כל כלי אחר) עם הפרטים הרלוונטיים
5. המערכת שלך משיבה עם הנתונים (למשל, סטטוס הזמנה, מספר מעקב, תאריך אספקה)
6. הבוט קורא את התגובה ומנסח תשובה טבעית: “ההזמנה שלך ORD-4582 נשלחה ואמורה להגיע עד יום שישי!”

מהי העלות של קריאה לפונקציה מותאמת אישית #

כל קריאה לפונקציה מותאמת אישית מחויבת לפי רמת איכות ה-AI של הסוכן שלך:

הגדרת פונקציה מותאמת אישית (צעד אחר צעד) #

1. בסרגל הצד הראשי, תחת AI Studio, לחץ על Custom Functions.

2. לחץ על הכפתור הירוק + Add Function (או New function) בפינה הימנית העליונה.

רשימת הפונקציות המותאמות אישית מציגה טבלה עם העמודות הבאות:

זה מקל על סריקת הפונקציות שלך במבט חטוף ומציאת זו שאתה צריך.

שלב 1: תן לה שם ותיאור #

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

שלב 2: הגדרת החיבור #

עליך לומר לאפליקציה לאן לשלוח את הבקשה:

באיזו שיטה לבחור:

אם אינך בטוח באיזו מהן להשתמש, בדוק זאת מול המפתח שלך או בתיעוד של המערכת שאליה אתה מתחבר. GET (עבור חיפושים) ו-POST (עבור יצירת רשומות) הן הנפוצות ביותר.

שלב 3: הוספת כותרות אימות (Authentication Headers) #

רוב המערכות דורשות אימות כדי לקבל בקשות. הוסף את כל הכותרות הנדרשות:

טיפ אבטחה: השתמש במפתח API ייעודי בעל הרשאות מוגבלות. אל תשתמש בפרטי גישה ברמת מנהל מערכת.

איפה למצוא מפתחות API: בדוק את הגדרות המערכת או את אזור המפתחים של המערכת שאליה אתה מתחבר (למשל, ה-CRM שלך, פלטפורמת המסחר האלקטרוני או כלי ההזמנות).

שלב 4: הגדרת הקלט (מה שהבוט שולח) #

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

עבור כל פרמטר, עליך לציין:

סוגי פרמטרים זמינים:

לכל פרמטר יש גם שדה אופציונלי של נתיב גוף הבקשה (Request body path). בדרך כלל, פרמטר נשלח כשדה ברמה העליונה בגוף הבקשה (או כערך במחרוזת שאילתה, עבור הסוג query_param). אם נקודת הקצה שלך מצפה שהוא יהיה מקונן — למשל {"order": {"id": "ORD-123"}} — הגדר את הנתיב ל-order.id והפלטפורמה תקנן את הערך שם עבורך.

דוגמה: עבור חיפוש סטטוס הזמנה, ייתכן שתגדיר:

• order_number (string, נדרש): “מספר ההזמנה של הלקוח. בדרך כלל מתחיל ב-ORD- ואחריו ספרות. בקש מהלקוח את המספר הזה אם הוא לא ציין אותו.”
• email (string, אופציונלי): “כתובת האימייל של הלקוח לצורך אימות נוסף. נדרש רק אם מספר ההזמנה לבדו לא מוצא התאמה.”

מה המערכת שלך מקבלת באופן אוטומטי #

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

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

לא זקוק לנתוני המערכת? הפעל את המתג דלג על נתוני מערכת (Skip System Data) בבונה הפונקציות. הבוט ישלח אז רק את פרמטרי הקלט שהגדרת — ללא נתוני איש קשר או קמפיין. השתמש בזה אם נקודת הקצה שלך דוחה שדות בלתי צפויים או אם אתה פשוט רוצה מטען (payload) רזה יותר.

שלב 5: בדוק זאת, ואז תן לבוט לקרוא את התגובה #

בדרך כלל אין צורך למפות שדות תגובה כלל. ברגע שנקודת הקצה שלך מגיבה, הבוט קורא את כל תגובת ה-JSON ומשתמש בתיאור ובמטרה (פעולת AI) של הפונקציה שלך — בתוספת התיאור של כל פרמטר — כדי להבין מה חשוב ולהציג זאת באופן טבעי. תיאור ברור של הפונקציה עצמה (“שולף את הסטטוס הנוכחי של הזמנת לקוח כולל פרטי משלוח ומעקב”) עושה כאן עבודה טובה יותר מאשר מיפוי שדה אחר שדה.

אם נקודת הקצה שלך מחזירה תגובה גדולה ואתה רוצה שהבוט יראה רק כמה ערכים ספציפיים, פתח את המקטע מיפוי תגובה (Response mapping) (סגור כברירת מחדל, ממש מעל ‘בדיקה’). כל שורה בוחרת שדה אחד ברמה העליונה מתוך התגובה: שדה תגובה (Response field) הוא שם השדה בתשובת ה-JSON של ה-API שלך, ושדה פלט (Output field) הוא השם שבו הבוט מקבל אותו. כאשר לפחות שורה אחת מלאה, הבוט מקבל רק את הערכים שמיפית במקום את כל גוף התגובה. השאר את המקטע ריק כדי לשמור על התנהגות ברירת המחדל של קבלת התגובה המלאה.

לפני השמירה, השתמש בסעיף בדיקה (Test) בתחתית בונה הפונקציות כדי לשלוח את הבקשה בדיוק כפי שהוגדרה ולראות את התגובה האמיתית, מבלי לצאת מהאפליקציה:

התגובה שאתה רואה כאן היא התגובה הגולמית של נקודת הקצה (endpoint). אם הגדרת מיפוי תגובה (Response mapping) למעלה, הבוט בצ’אט אמיתי יקבל רק את השדות הממופים הללו — הבדיקה תמיד מציגה את התגובה הגולמית המלאה כדי שתוכל לראות מה זמין למיפוי. אם משהו נראה לא תקין (שמות שדות בלתי צפויים, קינון מיותר), תקן זאת בנקודת הקצה שלך או התאם את המיפוי שלך.

הקצאת פונקציות לסוכן #

לאחר יצירת פונקציה מותאמת אישית, עליך להגדיר לכל סוכן באילו פונקציות הוא יכול להשתמש:

1. פתח את הסוכן תחת AI Studio → סוכני AI.
2. עבור ללשונית יכולות AI שלו. (עבור קמפיין שעדיין מחזיק את הגדרות ה-AI שלו ישירות ולא דרך סוכן נפרד, אותה רשימה מופיעה בשלב יכולות AI של הקמפיין עצמו במקום זאת.)
3. תראה רשימה של כל פונקציה מותאמת אישית שיצרת. הפעל את המתג עבור כל פונקציה שאתה רוצה שהבוט של סוכן זה יוכל להפעיל.
4. לחץ על שמור שינויים בתחתית. הבחירות יחולו רק לאחר השמירה.

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

בדיקת הפונקציות המותאמות אישית שלך #

לפני העלייה לאוויר, בצע בדיקות יסודיות:

1. הפעל את הבדיקה המובנית - השתמש בסעיף בדיקה (Test) בתוך בונה הפונקציות (ראה לעיל) לבדיקה מהירה מבלי לצאת מהאפליקציה — מלא ערכים מציאותיים ולחץ על ‘הפעל בדיקה’.
2. בדוק את נקודת הקצה של המערכת שלך ישירות - עבור רשימת הבדיקה המלאה להלן, כלי ייעודי כמו Postman (או המפתח שלך) חופר עמוק יותר מאשר ‘הפעל בדיקה’ בודד.
3. בדוק ב’נסה זאת’ (Try Out) - הדמה שיחה שבה הלקוח שואל משהו שאמור להפעיל את הפונקציה.
4. בדוק את התגובה - ודא שהבוט קורא ומציג את הנתונים בצורה נכונה.
5. בדוק תרחישי שגיאה - מה קורה אם הלקוח נותן מספר הזמנה לא תקין? מה אם המערכת שלך מושבתת זמנית?

כאשר הבדיקה מחזירה 401 או 403 #

שגיאת 401 או 403 משמעותה שנקודת הקצה שלך קיבלה את הבקשה וסירבה לה. הסימן המובהק לכך הוא ששום דבר לא מופיע ביומנים (logs) שלך — רוב הכלים דוחים קריאה לא מורשית עוד לפני שהם מתחילים את זרימת העבודה, לכן אין מה לראות בצד שלך ונראה כאילו הבקשה מעולם לא הגיעה.

כמעט תמיד מדובר באי-התאמה באימות: נקודת הקצה שלך דורשת סוג מסוים של אישור והפונקציה שולחת סוג אחר. ודא שהכותרת (header) שהוספת ב-שלב 3 היא בדיוק זו שהמערכת שלך מצפה לה.

הגרסה הנפוצה ביותר לכך היא webhook המוגן באמצעות Basic Auth (כלים כמו n8n, Make ורוב הכלים המותקנים עצמאית מציעים זאת כתיבת סימון ב-webhook עצמו) בעוד שהפונקציה שולחת כותרת סודית מותאמת אישית כמו X-My-Secret. אימות בסיסי (Basic Auth) מקבל רק כותרת Authorization, לכן כותרת מותאמת אישית מתעלמים ממנה והקריאה נדחית. יש לך שתי אפשרויות:

• כבה את ה-Basic Auth ב-webhook, ובדוק את הכותרת המותאמת אישית שלך בתוך זרימת העבודה במקום זאת.
• השאר את ה-Basic Auth פעיל, והוסף כותרת Authorization לפונקציה שהערך שלה הוא המילה Basic ולאחריה ה-username:password המקודד ב-base64 שלך.

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

כאשר הבדיקה מחזירה 404 #

כתובת ה-URL של נקודת הקצה שגויה, או שזרימת העבודה אינה מפורסמת. ב-n8n באופן ספציפי, לכל webhook יש כתובת URL נפרדת עבור בדיקה (Test) ועבור ייצור (Production), וכתובת הבדיקה מאזינה רק בזמן שהעורך פתוח. העתק את כתובת ה-URL של ה-Production וודא שזרימת העבודה פעילה.

צפייה בכשלים ב-Try Out ובצ’אטים #

כאשר ה-AI קורא לפונקציה מותאמת אישית במהלך שיחה והקריאה נכשלת — בשל אישורים שגויים, נקודת קצה (endpoint) לא זמינה או פסק זמן — השיחה תציג זאת כעת: סמן אדום של “(function name) failed” יופיע בשרשור, הן בלשונית ה-Try Out של הסוכן והן בשיחות אמיתיות ב-Chats. לחץ על הסמן כדי להרחיב את הפרטים: קוד הסטטוס שנקודת הקצה שלך החזירה וגוף התגובה שלה, שלרוב מספיקים כדי להבין בדיוק מה צריך לתקן (שגיאת 401 עם הודעת “unauthorized” מצביעה על כותרת אימות, ופסק זמן מצביע על כך שנקודת הקצה שלך לקחה יותר מ-30 שניות).

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

דוגמה מלאה: בדיקת סטטוס הזמנה #

להלן דוגמה מוגדרת במלואה שניתן להשתמש בה כתבנית:

מידע בסיסי:

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

חיבור:

• URL: https://api.mystore.com/orders/lookup
• שיטה: POST

כותרות (Headers):

• Authorization: Bearer sk_live_abc123
• Content-Type: application/json

פרמטרים לקלט:

• order_number (טקסט, חובה): “מספר ההזמנה שסופק על ידי הלקוח”
• customer_email (טקסט, אופציונלי): “כתובת האימייל של הלקוח לצורך אימות נוסף”

אין צורך במיפוי תגובה — עם תיאור ברור ו-AI Action שהוגדרו לעיל, הבוט קורא כל JSON שנקודת הקצה שלך מחזירה (סטטוס, מספר מעקב, תאריך אספקה, פריטים) ומבין כיצד לדבר על כך.

איך נראית השיחה:

לקוח: היי, איפה ההזמנה שלי?

בוט: היי! אשמח לבדוק את ההזמנה שלך. האם תוכל לשתף איתי את מספר ההזמנה?

לקוח: זה ORD-78234

בוט: תן לי לבדוק זאת עבורך…

ההזמנה שלך ORD-78234 נשלחה והיא בדרך! תאריך ההגעה המשוער הוא ה-10 במרץ. ניתן לעקוב אחר החבילה שלך כאן: https://tracking.example.com/1Z999AA1

האם יש משהו נוסף שאוכל לעזור בו?

דוגמה מלאה: סטטוס הזמנה ב-Shopify #

אם החנות פועלת על Shopify, אינך זקוק למפתח כדי לבנות נקודת קצה (endpoint) לחיפוש — המערכת של Shopify יכולה לענות על שאלות בנוגע להזמנות ישירות. (עבור שאלות על מוצרים ומלאי בחנות Shopify, אין צורך בפונקציה מותאמת אישית כלל: חבר את השרת המובנה של החנות במקום — ראה חיבור חנות Shopify.)

ראשית, צור אסימון גישה (access token) ב-Shopify. Shopify שינתה זאת במהלך 2026: לא ניתן עוד ליצור אפליקציות בתוך ממשק הניהול של Shopify, ומסך האפליקציה החדש מספק לך מזהה לקוח (Client ID) ו-סוד לקוח (Client secret) במקום אסימון מוכן. השלבים להלן הופכים אותם לאסימון קבוע. הקצה לכך כעשר דקות, פעם אחת לכל חנות. (אם בחנות כבר קיימת אפליקציה ישנה שנוצרה בדרך הישנה, האסימון הקיים שלה ימשיך לעבוד — דלג ישר לפונקציה המותאמת אישית להלן.)

1. עבור אל לוח הבקרה למפתחים של Shopify בכתובת dev.shopify.com, פתח את הארגון שלך ולחץ על Apps → Create app. תן לה שם כמו Order lookup.
2. הענק לאפליקציה את ההרשאה read_orders, שחרר גרסה והתקן את האפליקציה בחנות.
3. פתח את הגדרות האפליקציה והוסף את כתובת האינטרנט של החנות (למשל https://www.yourstore.com/) לכתובות ה-URL המותרות להפניה מחדש. שמור.
4. עדיין בהגדרות, העתק את ה-Client ID ואת ה-Client secret.
5. בדפדפן שבו אתה מחובר לממשק הניהול של Shopify של אותה חנות, פתח את הכתובת שלהלן, כשהוא מחליף את שם החנות, מזהה הלקוח וכתובת ההפניה בפרטים שלך: https://YOUR-STORE.myshopify.com/admin/oauth/authorize?client_id=YOUR-CLIENT-ID&scope=read_orders&redirect_uri=https://www.yourstore.com/&state=12345 אשר את המסך שמופיע. הדפדפן ינחת בכתובת ההפניה שלך ושורת הכתובת תכיל כעת את code= ואחריו ערך ארוך — העתק את הערך הזה. הוא תקף למספר דקות בלבד, לכן עבור מיד לשלב הבא.
6. החלף את הקוד הזה באסימון, מה שניתן לעשות בתוך Your AI Connector. בבונה הפונקציות המותאמות אישית, הגדר את Method ל-POST ואת URL ל-https://YOUR-STORE.myshopify.com/admin/oauth/access_token, הוסף שלושה פרמטרי קלט טקסט בשם client_id, client_secret ו-code, לאחר מכן לחץ על Test, מלא את שלושת הערכים והרץ אותה. התגובה מכילה את access_token — זהו האסימון הקבוע שלך. העתק אותו למקום בטוח, לאחר מכן נקה את הבונה והגדר את הפונקציה האמיתית למטה.

לאחר מכן הגדר את הפונקציה המותאמת אישית:

מידע בסיסי:

• שם: check_shopify_order
• תיאור: “מחפש הזמנה במערכת ה-Shopify של החנות ומחזיר את הסטטוס שלה, פרטי מעקב ופריטים”
• פעולת AI: “הפעל זאת כאשר לקוח שואל על סטטוס ההזמנה או המשלוח שלו. בקש תמיד את מספר ההזמנה תחילה.”

חיבור:

• URL: https://YOUR-STORE.myshopify.com/admin/api/2026-01/orders.json?status=any — החלף את YOUR-STORE בשם ה-.myshopify.com של החנות (כתובת זו משתמשת בדומיין הטכני של Shopify, לא בדומיין המותאם אישית של החנות)
• שיטה: GET

כותרות (Headers):

• X-Shopify-Access-Token: shpat_... (האסימון מהשלב הקודם)

פרמטרי קלט:

• name (query_param, נדרש): “מספר ההזמנה של הלקוח בדיוק כפי שהוא מופיע באישור ההזמנה שלו, כולל סימן ה-# — לדוגמה #1001. בקש מהלקוח את המספר אם הוא לא ציין אותו.”

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

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

דוגמה מלאה: קביעת תור #

מידע בסיסי:

• שם: create_booking
• תיאור: “יוצר תור חדש במערכת ההזמנות שלנו”
• פעולת AI: “השתמש בזה לאחר אישור התאריך, השעה ופרטי ההתקשרות עם הלקוח. אל תפעיל עד שהלקוח מאשר במפורש שהוא מעוניין לקבוע תור.”

חיבור:

• URL: https://booking.mycompany.com/api/appointments
• שיטה: POST

פרמטרים לקלט:

• date (טקסט, חובה): “תאריך התור בפורמט YYYY-MM-DD”
• time (טקסט, חובה): “שעת התור בפורמט HH:MM”
• name (טקסט, חובה): “שם מלא של הלקוח”
• phone (טקסט, חובה): “מספר טלפון של הלקוח”
• service_type (טקסט, חובה): “סוג השירות שמוזמן”

דוגמה מלאה: הוספת מנוי לניוזלטר ל-CRM שלך #

דפוס נפוץ מאוד: הבוט מסיים לענות, מציע את הניוזלטר שלך, איש הקשר משיב עם כתובת האימייל שלו, וכתובת זו צריכה להגיע ישירות לכלי האימייל שלך. רוב מערכות ה-CRM (כמו FluentCRM, ActiveCampaign, MailerLite, Brevo ואחרות) מקבלות בקשת POST פשוטה בדיוק עבור זה, כך שאין צורך בפלטפורמת אוטומציה שתתווך ביניהן.

דוגמה זו משתמשת ב-FluentCRM על גבי WordPress. המבנה זהה עבור כל כלי אחר שמספק לך “webhook נכנס” או נקודת קצה (endpoint) של “יצירת מנוי”.

ראשית, השג את ה-URL מה-CRM שלך. ב-WordPress, פתח את FluentCRM → Settings → Incoming Webhooks וצור webhook. בחר את הרשימה, התגיות וסטטוס המנוי שאנשי קשר חדשים צריכים לקבל, ולאחר מכן העתק את כתובת ה-webhook שנוצרה. כל מה שתגדיר כאן יוחל באופן אוטומטי, כך שהבוט צריך רק לשלוח את כתובת האימייל.

לאחר מכן הגדר את הפונקציה המותאמת אישית:

מידע בסיסי:

• שם: add_newsletter_subscriber
• תיאור: “מוסיף אדם לרשימת הניוזלטר שלנו באמצעות כתובת האימייל שהוא מסר בצ’אט”
• פעולת AI: “השתמש בזה ברגע שאיש הקשר מסכים להירשם לניוזלטר ונותן את כתובת האימייל שלו. אל תקרא לזה לפני שהם באמת נתנו כתובת, ואל תקרא לזה פעמיים עבור אותו אדם.”

חיבור:

• URL: כתובת ה-webhook שהעתקת מה-CRM שלך
• שיטה: POST

פרמטרים לקלט:

• email (מחרוזת, נדרש): “כתובת האימייל שאיש הקשר מסר בשיחה”
• first_name (מחרוזת, אופציונלי): “שמו הפרטי של איש הקשר, אם ציין אותו”

דלג על נתוני מערכת: הפעל אפשרות זו (on). ה-CRM שלך זקוק רק לשדות שלעיל, ומטען נתונים (payload) רזה יותר מונע שגיאות מכלים שדוחים שדות בלתי צפויים.

מיפוי תגובה: לא נדרש כאן. שום דבר לא חייב לחזור כדי שהבוט ימשיך.

אל תשכח להפעיל את הפונקציה עבור הסוכן שמנהל את השיחה (ראה הקצאת פונקציות לסוכן). זו הסיבה הנפוצה ביותר לכך שפונקציה שנבנתה כראוי לעולם לא מופעלת.

טיפים לפונקציות מותאמות אישית אמינות #

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

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

3. שמרו על זמני תגובה של פחות מ-10 שניות. אם המערכת שלכם זקוקה ליותר זמן, שקלו להחזיר אישור קבלה מהיר תחילה.

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

5. כתבו תיאורים מפורטים. ה-AI משתמש בתיאורים שלכם כדי להבין מתי לקרוא לפונקציה וכיצד לחלץ את המידע הנכון מהשיחה. תיאורים מעורפלים מובילים לטעויות.

6. בדוק עם שיחות אמיתיות. Try Out מצוין לבדיקות ראשוניות, אך עקוב אחר השיחות החיות הראשונות שלך כדי לוודא שהכל עובד עם פניות אמיתיות של לקוחות.

7. שמרו יומני רישום (Logs) בצד שלכם. בקשו מהמפתח שלכם לתעד את הבקשות המגיעות מהאפליקציה כדי שתוכלו לאתר ולפתור בעיות במהירות.

8. השתמשו בכתובת URL סופית וציבורית. כתובת ה-URL של הפונקציה שלכם חייבת להיות כתובת אינטרנט ציבורית (HTTP/HTTPS). כתובות פנימיות, localhost וכתובות של רשתות פרטיות נדחות מטעמי אבטחה, והפלטפורמה אינה עוקבת אחר הפניות (redirects) — כוונו את הפונקציה ישירות לכתובת ה-URL הסופית, לא לכתובת שמפנה אליה.

מגבלות ביצוע #

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

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

הגשת תוצאה שמורה בקריאות חוזרות. כאשר ה-AI קורא לפונקציה שוב עם אותם קלטים (למשל, הלקוח שואל את אותה שאלה פעמיים), התוצאה הקודמת משמשת שוב במקום לקרוא לנקודת הקצה שלכם פעם נוספת. תוצאות שמורות נשמרות למשך עד 24 שעות, וקריאה עם קלטים שונים תמיד תפנה לנקודת הקצה שלכם מחדש.

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

מספר הרצות מרבי בפרק זמן. הגבלת קצב לאורך זמן: למשל, לכל היותר 5 הרצות בתוך 60 דקות. שימושי עבור פונקציות שקוראות לשירותי צד ג’ בתשלום או מפעילות אוטומציות כבדות יותר. יש למלא את שתי התיבות יחד (מספר הרצות וחלון זמן בדקות, עד 7 ימים).

כמה דברים שכדאי לדעת:

• המגבלות סופרות הרצות מוצלחות בלבד. קריאה שנכשלה בצד של נקודת הקצה שלכם אינה צורכת מהמכסה.
• כאשר הרצה נחסמת על ידי מגבלה, הלקוח לעולם לא נשאר תלוי באוויר — ה-AI מקבל הסבר מדוע ופועל עם המידע שכבר יש ברשותו.
• המגבלות חלות בכל מקום שבו הפונקציה רצה: צ’אטים רגילים בכל ערוץ, ופונקציות המנוהלות על ידי אוטומציה. שיחות בדיקה ב-Try Out אינן נספרות ואינן מוגבלות.

כלי בוט מובנים #

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

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

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

כלי צוות ומשימות #

כלי אנשי קשר #

כלי פגישות והזמנות #

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

כלי ידע ואינטרנט #

כלי מעקב (Follow-Up) #

כלים אלו דורשים הפעלה של מעקבים (follow-ups) בקמפיין המקושר לסוכן שלך.

מריץ פונקציות מותאמות אישית #

כלי הזמנות למסעדות (Zenchef ו-Formitable) #

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

הפעלה וכיבוי של כלים #

רוב הכלים נשלטים בכרטיסיית יכולות AI של הסוכן (או בשלב יכולות AI של הקמפיין, אם אתה עובד מקמפיין בממשק הקלאסי):

• כלי הזמנות מופעלים כאשר אתה מאפשר הזמנות ומחבר יומן — זו נשארת הגדרה ברמת הקמפיין לעת עתה, עם קישור ישיר לשלב הרלוונטי בקמפיין מתוך כרטיסיית יכולות ה-AI של הסוכן
• כלי מעקב מופעלים כאשר אתה מאפשר מעקבים
• כלי מסעדות מופעלים כאשר אתה מחבר חשבון Zenchef או Formitable
• לחיפוש אינטרנט יש מתג משלו בכרטיסיית שאלות נפוצות וידע
• ניתן לכבות כלי משימות עבור כל סוכן בנפרד באמצעות המתג אפשר ל-AI ליצור משימות (הם מופעלים כברירת מחדל; מתג המשימות הכלל-חשבוני ב-הגדרות ← פרופיל ← תכונות מכבה את כל מערכת המשימות בכל מקום)
• כלי עדכון אנשי קשר נשלטים באותה כרטיסיית יכולות AI — האם ה-AI רשאי לשנות שמות של אנשי קשר או לשמור מידע נוסף שנאסף עליהם
• כלי התראות זמינים תמיד; תיוג מתבצע אוטומטית לאחר כל תשובה של הבוט (זהו לא כלי שהבוט בוחר להפעיל)

אם ברצונך שהבוט יפסיק להשתמש בכלי מובנה ספציפי, הדרך הנקייה ביותר היא להשבית את התכונה הבסיסית (למשל, כבה הזמנות כדי להשבית את כל כלי ההזמנות).

פונקציות המנוהלות על ידי אוטומציה #

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

פונקציה מנוהלת מטופלת עבורך: השם, התיאור והשדות שלה תואמים תמיד למה שמוגדר בטריגר של האוטומציה, לכן לא ניתן לערוך או למחוק אותה מדף זה — השתמש בקישור פתח אוטומציה ושנה את האוטומציה עצמה. עם זאת, עדיין ניתן לבחור אילו סוכנים יקבלו אותה בדרך הרגילה: בכרטיסיית יכולות AI של הסוכן היא מופיעה לצד היכולות האחרות של הסוכן עם מתג הפעלה/כיבוי רגיל (אם האוטומציה שלה מושהית, השורה תציין זאת — היכולת תופעל כשהאוטומציה תופעל). כל השאר לגביה מתנהג כמו כל פונקציה מותאמת אישית אחרת: ה-AI מחליט מתי לקרוא לה, אוסף את הפרטים שהגדרת, ויכול להשתמש בתשובה של האוטומציה באותה שיחה.

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

דרישות תוכנית #

פונקציות מותאמות אישית זמינות בתוכניות הכוללות את תכונת הפונקציות המותאמות אישית. בדקו את המנוי שלכם כדי לאשר זמינות.

צעדים הבאים #

• חיבור שרתי MCP לבוט שלך — חבילה מוכנה של כלים במקום פונקציה אחת בכל פעם.
• סוכני AI — הדף הראשי של קבוצת ה-AI Studio שבה נמצאות פונקציות מותאמות אישית, ושם פונקציות מותאמות אישית מוקצות לבוט.