# 🌟 שלום וברכה! 🌟

ברוכים הבאים לפורום עזרה והסברים בתיכנות, המוקדש ל־API של חברת ימות המשיח!

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

🔍 א’: מניעת שאלות כפולות

לפני שאתם שואלים שאלה או פותחים נושא חדש, וודאו שהשאלה לא נענתה כבר.

איך לבדוק:
|1. לחצו על סמל החיפוש בצד שמאל למעלה.
2. הקלידו מילות מפתח הקשורות לשאלתכם.
3. קראו את התשובות הקיימות.

לדוגמה:
שאלה: “מה זו שפת PHP ואיך משתמשים בה?”
חיפוש: "שפת PHP" או "מדריך PHP" → לחצו אנטר

✅ לא מצאתם תשובה? פתחו נושא חדש.

💡 טיפ: חיפוש נכון חוסך זמן ומונע כפילויות בפורום.

## 📝 ב. צורת כתיבת נושאים / תגובות

הגיבו רק אם התוכן קשור לנושא הקיים.
שאלות נוספות או הערות? פתחו נושא חדש.
הימנעו מכותרות כמו "דחוף" או "מה זה/איך עושים".
עירבוב נושאים פוגע ביעילות הפורום וקשה למשתמשים לקבל תשובות.

💡 טיפ: כותרת ברורה ומדויקת מקלה על אחרים להבין את השאלה ולספק תשובות איכותיות.

📚 ג. מניעת שאלות מיותרות

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

איך מחפשים:

1. נכנסים לשרשור מדריך השפה.
2. מקישים Ctrl + F או F3.
3. מקלידים את שם הפונקציה או המונח.
4. התוצאה מוצגת מיד!

💡 טיפ: חיפוש נכון מונע פתיחת נושאים כפולים ושומר על איכות הפורום.

🚫 ד. נושאים אסורים

נא להימנע מפתיחת נושאים כמו:
“למה אי אפשר להעלות תמונת פרופיל?”
“למה אין חתימות?”

הפורום מיועד לעזרה בנושא API בלבד, ולא לכתבות, נייעס, בקשות לייקים או פתיחת משתמשים כפולים.

👥 ה. כללי התנהגות

שמרו על שפה נקייה ומכובדת.
שמרו על רמת הפורום ויעילותו.
|הפרת הכללים → משתמשים יורחקו ללא אזהרה, לשמירה על סדר ומניעת ספאם.

💡 טיפ: שמירה על כללי ההתנהגות מסייעת לכל המשתמשים לחוות פורום מקצועי ונעים.

💬 ו. צ’אט

הצ’אט נפתח לטובת המשתמשים.
⚠️ חשוב לדעת: להנהלה יש אפשרות לצפות בצ’אטים.

✅ מסקנה

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

💖 שהות נעימה, ולמידה מהנה! 🤗

@anti-malware
אתה אלוף!!! תודה על כל ההשקעה!

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

בקטגוריית “שיתוף מודולים”
תוכלו לפרסם את המודול שבניתם
או להשתמש במודולים
שנבנו בAPI ע"י משתמשים אחרים!
אין לפרסם מודולים שאינם שייכים לכם!
אין לכתוב נושאים שאינם קשורים לקטגוריה זאת!

פונקציות string מסודרות+הסבר!

החזרת אורך הסטרינג:

strlen()

החזרת אורך סטרינג בעברית:

mb_strlen($string,'utf-8')

החלפת תו מתוך סטרינג לתו אחר:

str_replace()

יצירת מערך מסטרינג:

explode()

יצירת מערך מכל תו בסטרינג:

str_split()

מצא את המיקום של התו הראשון בסטרינג:

strpos()

מצא את המיקום של התו האחרון בסטרינג:

strrpos()

דוגמה לפונקציית strlen:

<?php

$a = "Hello World";

echo strlen($a);

?>

התוצאה היא

11

דוגמה לפונקצייה md_strlen:

<?php

$a = "שלום עולם";

echo mb_strlen($a,'utf-8');

?>

והתוצאה היא

9

דוגמה לפונקצייה str_replace:

<?php

$a = "I+my+name+is+moshe";

echo str_replace("+","=",$a);

?>

והתוצאה היא

I=my=name=is=moshe

דוגמה לפונקצייה explode:

<?php

$a = "I=my=name=is=moshe";

print_r(explode("=",$a));

?>

התוצאה היא

Array ( [0] => I [1] => my [2] => name [3] => is [4] => moshe )

דוגמה לפונקציה str_split:

<?php

$a = "Hello World";

print_r(str_split($a));

?>

התוצאה היא

Array ( [0] => H [1] => e [2] => l [3] => l [4] => o [5] => [6] => W [7] => o [8] => r [9] => l [10] => d )

קבלת מצב קמפיין

מאפשר לבדוק את הסטטוס הנוכחי של קמפיין כפי שהתקבל בקריאת RunCampaign

הפקודה היא: GetCampaignStatus

פרמטרים בבקשה

הצגת רשומות בקמפיין

סוגי הערכים האפשריים בפרמטר entries:

הגדרת טווח להצגה

בפרמטר range יש להגדיר את טווח הרשומות להצגה.
הפורמט הוא:

פרמטרים בתשובה במצב הצלחה
מבנה התגובה:

{
    "responseStatus": "OK",
    "campaign": {
        "campaignId": "0772222770-1117319-2025-01-22-10-07-54-414-API",
        "campaignStatus": "RUNNING",
        "templateId": 1117319,
        "who": "0.0.0.0",
        "callerId": "0772222770",
        "blockedEntries": 0,
        "pendingEntries": 0,
        "activeEntries": 1,
        "bridgedEntries": 0,
        "redialEntries": 0,
        "doneEntries": 0,
        "failedEntries": 0,
        "totalEntries": 1,
        "totalDialed": 3,
        "totalSuccessful": 1,
        "totalBridged": 0,
        "totalFailed": 2,
        "totalIncoming": 0,
        "totalIncomingBridged": 0,
        "maxActiveChannels": 100,
        "maxBridgedChannels": 0,
        "maxDialAttempts": 3,
        "redialWait": 10.0,
        "redialPolicy": "FAILED",
        "vmDetect": false,
        "filterEnabled": false,
        "playPrivateMsg": false,
        "runTime": 150.306,
        "currentPrice": 1.0,
        "paused": false,
        "entries": [
            {
                "phone": "0773137770",
                "name": null,
                "moreinfo": "זוהי הודעת בדיקה",
                "entryStatus": "up",
                "duration": 3680,
                "bridgedDuration": null,
                "bridged": false,
                "startTime": "2025-01-22 10:10:14",
                "currentPrice": 1.0,
                "redials": [
                    {
                        "entryStatus": "no_answer",
                        "duration": null,
                        "bridgedDuration": null,
                        "bridged": false,
                        "startTime": "2025-01-22 10:07:54"
                    },
                    {
                        "entryStatus": "no_answer",
                        "duration": null,
                        "bridgedDuration": null,
                        "bridged": false,
                        "startTime": "2025-01-22 10:09:04"
                    }
                ]
            }
        ]
    },
    "yemotAPIVersion": 6
}

המשך יבוא…

📞 GetCampaignStatus – קבלת מצב קמפיין

מאפשר לבדוק את הסטטוס הנוכחי של קמפיין כפי שהתקבל בקריאת RunCampaign.

🔹 הפקודה

GetCampaignStatus

🔹 פרמטרים נדרשים

🔹 ערכי פרמטר entries

🔹 תגובה במצב הצלחה (דוגמה)

{
  "responseStatus": "OK",
  "campaign": {
    "campaignId": "0772222770-1117319-2025-01-22-10-07-54-414-API",
    "campaignStatus": "RUNNING",
    "templateId": 1117319,
    "callerId": "0772222770",
    "blockedEntries": 0,
    "pendingEntries": 0,
    "activeEntries": 1,
    "doneEntries": 0,
    "failedEntries": 0,
    "totalEntries": 1,
    "totalDialed": 3,
    "totalSuccessful": 1,
    "totalFailed": 2,
    "paused": false,
    "entries": [
      {
        "phone": "0773137770",
        "name": null,
        "moreinfo": "זוהי הודעת בדיקה",
        "entryStatus": "up",
        "duration": 3680,
        "startTime": "2025-01-22 10:10:14",
        "currentPrice": 1.0,
        "redials": [
          {
            "entryStatus": "no_answer",
            "startTime": "2025-01-22 10:07:54"
          },
          {
            "entryStatus": "no_answer",
            "startTime": "2025-01-22 10:09:04"
          }
        ]
      }
    ]
  },
  "yemotAPIVersion": 6
}

הפעלת קמפיין

מאפשר להפעיל קמפיין על בסיס תבנית קיימת במערכת.

הפקודה

RunCampaign

פרמטרים נדרשים

פורמט מספרים לשליחה

אפשרות 1 – רשימה פשוטה:
המפריד בין מספר למספר הוא נקודתיים :

phones=0772222770:0773137770

המערכת תחייג למספרים 0772222770 ו־0773137770.

אפשרות 2 – פורמט JSON עם מידע נוסף:

{
  "0773137770": {
    "name": "שם",
    "moreinfo": "מידע נוסף",
    "blocked": true
  },
  "0772222770": {
    "name": "ימות המשיח",
    "text": "עתיד התקשורת כבר כאן"
  }
}

• name → שם
• moreinfo → מידע נוסף
• text → טקסט להודעה אישית (SMS או TTS)
• blocked → true = חסום, false = פעיל (ברירת מחדל פעיל)

השמעת הודעות אישיות (TTS)

• ttsMode=1 → המערכת תשמיע הודעה כללית של הקמפיין ואחריה טקסט אישי.
• אם לא סופק phones → הטקסט נלקח מהשדה moreinfo.
• אם סופק phones → הטקסט נלקח מהשדה text.

קמפיין משולב SMS

• withSMS=1 → למספר נייד רגיל נשלחת הודעת SMS,
  ולמספר נייד כשר נשלחת הודעה קולית.

מאפייני תגובת השרת

שגיאות אפשריות

העלאת קובץ טקסט והפיכתו לרשימת טלפונים לתבנית קמפיין

הפקודה

UploadPhoneList

פרמטרים נדרשים

תגובות שגיאה

אם ניתוח הקובץ נכשל בגלל פורמט לא מזוהה → message = "bad_format"

מאפייני תגובת השרת

תבנית אובייקט rejectedRecords

מחיקת כל המספרים מרשימת התפוצה

הפקודה

ClearTemplateEntries

פרמטרים נדרשים

מאפייני תגובת השרת

אין מאפיינים מיוחדים.

עדכון סטטוס או מחיקה של מספרים מרשימת התפוצה

הפקודה

UpdateTemplateEntries

פרמטרים נדרשים

מאפייני תגובת השרת

אין מאפיינים מיוחדים.

עדכון מספר בודד ברשימת תפוצה

הפקודה

UpdateTemplateEntry

פרמטרים נדרשים

הצגת המספרים שברשימת התפוצה

הפקודה

GetTemplateEntries

פרמטרים נדרשים

מאפייני תגובת השרת

תבנית אובייקט מספר

מחיקת תבנית קמפיין

הפקודה

DeleteTemplate

פרמטרים נדרשים

מאפייני תגובת השרת

אין מאפיינים מיוחדים בתגובת השרת.