# שלוחת API באתר — עורך הקוד, טבלת הנתונים ושיחה מדומה

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

כתובת: https://ivr.pitronai.com/help/studio/api-extension/ · עודכן: 2026-10-11

שלוחת API של ימות שולחת כל שיחה לשרת, והשרת עונה לה מה לעשות ([המדריך של ימות למודול ה-API](https://f2.freeivr.co.il/post/77520)). באתר לא צריך שרת משלכם: כותבים את הקוד בלשונית **עורך הקוד**, לוחצים **שמירה והפעלה**, והקוד רץ מחשבון Cloudflare חינמי שלכם. באותה שלוחה יש גם את הסטודיו לבנייה בבלוקים, טבלת נתונים שעורכים כמו גיליון, ושיחה מדומה שבודקת הכול בלי טלפון.

> **לפני שמתחילים:**
> - קו מחובר לאתר, והרשאה לערוך את השלוחה.
> - שלוחה מסוג API. שלוחה חדשה כזו נוצרת מ-**חדש** ← **יצירת שלוחה** ← **בנייה מאפס**, או כשבוחרים לה את הסוג API.
> - חשבון Cloudflare חינמי משלכם, שמחברים פעם אחת: לחיצה על **חיבור ל-Cloudflare**, אישור במסך של Cloudflare, וחזרה אוטומטית לאתר.
> - ל-**יצירה עם AI** צריך מפתח Gemini אישי (בהגדרות **AI ומפתחות**).

## צעדים

1. בסייר הקבצים, היכנסו לשלוחת ה-API, למשל שלוחה 8, "רישום לשיעור". נפתחת הלשונית **הגדרת API**.
2. בראש המסך, לחצו על **עורך הקוד**. מופיעים שני אזורים: **צד ימות המשיח** ו-**צד שרת**.
3. באזור **צד שרת**, בשדה **כותרת הקוד**, תנו לקוד שם, למשל "רישום לשיעור". לפי השם הזה הקוד נשמר ומזוהה.
4. כתבו או הדביקו את הקוד בעורך. אפשר גם ללחוץ **יצירה עם AI** ולתאר במילים מה השלוחה צריכה לעשות.
5. לחצו **שמירה והפעלה** (או `Ctrl+S`). הקוד נשמר ועולה לאוויר, והשלוחה מחוברת לכתובת שלו.
6. בדקו: בתחתית העמוד, באזור **בדיקת API**, לחצו **שיחה מדומה**.

![הלשונית "הגדרת API" של שלוחה 8: ארבע הלשוניות בראש המסך, ובלשונית "עורך הקוד" האזור של ימות והאזור של הקוד.](https://ivr.pitronai.com/help/_assets/shot-api-extension-code-3eebe2f842.webp)

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

## מה רואים בסוף

- ההודעה "הקוד באוויר והשלוחה חוברה לכתובת שלו ✓". בשמירות הבאות: "הקוד עודכן ופעיל ✓".
- מתחת לכותרת מופיעה **הכתובת של הקוד:**, ולידה **השלוחה מחוברת לכתובת הזו**.
- בהגדרות השלוחה (**צד ימות המשיח**) הכתובת כבר כתובה. אין צורך להעתיק אותה.

## ארבע הלשוניות של שלוחת API

| לשונית | מה עושים בה |
|---|---|
| **סטודיו** | בונים את השיחה בבלוקים על מפה. ראו [בניית תהליך שיחה בסטודיו](https://ivr.pitronai.com/help/studio/build-a-flow/) |
| **עורך הקוד** | ההגדרות של השלוחה, הקוד שעונה לשיחות, והבדיקות |
| **טבלת הנתונים** | הטבלאות שהקוד שומר, לעריכה כמו גיליון |
| **צפייה בנתונים** | מה נאסף: כמה, מתי, מה ענו ומי התקשר |

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

## "צד ימות המשיח": ההגדרות והבדיקות המקדימות

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

## "צד שרת": הקוד שעונה לשיחות

- ****כותרת הקוד**** — השם של הקוד. החץ שליד השדה פותח את הקודים הקיימים שלכם. בחירה בקוד קיים מחברת את השלוחה אליו, וכך כמה שלוחות עובדות עם אותו קוד.
- ****מסד הנתונים**** — המסד שהקוד שומר בו. ברירת המחדל משותפת לכל הקודים שלכם, ואפשר לבחור מסד אחר.
- ****סודות**** — טוקנים ומפתחות שהקוד צריך, למשל הטוקן של הקו. הם נשמרים בחשבון Cloudflare שלכם, ולא כתובים בקוד.
- ****יצירה עם AI**** ו-**שינוי הקוד עם AI** — כותבים במילים מה צריך, ומקבלים קוד והגדרות לבדיקה לפני השמירה.
- **שפה** — JavaScript, TypeScript או Python (ניסיוני), בבורר שמעל העורך.
- **בדיקות תאימות** — מתחת לעורך. קוד שנכתב לסביבה אחרת (PHP, Node או Python) מזוהה, ו-**המר לקוד תואם** מציע גרסה שתעבוד כאן.
- ****גרסאות קוד**** — כל שמירה עם שינוי שומרת את הגרסה שלפניה, עד 10 אחורה. **צפייה** ואז **שחזור לעורך**, ו-**שמירה והפעלה** מחזירה אותה לאוויר.

### קיצורי המקלדת בעורך הקוד

| מקשים | מה הם עושים |
|---|---|
| `Ctrl+S` | **שמירה והפעלה** |
| `Ctrl+K` | לוח הפקודות: שמירה, סודות, AI, גרסאות, תיקונים מהירים |
| `Ctrl+F` | **חיפוש והחלפה בקוד** |
| `Ctrl+Space` | השלמה של מה שמקלידים |

## בדיקה בלי טלפון: "שיחה מדומה"

1. בלשונית **עורך הקוד**, גללו לאזור **בדיקת API** ולחצו **שיחה מדומה**. נפתח החלון **שיחה מדומה**.
2. בשדה **מתקשרים מהמספר** אפשר לשנות את המספר. תחת **השיחה מתחילה** בחרו אם להתחיל בשלוחה עצמה, או **בתחילת הקו, כמו מתקשר אמיתי**.
3. לחצו **התקשרות**. מימין מופיעים המקשים ומה המערכת מחכה לו, ומשמאל **מה קורה בשיחה**: מה המתקשר שומע, ומה נשלח לקוד ומה חזר ממנו.
4. הקישו במקשים ולחצו **שליחה**. **לא מקיש כלום** מדמה מתקשר שלא הקיש.
5. בסיום, **שיחה חדשה** מתחיל שוב, ו-**ניתוק** מסיים באמצע.

![החלון "שיחה מדומה" באמצע שיחה לשלוחה 8: המקשים מימין, ומשמאל ההודעה שהמתקשר שומע והפנייה לקוד עם התשובה שחזרה.](https://ivr.pitronai.com/help/_assets/shot-api-extension-phone-sim-ff40e2b596.webp)

1. הטלפון: מה המערכת מחכה לו עכשיו, המקשים, ו-**שליחה**.
2. **מה קורה בשיחה** — מה המתקשר שומע, בסדר שבו זה קורה.
3. כרטיס של פנייה לקוד: מה נשלח, מה חזר, ותקלות אם היו.

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

## בדיקה בשיחה אמיתית: "בדיקת API"

1. בלשונית **עורך הקוד**, באזור **בדיקת API**, לחצו **התחל בדיקת API**. נפתח **לפני שמתחילים**, עם הסבר מה יקרה.
2. אם רוצים, הזינו מספר בשדה **תעדו רק שיחות מהמספר (רשות):**, ולחצו **התחל ובצע שיחת בדיקה**.
3. מופיעה ההודעה "מצב בדיקה פעיל — חייגו עכשיו לשלוחה", עם מספר הקו והמקשים להגעה לשלוחה. חייגו מהטלפון.
4. אחרי השיחה רואים מה ימות שלחה, מה הקוד ענה, ואיפה הייתה תקלה. **אבחון מעמיק (יומן ימות + קבצים)** בודק גם את היומן של ימות ואת הקבצים שהתשובה מזכירה.
5. לחצו **סיים בדיקה**. ההגדרות המקוריות של השלוחה חוזרות, ומופיעה ההודעה "הבדיקה הסתיימה וההגדרות המקוריות הוחזרו".

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

## טבלת הנתונים וצפייה בנתונים

****טבלת הנתונים**** מציגה את הטבלאות שהקוד או התבנית שומרים, כמו גיליון:

- לחיצה על תא עורכת אותו. `Enter` שומר, `Esc` מבטל.
- **שורה חדשה** מוסיף שורה, ו-**חיפוש בטבלה** מסנן.
- **ייבוא מקובץ** טוען שורות מאקסל או מ-CSV. טבלה שעוד לא נוצרה (לפני השיחה הראשונה) אפשר ליצור עם **יצירת הטבלה עכשיו**, ואז לטעון אליה נתונים.
- בתפריט **ייצוא ופעולות נוספות**: **ייצוא לאקסל (xlsx)** ו-**ייצוא ל-CSV**.

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

## פיתוחים אישיים ו"API של ימות"

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

בלשונית **API של ימות** יש את כל הפעולות של ה-API של ימות: מה כל פעולה עושה, אילו שדות היא מקבלת, הכתובת המלאה וקוד מוכן להעתקה. כשהחיבור של הקו שמור בדפדפן ולא בשרת, בעל הקו יכול גם להריץ פעולה מול הקו. פעולה רגישה, כמו מחיקה, רצה רק אחרי שמקלידים את שם הפקודה בשדה **שם הפקודה**.

## אם משהו לא עבד

### "תנו לקוד כותרת — לפיה הוא נשמר ומזוהה גם אחרי שינויים בקו או בשלוחה"

השדה **כותרת הקוד** ריק. כתבו בו שם ושמרו שוב.

### "כבר יש קוד בכותרת הזו — בחרו כותרת אחרת, או בחרו אותו מהרשימה כדי לחבר אליו את השלוחה"

הכותרת תפוסה בקוד אחר שלכם. בחרו שם אחר. אם רציתם את אותו קוד, פתחו את הרשימה שליד **כותרת הקוד** ובחרו אותו.

### "הקוד נשמר, אך ההפעלה נכשלה — הגרסה הקודמת (אם הייתה) עדיין פעילה."

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

### "החיבור ל-Cloudflare פג או בוטל."

הקוד עדיין רץ, רק ההרשאה לנהל אותו מהאתר פגה. לחצו **חיבור מחדש ל-Cloudflare (לחיצה אחת)**.

### "השלוחה נשארה מחוברת לשרת הבדיקה."

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

### "בזמן בדיקה פעילה ההגדרות נעולות — סיימו את הבדיקה כדי לערוך."

יש בדיקת API פעילה. לחצו **סיים בדיקה**, ואז אפשר לערוך.

### בשיחה המדומה מופיע "לא ענה בזמן" או "אין חיבור"

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

## שאלות נפוצות

### מה ההבדל בין "שיחה מדומה" ל"בדיקת API"?

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

### אפשר לחבר כמה שלוחות לאותו קוד?

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

### איפה נשמרים הנתונים והקוד?

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