Open in
עזיבת ThunderPhone
ייצאו סוכן כקבצים פתוחים, בנו אותו מחדש ב-LiveKit Agents, Pipecat, Vapi או Retell באמצעות מיומנות של סוכן קוד, והורידו את היסטוריית השיחות וההקלטות שלכם.
באפשרותכם לעזוב את ThunderPhone בכל עת שתרצו. ניתן לייצא כל סוכן כקובץ ZIP של קבצים פתוחים, ללא עלות, ומיומנות מסייעת לסוכן הקוד שלכם לבנות אותו מחדש ב-LiveKit Agents, Pipecat, Vapi או Retell. דף זה מפרט מה תוכלו לקחת אתכם, כיצד לייצא אותו ומה תצטרכו לבצע מחדש בצד השני.
מה תוכלו לקחת אתכם
| מה | כיצד |
|---|---|
| סוכן: הוראות, כלים, מספרי העברה, שלבים, הגדרות, ניתוב מספרים וובהוקים | ייצוא הסוכן, קובץ ZIP אחד לכל סוכן |
| קובצי הידע של הסוכן | בתוך ייצוא הסוכן |
| היסטוריית שיחות ותמלילים | ייצוא השיחות, עד 1,000 שיחות לכל בקשה |
| הקלטות | הקלטה אחת לכל בקשה, לפי שיחה |
| מספרי טלפון אצל ספק התקשורת שלכם | הם מעולם לא עזבו את ספק התקשורת שלכם. ראו מספרי טלפון |
ייצוא סוכן
ב-Zeus
פתחו את הסוכן ועברו להגדרות שלו (טיפול בשיחות בעורך הסוכן). בתחתית, תחת ייצוא, העתקה או מחיקה, בחרו ייצוא. קובץ ה-ZIP יורד למחשב שלכם.
באמצעות ה-API
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipקובץ ה-ZIP נבנה כשאתם מבקשים אותו. כל מי שיכול לקרוא את הסוכן יכול
לייצא אותו. ידע, מספרים ו-webhooks נכללים רק כאשר פרטי הגישה יכולים לקרוא
אותם: אסימון OAuth זקוק ל-knowledge:read,
numbers:read ו-integrations:read, ו-webhooks דורשים גם מנהל או
בעלים. חלק שלא נכלל מופיע תחת omitted ב-manifest.json.
ה-API מחזיר 429 מעל 30 ייצואים בדקה.
| פרמטר שאילתה | תיאור |
|---|---|
include_url_paths | true שומר את הנתיב של כל URL בייצוא, למשל נקודת הקצה של כלי. כברירת מחדל, כל URL נחתך עד למארח שלו. שמות משתמשים, סיסמאות ומחרוזות שאילתה מוסרים מכתובות URL בכל מקרה |
השתמשו ב-include_url_paths=true כאשר אתם עומדים לבנות מחדש את הסוכן
במקום אחר, מפני שנקודות הקצה של הכלים נדרשות שם. השאירו אותו כבוי עבור
עותק שאתם מתכננים לשתף.
מה מכיל קובץ ה-ZIP
| קובץ | תוכן |
|---|---|
manifest.json | הפורמט (thunderphone.agent-export/v1), מה נכלל, ורשימת omitted שמציינת כל פריט שהושמט ואת הסיבה לכך |
agent.json | הסוכן כפי ש-GET /v1/agents/{agent_id} מחזיר אותו, ללא פרטי גישה |
prompt.md | ההנחיות הפעילות |
knowledge/index.json והקבצים שלצידו | הידע של הסוכן. כל מסמך הוא הקובץ המקורי כאשר הוא שמור, או הטקסט שחולץ ממנו אחרת |
numbers.json | המספרים המנותבים לסוכן זה, נכנסים ויוצאים, עם כל גרסה או וריאנט מוצמד |
webhooks.json | נקודות הקצה של webhook המוגדרות עבור סוכן זה, ללא הסודות שלהן |
README.md | תיאור כל קובץ |
קובץ ידע שגדול מ-25 MB מושמט, וכך גם כל דבר מעבר ל-100 MB עבור
הייצוא כולו. כל אחד מהם מופיע ב-manifest.json עם נקודת הקצה שמורידה אותו,
GET /v1/knowledge/documents/{document_id}/original.
מה לעולם לא נכלל
- ערכי פרטי גישה. הכותרות של כלי מפורטות לפי שם בלבד. ערכי כותרות הם לכתיבה בלבד ב-ThunderPhone: אף תגובת API לא מחזירה אותם, ולכן גם שום ייצוא לא יכול להחזיר אותם. הזינו אותם מחדש בצד השני. זה כולל פרטי גישה ש-ThunderPhone מאחסן כפרטי גישה. ההנחיות וקובצי הידע שלכם מועתקים בדיוק כפי שכתבתם או העליתם אותם, לכן אם מפתח הודבק אי פעם בהנחיה או במסמך, הוא נמצא בקובץ ה-ZIP. בדקו לפני שאתם משתפים אותו.
- היסטוריית שיחות והקלטות. להן יש ייצואים נפרדים; ראו היסטוריית שיחות והקלטות.
- היסטוריית גרסאות. הייצוא מכיל את הסוכן כפי שהוא פעיל כעת. גרסאות
קודמות נשארות רשומות ב-
GET /v1/agents/{agent_id}/versions. - סוכנים אחרים שאליהם סוכן זה מעביר שיחות. ייצאו כל אחד מהם באותה דרך.
מעבר לפלטפורמה אחרת
המיומנות migrate-off-thunderphone מנחה את סוכן הקוד שלכם לאורך
המעבר. התקינו את מיומנויות ThunderPhone:
npx skills add thunderphone/skillsלאחר מכן, בקשו מסוכן הקוד שלכם להעביר סוכן מ-ThunderPhone וציינו את היעד: LiveKit Agents, Pipecat, Vapi או Retell. המיומנות מורידה את הייצוא, מבקשת מכם כל פרט גישה, בונה מחדש את הסוכן על סמך מיפוי ליעד זה, ובודקת אותו שם לפני העברת מספר כלשהו. ההמרה מתבצעת בסוכן הקוד שלכם, באמצעות המפתחות שלכם. ThunderPhone לעולם לא כותבת לחשבון שלכם בפלטפורמה אחרת.
מה עובר, כקבצים שהמיומנות ממפה עבורכם:
- הוראות, כולל הוראות ושלבים משותפים.
- כלים: אותה נקודת קצה, שיטה וסכמת פרמטרים. השדה
request_formatשל כל כלי מתעד את מבנה הגוף שנקודת הקצה שלכם מצפה לו. - מספרי העברה והגדרות סיום השיחה ולוח המקשים.
- קובצי ידע.
- הגדרות תא קולי, שקט ואורך שיחה.
- אילו מספרים הסוכן עונה להם ומבצע מהם שיחות.
מה עליכם לבצע מחדש בצד השני:
- ספקי דיבור, מודל שפה וקול. אתם בוחרים אותם ביעד. אין ערובה לכך שקול, או אופן הצליל של שיחה, יתאימו.
- פרטי גישה. ערכי כותרות של כלים וסודות של וובהוקים.
- טלפוניה. אופן הגעת המספרים לסוכן מוגדר אחרת בכל פלטפורמה.
- שלבים והעברות. יעד עם תכונת זרימה או העברה מקבל אותם בבנייה מחדש שם. במקומות אחרים, המיומנות משלבת את השלבים בהוראות ומודיעה לכם.
- הגדרות ThunderPhone ללא מקבילה. הגדרות אינטליגנציה, שמיעה ומהירות תגובה, כלי הדוא"ל והודעות הטקסט המובנים, ודירוג שיחות, סיכומים ותוויות תוצאה אינם עוברים אלא אם תבנו אותם מחדש.
- חתימות בקשות. ThunderPhone חותמת על בקשות הכלים והוובהוקים שהיא שולחת. פלטפורמה אחרת חותמת בדרך משלה, לכן נקודת קצה שמאמתת את חתימת ThunderPhone זקוקה לבדיקה חדשה.
- בדיקה. בדקו את הסוכן שנבנה מחדש ביעד לפני העברת מספר.
השאירו את סוכן ThunderPhone במקומו עד שהסוכן החדש יעבור את הבדיקות שלכם. זוהי הדרך שלכם לחזור.
מספרי טלפון
העבירו מספרים בסוף, לאחר שהסוכן החדש עובר את הבדיקות שלו.
- מספר אצל ספק התקשורת שלכם (חיבור VoIP)
נשאר אצל אותו ספק. הפנו אותו לפלטפורמה החדשה במסוף של ספק התקשורת שלכם.
לאחר מכן בחרו שחרור במספר ב-ThunderPhone והשאירו את
לבטל גם את המספר הזה בחשבון ה-… שלי ללא סימון: המספר מנותק
מ-ThunderPhone ונשאר בחשבון שלכם אצל ספק התקשורת. דרך ה-API,
שחררו אותו באמצעות
DELETE /v1/phone-numbers/{phone_number_id}?confirm=trueואל תשלחו אתrelease_at_provider. - מספר שסופק על ידי ThunderPhone. צרו קשר עם התמיכה לפני שתשחררו מספר שברצונכם לשמור. שחרור מספר של ThunderPhone הוא סופי: הוא חוזר למאגר ועשוי לעבור ללקוח אחר.
היסטוריית שיחות והקלטות
אלה נפרדות מייצוא הסוכן.
- שיחות.
GET /v1/calls/exportמחזיר עד 1,000 שיחות לכל בקשה כ-CSV (מטא-נתונים) או כ-JSON (עם תמלילים). סננו לפיagent_idודפדפו בהיסטוריה שלכם באמצעותstart_dateו-end_date. כותרת התגובהX-Truncatedהיאtrueכאשר נמצאו יותר שיחות מאלה שהוחזרו. - הקלטות.
GET /v1/calls/{call_id}/audioמחזיר כתובת URL קצרת-תוקף להקלטה של שיחה אחת. אין הורדה מרוכזת של הקלטות.
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o calls-2026-10.jsonהעלות
כלום. ייצוא הסוכן, ייצוא השיחות והורדות ההקלטות הם בחינם. ThunderPhone פועל במודל של תשלום לפי שימוש, ללא מנוי וללא עמלה לכל משתמש. החיוב עבור מספר ThunderPhone נפסק כשאתם משחררים אותו.
לאחר העזיבה
אין תקופה קצובה. באפשרותכם לסיים את ההסכם באמצעות הודעה בכתב אל legal@thunderphone.com, שתישלח מכתובת האימייל הניהולית של החשבון או מערוץ מאומת אחר. אי-תשלום עשוי להביא להשעיית השירות; כשלעצמו, הוא לעולם אינו מסיים את ההסכם ואינו גורם למחיקת נתוני הלקוח. לגבי נתונים, התנאים קובעים: "לאחר סיום רשמי, הספק יחזיר או ימחק את נתוני הלקוח בתוך שישים (60) ימים, בכפוף לזכויות הייצוא של הלקוח, למחזורי גיבוי, לצווי שימור משפטיים, לשמירה הנדרשת על פי דין, ל-DPA ולכל BAA שנחתם."
הטקסט המלא נמצא ב- תנאי השירות, תחת תקופת השירות; השעיה; סיום. התנאים הם הקובעים; זהו סיכום.