> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# חיבורי API

> הפכו כל API מסוג HTTP לפונקציה שהסוכן שלכם יכול לקרוא לה במהלך שיחה — הדביקו פקודת cURL ותנו לאשף לעשות את השאר.

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

יש שתי דרכים לבנות חיבור: להדביק משהו שהאשף יכול לנתח,
או להגדיר את החיבור ידנית.

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

<Steps>
  <Step title="לחצו על חיבור API חדש">
    תיבת הדו-שיח נפתחת באשף. הדביקו בתיבה דוגמה של **פקודת cURL**,
    **מפרט OpenAPI/Swagger**, **ייצוא Postman**, **ממשק TypeScript**,
    או **סכמת Zod**.
  </Step>

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

  <Step title="אשרו את השדות המודגשים">
    ההגדרה שהוסקה נפתחת עם השדות המשוערים מודגשים
    לבדיקה. התאימו שמות, תיאורים וסוגי פרמטרים כדי שהסוכן
    יבין מתי וכיצד להפעיל את הפונקציה — התיאור
    הוא מה שהמודל קורא.
  </Step>

  <Step title="אמתו ושמרו">
    השמירה מפעילה תחילה בקשת בדיקה חיה מול נקודת הקצה שלכם. אם
    הבקשה נכשלת, החיבור לא נשמר — תקנו את כתובת ה-URL, כותרות האימות
    או הגוף, ונסו שוב. במקרה של הצלחה החיבור נשמר
    עם תג **מאומת**.
  </Step>
</Steps>

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

## הגדרה ידנית

לחצו על **הגדרה ידנית →** באשף (או על **רוצים שה-AI יסיק זאת?
נסו את האשף →** כדי לחזור). הבונה הידני כולל שני עורכים:

* **חזותי** — שדות טופס עבור שם התצוגה, שם הפונקציה, בקשת
  **URL**, **שיטה** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), מותאמות אישית
  **כותרות**, וסכמת הפרמטרים (**הוספת מאפיין** עבור כל
  ארגומנט שהסוכן יכול לספק).
* **JSON** — אותה הגדרה כ-JSON גולמי, להדבקה או לכוונון עדין
  של מפרט כלי ישירות.

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

<Tip>
  תנו לפרמטרים תיאורים בשפה פשוטה ("כתובת האימייל של הלקוח,
  למשל [jane@example.com](mailto:jane@example.com)"). הסוכן בוחר ארגומנטים מתוך תיאורים אלה
  בזמן אמת, במהלך השיחה.
</Tip>

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

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

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

## צירוף לסוכן

הוסיפו את החיבור לסוכן בקטע חיבורי ה-API של הבונה
([בניית סוכן](/he/guides/build-an-agent)). הרשימה מציגה אילו סוכנים
משתמשים בכל חיבור, כדי שתוכלו לראות במבט חטוף על מה שינוי משפיע.

## השלבים הבאים

<CardGroup cols={2}>
  <Card title="שילובי כלים באמצעות API" icon="code" href="/he/guides/build-tool-integration">
    צרו ונהלו את אותן התחברויות באופן פרוגרמטי.
  </Card>

  <Card title="חיבור אפליקציות" icon="cable" href="/he/guides/connect-apps">
    התחברויות מוכנות מראש ל-Google, Slack, HubSpot, Salesforce ו-Cal.com.
  </Card>

  <Card title="הוספת שרת MCP" icon="server" href="/he/guides/mcp-servers">
    חשפו שרת כלים שלם לסוכנים שלכם.
  </Card>

  <Card title="מדריך העזר ל-API של שילובים" icon="book" href="/api-reference/integrations">
    כל שדה במשאב השילוב.
  </Card>
</CardGroup>