---
title: "השתמשו ב-ThunderPhone עם Zapier"
description: "חברו את אפליקציית ThunderPhone ב-Zapier לארגון שלכם ובנו Zap שפועל בכל פעם ששיחה מסתיימת."
---

[Zapier](https://zapier.com) מחבר אפליקציות באמצעות תהליכי עבודה אוטומטיים בשם
Zaps. אפליקציית ThunderPhone ב-Zapier מוסיפה:

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

מצאו אותה ב-[ThunderPhone ב-Zapier](https://zapier.com/apps/thunderphone/integrations).
לסקירה של שתי הדרכים להשתמש ב-Zapier עם ThunderPhone, עיינו ב-
[דף השילוב עם Zapier](https://thunderphone.com/integrations/zapier).

## חברו את הארגון שלכם

האפליקציה מתחברת באמצעות OAuth. אתם נכנסים ל-ThunderPhone ומאשרים
גישה לארגון אחד, ללא העתקת מפתח API אל Zapier.

<Steps>
  <Step title="הוספת שלב ThunderPhone">
    בעורך Zap, חפשו את **ThunderPhone** (מוצג עם תווית Beta)
    ובחרו טריגר או פעולה. כאשר Zapier מבקש חשבון, חברו חשבון חדש. Zapier פותח
    חלון כניסה ל-ThunderPhone.
  </Step>
  <Step title="כניסה ובחירת הארגון">
    היכנסו, בדקו את ההרשאות המבוקשות, בחרו את הארגון ובחרו
    **אישור**. האפליקציה מבקשת לקרוא את הסוכנים ומספרי הטלפון שלכם,
    לקרוא ולכתוב שיחות וקמפיינים, לנהל שילובים כגון נקודות קצה של webhook,
    ולראות את כתובת האימייל של החשבון שלכם.
  </Step>
  <Step title="בדיקת שם החיבור">
    Zapier נותן לחיבור את שם הארגון שאישרתם, כך שתוכלו
    להבחין בין חיבורים כאשר אתם שייכים ליותר מארגון אחד.
  </Step>
</Steps>

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

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

## יצירת Zap ראשון

Zap זה מוסיף שורה ל-Google Sheet בכל פעם ששיחה מסתיימת.

<Steps>
  <Step title="בצעו שיחה לשימוש כנתוני דוגמה">
    פתחו סוכן בבנאי, לחצו על **שיחה**, וסיימו את השיחה. שיחות בדיקה
    בבנאי מפעילות את האירוע השיחה הושלמה, ולכן פעולה זו מספקת לטריגר שיחה
    עדכנית לטעינה.
  </Step>
  <Step title="הוסיפו את הטריגר">
    בחרו ב-**ThunderPhone** כאפליקציית הטריגר, הגדירו את האירוע כ-**השיחה
    הושלמה**, ובחרו את חיבור ThunderPhone שלכם. בדקו את הטריגר.
    Zapier טוען את השיחות האחרונות שהושלמו כדוגמאות, באותו מבנה של אירוע
    חי.
  </Step>
  <Step title="הוסיפו Google Sheets">
    הוסיפו פעולה של Google Sheets שיוצרת שורה בגיליון אלקטרוני. בחרו גיליון
    עם שורת כותרות, ואז מפו כל עמודה לשדה מהטריגר (ראו את הטבלה למטה).
  </Step>
  <Step title="פרסמו את ה-Zap">
    פרסמו והפעילו את ה-Zap. הפעלתו יוצרת נקודת קצה של webhook בארגון
    ThunderPhone שלכם בשם **Zapier: השיחה הושלמה**. כיבוי ה-Zap מוחק את
    נקודת הקצה הזו.
  </Step>
  <Step title="בדקו אותו">
    בצעו שיחת בדיקה נוספת בבנאי. כשהיא מסתיימת, ה-Zap פועל ומופיעה שורה.
  </Step>
</Steps>

עמודות שימושיות:

| עמודה | שדה השיחה הושלמה |
|---|---|
| מזהה שיחה | מזהה שיחה |
| סוכן | שם הסוכן |
| כיוון | כיוון |
| מאת | מספר מקור |
| אל | מספר יעד |
| התחילה | התחילה ב- |
| הסתיימה | הסתיימה ב- |
| משך (שניות) | משך בשניות |
| סטטוס | סטטוס |
| סיבת סיום | סיבת סיום |
| קישור לשיחה | הקלידו `https://app.thunderphone.com/dashboard/call-history/`, ולאחר מכן הוסיפו את מזהה השיחה |

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

האירוע יכול לכלול גם את התמלול, כרשימת תורות, וכתובת URL של הקלטה,
קישור חתום שפג תוקפו. הוסיפו אותם רק אם הגיליון זקוק להם. תמלילי
שיחות, סיכומים והקלטות עשויים להכיל מידע אישי או רפואי. שלחו אותם רק
לאפליקציות שהארגון שלכם מורשה להשתמש בהן עבור נתונים אלה, במסגרת BAA
כאשר מעורב מידע רפואי, ושמרו רק את השדות שאתם זקוקים להם. ראו
[`telephony.complete` / `web.complete`](/he/webhooks/call-complete) עבור כל
שדה.

<Note>
  כל מסירה חתומה. האפליקציה בודקת את ה-HMAC של
  `X-ThunderPhone-Signature` מול הסוד של נקודת הקצה לפני שה-Zap פועל,
  ועוצרת כל דבר שאינו חתום או אינו תקין. אם Zapier אינו מקבל מסירה,
  ThunderPhone מנסה שוב למשך עד 24 שעות. ראו [סקירת Webhooks](/he/webhooks/overview).
</Note>

## טריגרים, פעולות וחיפוש

**שיחה דורגה** מספק את מזהה השיחה, מזהה הסוכן, שם הסוכן והציון: מזהה הציון, ניקוד, תוצאת השיחה, סיכום, מודל המדרג ומועד הדירוג. הפעלת Zap יוצרת נקודת קצה בשם **Zapier: שיחה דורגה**. אפשר לדרג שיחה יותר מפעם אחת, וכל הרצת דירוג שהסתיימה מפעילה את הטריגר. ראו
[`call.graded`](/he/webhooks/events).

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

**ביצוע שיחה יוצאת** מקבל:

| שדה | משמעות |
|---|---|
| סוכן | סוכן שמור. הרשימה הנפתחת מציגה את הסוכנים שלכם. |
| מספר יעד | יעד בפורמט E.164, כגון `+14155552671`. |
| מספר מקור | הרשימה הנפתחת מציגה רק מספרים שמופעלים לשיחות יוצאות. |
| משתנים | אובייקט JSON אופציונלי של ערכים עבור מצייני מיקום בהנחיית הסוכן. |
| מפתח אידמפוטנטיות | מזהה יציב מהטריגר או מרשומת המקור. נדרש. |

הפעולה מחזירה את מזהה השיחה, הסטטוס והפעלה חוזרת אידמפוטנטית.

**הוספת אנשי קשר לקמפיין** מוסיפה אנשי קשר לקמפיין טיוטה. עבור איש קשר
אחד, מלאו את **מספר טלפון** בפורמט E.164, ובאופן אופציונלי את **משתני איש
קשר**, אובייקט JSON שהמאפיינים שלו הופכים למשתני קמפיין. עבור אצווה, מלאו
את **JSON של אנשי קשר** במערך של עד 5,000 אובייקטים. כל אובייקט דורש
`phone_number`, ושאר המאפיינים שלו הופכים למשתנים. השלב נכשל כאשר כל אנשי
הקשר נדחים, ומגדיר **הצלחה חלקית** כאשר רק חלק מהם נדחים.

**התחלת קמפיין** מפעילה או ממשיכה קמפיין שיש בו לפחות איש קשר אחד. הפעולה
דורשת **הסכמה לחיוב**. ראו
[קמפיינים יוצאים](/he/guides/outbound-campaigns).

## לפני ש-Zap מבצע שיחות

ביצוע שיחה יוצאת והתחלת קמפיין מחייגים למספרי טלפון אמיתיים ומתחילים
שיחות בתשלום.

- אם ThunderPhone מבקשת מהארגון שלכם לאשר שהשיחות היוצאות שלו עומדות
  ב-TCPA ובחוקי חיוג אחרים, מנהל מערכת חייב לתעד את האישור הזה בלוח הבקרה
  לפני ש-Zap יכול להתחיל שיחות.
- מספר המקור חייב להיות מופעל לשיחות יוצאות. מספרים שאתם מביאים מספק
  התקשורת שלכם מתאימים לאחר אימותם. מספרים שמסופקים על ידי ThunderPhone
  מתחילים כמיועדים לשיחות נכנסות בלבד, ותוכלו לבקש עבורם גישה לשיחות
  יוצאות בלוח הבקרה. ראו [קבלת מספר טלפון](/he/guides/get-a-phone-number).
- ביצוע שיחה יוצאת דורש **מפתח אידמפוטנטיות**. מפו מזהה יציב מהטריגר או
  מרשומת המקור, כגון מזהה האירוע של ThunderPhone או מזהה רשומה ב-CRM.
  אם Zapier מנסה מחדש את השלב, ThunderPhone מזהה את המפתח ומחזירה את
  השיחה המקורית במקום לבצע שיחה שנייה. הימנעו מחותמות זמן, ערכים אקראיים
  או ממזהה ה-Zap בלבד.
- התחלת קמפיין דורשת **הסכמה לחיוב**, המאשרת שה-Zap רשאי להתחיל שיחות
  יוצאות בתשלום בחשבון שלכם.
- הארגון שלכם אחראי לקבלת הסכמה לחייג לכל מספר ולעמידה בחוקי החיוג
  החלים. ראו [חוקי שיחות יוצאות](/he/guides/outbound-calling-laws).

מפתח אידמפוטנטיות הוא ייחודי בכל הארגון שלכם ויכול להכיל עד 128 תווים.
שימוש חוזר במפתח עם סוכן, מספר או משתנים שונים נכשל עקב התנגשות, לכן אם
שני Zaps יכולים לחייג לגבי אותה רשומה, תנו לכל Zap קידומת קבועה משלו לפני
מזהה הרשומה.
[ביצוע שיחות יוצאות](/he/guides/place-outbound-calls) מתאר את ה-API שמאחורי
פעולה זו.

## דוגמאות ל-Zaps

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

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

## פתרון בעיות

**שלב נכשל עם שגיאת הרשאה.** חברו מחדש את החיבור של ThunderPhone
ב-Zapier ואשרו מחדש. חיבור מפסיק לפעול כאשר האדם שחיבר אותו מבטל אותו
ב-ThunderPhone תחת **ארגון → מפתחות → אפליקציות מורשות**, כאשר אותו אדם
עוזב את הארגון, או אם חולפים 30 ימים ללא רענון אסימון מוצלח. ראו
[חיבור באמצעות OAuth](/he/guides/oauth).

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

**ברצונכם לנתק את היישום.** כבו את ה-Zaps של ThunderPhone לפני שאתם
מבטלים את החיבור, מכיוון שכיבוי Zap מוחק את נקודת הקצה שלו ודורש חיבור
פעיל. אם ביטלתם קודם, מחקו את נקודת הקצה שנותרה
**Zapier: …** באמצעות `DELETE /v1/developer/webhook-endpoints/{id}`
ובעזרת מפתח API של מנהל מערכת. ראו [נקודות קצה של ווובהוקים](/he/webhooks/endpoints).

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

**הגורם המפעיל הפסיק לפעול.** לכל Zap עם גורם מפעיל של ThunderPhone יש
נקודת קצה אחת של ווובהוק בארגון שלכם, בשם **Zapier: שיחה הושלמה** או
**Zapier: שיחה קיבלה ציון**. היא נוצרת כאשר ה-Zap מופעל ונמחקת כאשר הוא
נכבה. השאירו אותה כפי שהיא. אם היא נערכה או נמחקה ב-ThunderPhone, כבו
והפעילו שוב את ה-Zap כדי ליצור נקודה חדשה.
בעזרת מפתח API של מנהל מערכת,
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
מציג ניסיונות מסירה אחרונים.

<Note>
  רוצים שהסוכן ישתמש בפעולות של Zapier במהלך שיחה במקום אחריה?
  חברו נקודת קצה של Zapier MCP תחת **חיבורים → MCP**. ראו
  [שרתי MCP](/he/guides/mcp-servers). כדי לשלוח את אותם אירועי שיחה לשרת
  שלכם, ראו [נקודות קצה של ווובהוקים](/he/webhooks/endpoints).
</Note>