Skip to main content
חיבורי API הם פונקציות HTTP מותאמות אישית שהסוכנים שלכם יכולים להפעיל במהלך שיחה — לחפש הזמנה, ליצור פנייה, לאחזר סטטוס חשבון מהמערכת העורפית שלכם. הגדירו את נקודת הקצה פעם אחת תחת חיבורים → APIs (/dashboard/api-connections); סוכנים שהחיבור מצורף אליהם יכולים להפעיל אותו בכל פעם שהשיחה מצריכה זאת. יש שתי דרכים לבנות חיבור: להדביק משהו שהאשף יכול לנתח, או להגדיר את החיבור ידנית.

​
הדרך המהירה: הדבקה וניתוח

1

לחצו על חיבור API חדש

תיבת הדו-שיח נפתחת באשף. הדביקו בתיבה דוגמה של פקודת cURL, מפרט OpenAPI/Swagger, ייצוא Postman, ממשק TypeScript, או סכמת Zod.
2

לחצו על ניתוח

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

אשרו את השדות המודגשים

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

אמתו ושמרו

השמירה מפעילה תחילה בקשת בדיקה חיה מול נקודת הקצה שלכם. אם הבקשה נכשלת, החיבור לא נשמר — תקנו את כתובת ה-URL, כותרות האימות או הגוף, ונסו שוב. במקרה של הצלחה החיבור נשמר עם תג מאומת.
אם האשף לא יכול למצוא כתובת URL של בקשה בתוכן שהדבקתם, הוא יודיע על כך — כללו נקודת קצה מלאה של http(s) ונסו שוב.

​
הגדרה ידנית

לחצו על הגדרה ידנית → באשף (או על רוצים שה-AI יסיק זאת? נסו את האשף → כדי לחזור). הבונה הידני כולל שני עורכים:
  • חזותי — שדות טופס עבור שם התצוגה, שם הפונקציה, בקשת URL, שיטה (POST, GET, PUT, PATCH, DELETE), מותאמות אישית כותרות, וסכמת הפרמטרים (הוספת מאפיין עבור כל ארגומנט שהסוכן יכול לספק).
  • JSON — אותה הגדרה כ-JSON גולמי, להדבקה או לכוונון עדין של מפרט כלי ישירות.
חלונית בקשת בדיקה (אופציונלית) מאפשרת לכם להפעיל את הבקשה שהוגדרה לפני השמירה, ומציגה את הסטטוס, זמן ההשהיה ותצוגה מקדימה של התגובה. אמתו ושמרו תמיד מפעיל בדיקה זו ושומר רק במקרה של הצלחה.
תנו לפרמטרים תיאורים בשפה פשוטה (“כתובת האימייל של הלקוח, למשל jane@example.com”). הסוכן בוחר ארגומנטים מתוך תיאורים אלה בזמן אמת, במהלך השיחה.

​
ניהול החיבורים שלכם

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

​
צירוף לסוכן

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

​
השלבים הבאים

שילובי כלים באמצעות API

צרו ונהלו את אותן התחברויות באופן פרוגרמטי.

חיבור אפליקציות

התחברויות מוכנות מראש ל-Google, Slack, HubSpot, Salesforce ו-Cal.com.

הוספת שרת MCP

חשפו שרת כלים שלם לסוכנים שלכם.

מדריך העזר ל-API של שילובים

כל שדה במשאב השילוב.