---
title: "קמפיינים יוצאים"
description: "העלו רשימת אנשי קשר ותנו לסוכן לעבוד עליה — עם חלונות חיוג, ניסיונות חוזרים והתקדמות בזמן אמת."
---

קמפיינים מחייגים לרשימת אנשי קשר עבורכם: בחרו סוכן, העלו
CSV, הגדירו מתי מותר לחייג, ו-ThunderPhone עובדת על הרשימה
— ומנסה שוב שיחות ללא מענה ותאים קוליים לפי לוח הזמנים שתבחרו. מצאו
אותם תחת **מעורבות → קמפיינים** (`/dashboard/campaigns`).

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

## דרישות מקדימות

- סוכן קולי שנפרס.
- מספר טלפון המופעל לשיחות יוצאות. מספרי VoIP של לקוחות ממשיכים לתמוך
  בקמפיינים. מספרי ThunderPhone מתחילים כמיועדים לשיחות נכנסות בלבד; מנהל ארגון יכול
  לבקש שיחות יוצאות מדף מספרי הטלפון. ThunderPhone בודקת
  כל בקשה ידנית, ומספרים שאושרו יכולים להריץ קמפיינים. ראו
  [חיבור ספק VoIP](/he/guides/voip-providers).
- אנשי קשר כקובץ CSV (או JSON שהודבק) עם עמודה `phone` או
  `phone_number`. **עד 5,000 שורות לכל העלאה**, בקידוד UTF-8.
  העלאות JSON חדשות חייבות להיות שטוחות: ערכים נוספים יכולים להיות מחרוזות, מספרים,
  ערכים בוליאניים או `null`. שורות המכילות מערכים או אובייקטים מקוננים נדחות
  בנפרד עם הודעת אימות; שורות תקינות עדיין מיובאות. תאי CSV הם מחרוזות.
  עמודות נוספות שהתקבלו נשמרות כמשתנים לכל איש קשר ברשומות אנשי הקשר של הקמפיין
  ומסופקות אוטומטית לכל חיוג. ThunderPhone גם
  מסווגת את הנחיית הסוכן השמורה לפני כל שיחה יוצאת כדי להחליט אם
  על הסוכן לנווט בתפריט טלפוני. כותרות כגון `name` ו-`account_id`
  תואמות ל-`{{name}}` ול-`{{account_id}}` בהנחיית הסוכן השמורה. מיפוי שמות יכול גם לשלב
  עמודות לתוך `name`. ראו
  [משתנים לכל שיחה](/he/guides/call-variables) עבור ברירות מחדל, כללי מתן שמות,
  מגבלת האובייקט של 32 KB והערכים המוחזרים בוובהוקים של השלמה.

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

## יצירת קמפיין

<Steps>
  <Step title="לחצו על קמפיין חדש">
    תנו לו שם, בחרו את **סוכן הקול**, ובחרו את **מספר המקור**
    (אחד מהמספרים שלכם שמופעלים לשיחות יוצאות).
  </Step>
  <Step title="העלו את קובץ ה-CSV של אנשי הקשר">
    שורות עם מספר טלפון לא תקין או משתנים לא תקינים נדחות בנפרד
    ומדווחות עם מספרי השורות שלהן — שאר השורות מיובאות ללא בעיה.
  </Step>
  <Step title="הגדירו את חלון החיוג">
    בחרו **אזור זמן** וחלון **התחלה/סיום יומי**; הקמפיין
    מחייג רק בתוכו. אזור הזמן מבוסס על אזור מספר המקור שלכם
    (קידומת האזור שלו בארה״ב ובקנדה, והמדינה שלו במקומות אחרים) או, עבור
    מספרים המשתרעים על פני כמה אזורים כגון מספרים חינמיים, על אזור הזמן של
    הדפדפן שלכם. הרמז מתחת לשדה מציין איזה מהם נבחר. ברירת המחדל של החלון
    היא 09:00–17:00. חלון שמתחיל לפני 08:00 או מסתיים אחרי 21:00 מציג
    אזהרה: שיחות מחוץ לשעות אלה עשויות להפר כללי שעות חיוג כגון כללי
    TCPA. שעת סיום מוקדמת משעת ההתחלה חוצה את חצות: 22:00 →
    02:00 מחייג מ-22:00 עד 02:00 ביום למחרת, עם אזהרה. החלון
    פועל באזור הזמן של הקמפיין, ולא באזור הזמן של כל איש קשר, לכן פצלו
    אנשי קשר לפי אזור זמן כאשר הם מפוזרים.
    אפשר להגדיר **שעת התחלה** כדי לתזמן את ההשקה, וכן
    **שעת סיום** שלאחריה הקמפיין יושלם באופן אוטומטי.
  </Step>
  <Step title="כוונו את הקצב והניסיונות החוזרים">
    - **שיחות במקביל** — מספר השיחות שהקמפיין מפעיל בו-זמנית
      (1–10, ברירת מחדל 3). קמפיינים אינם מתחילים שיחה חדשה כאשר לארגון שלכם
      יש 10 שיחות יוצאות פעילות, לכן קמפיינים מקבילים חולקים את
      המכסה הזו. כל שיחה נספרת גם במסגרת
      [מגבלת השיחות במקביל](/api-reference/introduction#call-limits) של הארגון שלכם
      (20 כברירת מחדל, עבור שיחות נכנסות, יוצאות, אינטרנט ובדיקה).
      כאשר מגיעים למגבלה זו, או כאשר לאותו מספר בוצעה שיחה ב-
      10 השניות האחרונות, איש הקשר פשוט ממתין למעבר מאוחר יותר; הניסיונות שלו
      אינם נצרכים.
    - **מספר ניסיונות מרבי** — מספר הפעמים המרבי שניתן לחייג לכל איש קשר
      (1–10, ברירת מחדל 2).
    - **השהיה לפני ניסיון חוזר (דקות)** — זמן ההמתנה לפני ניסיון חוזר (לפחות 30,
      ברירת מחדל 60).
    - **ניסיון חוזר במקרה של** — התוצאות שמפעילות ניסיון חוזר: **אין מענה**,
      **תא קולי**, **נכשל** (כולן מופעלות כברירת מחדל).

    זקוקים ליותר ניסיונות או למרווחים קצרים יותר? פנו לתמיכה: הצוות יכול
    להגדיל את שתי המגבלות עבור הארגון שלכם.
  </Step>
  <Step title="צרו טיוטה ולאחר מכן התחילו">
    קמפיינים נוצרים כטיוטות — ניתן להוסיף אנשי קשר רק כאשר
    קמפיין הוא טיוטה. התחלת קמפיין דורשת הסכמה מפורשת
    לחיובי השיחות. עם **שעת התחלה** עתידית הוא הופך ל-
    *מתוזמן*; אחרת הוא מתחיל *לפעול* מיד.
  </Step>
</Steps>

<Note>
  קמפיינים שנשמרו לפני מגבלות אלה ממשיכים לפעול בדיוק כפי שהוגדרו.
  הניסיונות והמרווחים שלהם נשארים כפי שנשמרו גם לאחר עריכות אחרות.
</Note>

## כיצד פועלות תוצאות וניסיונות חוזרים

לאחר כל שיחה, איש הקשר מקבל תוצאה — שיחות מוצלחות
מסומנות כהושלמו; שיחה שסווגה כאי-מענה, זוהתה כתא קולי או
נכשלה, תתבצע שוב אם תוצאה זו נמצאת ברשימת **ניסיון חוזר עבור** שלכם
ולאיש הקשר נותרו ניסיונות. אנשי קשר שנגמרו להם הניסיונות מסומנים
כ*מוצו*; כישלונות שלא ניתן לנסות שוב מסומנים כ*נכשלו*.

<Note>
  החיוג מושהה אוטומטית כל עוד יתרת החשבון שלכם אינה תקינה,
  ומתחדש לאחר שהיא תקינה. השאירו את
  [הטעינה האוטומטית](/he/guides/billing-and-topups) פעילה עבור קמפיינים ארוכים.
</Note>

## ניטור ושליטה

כל כרטיס קמפיין מציג את הסטטוס וההתקדמות שלו (לדוגמה, "173 מתוך 248
הסתיימו"). פתחו קמפיין כדי לראות את פירוט הסטטוסים, תוצאות לפי איש קשר
ושיחות אחרונות — כל אחת מהן מקשרת לתמלול ולהקלטה המלאים בהיסטוריית השיחות.

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

סטטוסי קמפיין: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. סטטוסי אנשי קשר: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

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

<CardGroup cols={2}>
  <Card title="צפו בשיחות בזמן אמת" icon="tower-broadcast" href="/he/guides/monitor-live-calls">
    האזינו לשיחות קמפיין בזמן שהן מתרחשות.
  </Card>
  <Card title="API לשיחות יוצאות" icon="phone-arrow-up-right" href="/he/guides/place-outbound-calls">
    בצעו שיחות בודדות באופן תכנותי.
  </Card>
</CardGroup>