ערוצי הודעות
שערי SMS, WhatsApp ו‑RCS: איך שער מוגדר בלי לכתוב קוד, מה מודד מד המקטעים, ולמה התראה בוואטסאפ מחייבת תבנית מאושרת.
המסך הגדרות → ערוצי הודעות מנהל שלושה ערוצים: SMS, WhatsApp ו‑RCS. שער אחד שולח בערוץ אחד, וברירת המחדל נקבעת לכל ערוץ בנפרד — אפשר להחזיק שער SMS פעיל ושער WhatsApp פעיל זה לצד זה.
השימוש היחיד שמופעל היום מתוך תזמון הוא תזכורת לבעל המערכת מספר שעות לפני תחילת החלון. מספר השעות נקבע לכל סוג עדכון בנפרד, והשארת התיבה ריקה מבטלת את התזכורת לסוג הזה. בלי שער פעיל בערוץ, תזכורות לא נשלחות — והמסך אומר זאת בשורה הראשונה שלו.
שער אינו כתובת עם משתנים
שער הוא בקשת HTTP שלמה, ולכן אין צורך בקוד לכל ספק. אפשר לשלב {משתנה} בכל שדה, והמערכת מקודדת כל ערך פעם אחת בדיוק, לפי מקומו בבקשה.
| החלק | מה מגדירים בו |
|---|---|
| שיטה וכתובת | GET או POST, וכתובת שיכולה בעצמה להתחיל במשתנה |
| אימות | ללא · Basic · Bearer · כותרת מותאמת · פרמטר בשורת הכתובת · חתימה קריפטוגרפית |
| פרמטרים בשורת הכתובת | עם בחירת קידוד לכל שדה בנפרד |
| כותרות | ערך כותרת אינו יכול להכיל מעבר שורה, ובקשה כזאת נדחית כבר בשמירה |
| גוף הבקשה | ללא · טופס · JSON · טקסט חופשי. נתיב שדה תומך בקינון ובמערכים |
| משתנים | ערך רגיל, או ערך סודי |
| כלל ההצלחה | אילו קודי תשובה ואילו ערכים בגוף התשובה נחשבים הצלחה |
| מגבלות | פסק זמן, ומספר מקטעים מרבי |
בגוף בקשה מקוננת המערכת בונה את האובייקט ומסדרת אותו בעצמה, ולכן תוכן ההודעה לעולם אינו יכול לשבור את מבנה ה‑JSON. הבקשה יוצאת רק אל הכתובת שבשורת השער עצמה, והפניות אינן נעקבות.
ערך סודי נשמר מוצפן ואינו מוחזר לדפדפן לעולם — גם לא למי שהקליד אותו. בעריכה חוזרת השדה מסומן כמוגדר, ואפשר להחליף אותו אבל לא לקרוא אותו.
שתי דרכים ליצור שער
מתחילים מספק מוכר שהמוצר כבר מכיר את צורת הבקשה שלו, או מדביקים את כתובת השער הקיימת שלכם והמערכת מפרקת אותה לבקשה שניתן לערוך. בשני המקרים מתקבלת אותה הגדרה — שורה רגילה, ניתנת לעריכה במלואה.
מד המקטעים
עברית נשלחת תמיד בקידוד UCS-2, כי אין לGSM טבלת שפה עברית.
| הקידוד | מקטע יחיד | בכל מקטע כשההודעה מפוצלת |
|---|---|---|
| GSM-7 | 160 תווים | 153 |
| UCS-2 | 70 תווים | 67 |
תו עברי אחד מוריד את כל ההודעה ל‑70 תווים למקטע. החיוב הוא לפי מקטע, ולכן המד מציג עלות משוערת — מקטעים כפול נמענים — בזמן ההקלדה, ולא באמצע החשבונית. הודעה שחורגת מהמקטעים המרביים שהוגדרו לשער תסורב או תיחתך, לפי מה שהוגדר.
מזהה שולח אלפאנומרי מוגבל לאותיות אנגליות, ספרות ורווח. מזהה בעברית ייתקל בדחייה או יוחלף במספר אחר אצל ספק הסלולר, בלי הודעת שגיאה — והמסך מזהיר על כך לפני השמירה.
תבניות מאושרות
ב‑SMS מחברים גוף הודעה ושולחים. בערוצים אחרים אי אפשר לשלוח טקסט חופשי לנמען שלא פנה אלינו קודם — רק תבנית שאושרה מראש אצל הספק. התראה תפעולית היא תמיד פנייה ראשונה, ולכן היא תמיד תבנית.
מרשם התבניות שבמסך רושם מה כבר אושר אצל הספק. הוא אינו מגיש תבניות לאישור ואינו בודק אותן מולו.
| השדה | למה הוא שם |
|---|---|
| מזהה אצל הספק | מה שנשלח בפועל בבקשה |
| שם לתצוגה | אצל חלק מהספקים המזהה אינו קריא |
| שפה וקטגוריה | הקטגוריה של הספק מתומחרת — סיווג שגוי משנה מחיר, לא רק תצוגה |
| מצב אישור | ברירת המחדל היא ״לא ידוע״, והיא סירוב |
| נבדק בתאריך | חובה עבור תבנית מאושרת |
תאריך הבדיקה חובה מסיבה אחת: אישור אצל הספק יכול להתבטל מאוחר יותר על רקע איכות, בלי שום שינוי אצלנו. תבנית מאושרת בלי תאריך היא הצהרה שאיש אינו עומד מאחוריה, והשמירה נחסמת. כשאין אף תבנית מאושרת, כל שליחה בערוץ מסורבת — עם הסבר מה חסר, ולא בשקט.
בדיקת שער
| הפעולה | מה היא עושה |
|---|---|
| בנייה בלבד | מרכיבה את הבקשה במלואה ובודקת את היעד, בלי לשלוח דבר — הבדיקה הנכונה כששרת השער אינו נגיש מהמחשב הזה |
| שליחה אמיתית | שולחת הודעה של ממש למספר אחד |
התוצאה מציגה את הבקשה שנשלחה, איזה קידוד רץ על כל שדה, תשובת השער כלשונה, ואת כלל ההצלחה שלב אחר שלב — כך ששער שהחזיר 200 והודעה שלא הגיעה נראים כשני דברים שונים.
נמענים שדולגו
כשהודעה נשלחת לקבוצת נמענים, חבר שאינו מקבל אותה מדווח עם הסיבה: הוא אינו רשום לאף אחד מהערוצים שההודעה נשלחת בהם, או שאין לו מספר טלפון. שתי הסיבות הן תשובה שאפשר לפעול לפיה; דילוג שקט אינו.
תזכורות שנכשלו נשלחות שוב במספר ניסיונות מוגבל. הגבול קיים כדי שתקלה בשער לא תהפוך לזרם הודעות חוזרות, ותזמון מחדש של אירוע מאפס את המונה.
עודכן
העמוד הזה נמצא בקובץ content/docs/he/v1/integrations/messaging.mdx