Delivyr SMS

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

למי זה מתאים

עסקים ששולחים SMS לנמענים בארצות הברית או בקנדה, ושכבר יש להם חשבון ב-Delivyr או שהם פותחים אחד. סביבת העבודה שלכם ב-Joryio יכולה להתארח באיחוד האירופי או בארצות הברית; מה שקובע הוא שלנמענים יש מספרים של ארצות הברית או קנדה (+1).

חיבור חשבון ה-Delivyr שלכם

אתם מביאים חשבון Delivyr משלכם ומחברים אותו בעצמכם, מכרטיס Delivyr בעמוד אינטגרציות. צריך שני פרטים מהפורטל של Delivyr, שניהם תחת Settings > General:

• ה-Account ID שלכם ב-Delivyr
• מפתח API של Delivyr

1. פתחו את אינטגרציות ובחרו Delivyr (תחת הודעות).
2. הזינו את ה-Account ID ואת מפתח ה-API. אם Delivyr נתנה לחשבון שלכם מספר שליחה, אפשר להזין גם אותו. Delivyr בוחרת את המספר שממנו היא שולחת, ולכן Joryio רק מציגה אותו כשולח; בלעדיו השולח מוצג כ-"Delivyr".
3. לחצו על בדיקת חיבור כדי לבדוק את הפרטים מול Delivyr, ואז על חיבור Delivyr. Joryio בודקת אותם שוב, מחברת את החשבון לסביבת העבודה הזו וקוראת את התבניות שלכם בפעם הראשונה.

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

• מי יכול לחבר. רק מנהלי סביבת העבודה - ההרשאה הגדרות: כתיבה - יכולים לחבר, להחליף את המפתח או לנתק. חברים אחרים רואים את הכרטיס אבל לא יכולים לשנות אותו.
• מפתח ה-API. הוא נשמר מוצפן ולא מוצג שוב. כדי לשנות אותו, השתמשו בהחלפת מפתח API; המפתח החדש נבדק מול Delivyr לפני שהוא נשמר.
• כמה חשבונות בכל סביבת עבודה, סביבת עבודה אחת לכל חשבון. סביבת עבודה יכולה לחבר כמה חשבונות Delivyr - למשל אחד לכל מותג - וכל אחד מוצג בכרטיס עם שם משלו. חשבון Delivyr יכול להיות מחובר לסביבת עבודה אחת בלבד ב-Joryio: Delivyr שומרת תבניות ורשימת STOP לכל חשבון בנפרד, כך שחשבון אחד ששתי סביבות עבודה חולקות היה חולק גם רשימת STOP אחת.
• סביבות דמו. בדמו, החיבור עובד רק אם Joryio פתחה את הדמו לחיבורים חיצוניים.
• חיוב. כמו בכל חשבון SMS שאתם מביאים, אתם משלמים ל-Delivyr על ההודעות לפי ההסכם שלכם איתה, ו-Joryio מוסיפה את דמי הפלטפורמה שלה לכל הודעה.

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

כמה חשבונות Delivyr

סביבת עבודה יכולה לשלוח דרך יותר מחשבון Delivyr אחד, למשל אחד לכל מותג. כדי להוסיף חשבון, לחצו על חיבור חשבון Delivyr נוסף מתחת לחשבונות המחוברים והזינו את ה-Account ID ואת מפתח ה-API שלו כמו למעלה. תנו לו שם - למשל שם המותג - כדי שתוכלו להבחין בין החשבונות: השם מוצג בכרטיס, בבחירת שולח ה-SMS ובדף תבניות ה-SMS. בלי שם, החשבון הראשון נקרא "Delivyr" והבאים אחריו "Delivyr" יחד עם ה-Account ID שלהם. אפשר לשנות את שם החשבון אחר כך בעיפרון שליד השם.

כל חשבון נפרד:

• כרטיס משלו. לכל חשבון יש שולח, תבניות, בדיקת חיבור, רענון תבניות, החלפת מפתח API וניתוק משלו. ניתוק חשבון אחד משאיר את האחרים מחוברים.
• תבניות משלו. עורך ה-SMS מציג את התבניות של החשבון שאליו שייך המספר שנבחר, ומציין את שם החשבון. תבנית שייכת לחשבון אחד ונשלחת רק דרכו: אם מחליפים את המספר לחשבון אחר, בוחרים אחת מהתבניות של החשבון הזה. דף תבניות ה-SMS מראה לאיזה חשבון שייכת כל תבנית, ושואל לאיזה חשבון מיועדת תבנית חדשה.
• כתובת webhook ורשימת STOP משלו. לכל חשבון יש כתובת דוחות מסירה משלו, ו-STOP שמדווח בחשבון אחד מסיר את איש הקשר רק מהמספר של החשבון הזה.

ניתוק

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

תבניות

כל הודעה של Delivyr היא תבנית. התבניות שלכם נמצאות בדף SMS Templates ב-Brand Studio, שמופיע ברגע ש-Delivyr מחוברת לסביבת העבודה.

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

אי אפשר לערוך טקסט מאושר. כדי לשנות נוסח, צרו תבנית חדשה. פרטים, סטטוסים וטיפים לכתיבה נמצאים בתבניות SMS (Delivyr).

שליחה בקמפיינים ובמסעות

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

1. בחרו תבנית מאושרת. תבניות שעדיין בבדיקה לא מוצגות.
2. מלאו כל {{variable}} בתבנית. הקלידו טקסט או השתמשו בהתאמה אישית של Liquid כמו {{ user.first_name }}; כל איש קשר מקבל ערכים משלו בזמן השליחה.
3. שימו את כתובת היעד ב-{{link}}. Joryio שולחת אותה כקישור מקוצר ומנוטר משלה, כך שקליקים נספרים כמו בכל קישור SMS אחר.
4. בדקו את התצוגה המקדימה והשתמשו ב-שלח SMS לבדיקה כדי לשלוח את התבנית למספר בדיקה.

בדיקת ההשקה מסמנת SMS בחשבון Delivyr שאין לו תבנית, שהתבנית שלו לא מאושרת או שמשתנה בו נשאר ריק. האם הממצאים האלה עוצרים את ההשקה תלוי בהגדרת בדיקת ההשקה של סביבת העבודה, אבל Delivyr עצמה אף פעם לא שולחת הודעה כזאת, אז תקנו אותם לפני ההשקה. עוד על העורך: חשבונות Delivyr: תבניות מאושרות.

הסכמה והסרה

• את STOP מטפלת Delivyr. כשנמען משיב STOP, Delivyr מפסיקה לשלוח למספר הזה מהחשבון שלכם. ההסרות וכללי ההסכמה של Joryio עצמה עדיין חלים לפני כל שליחה.
• אישור כפול (double opt-in). אם האישור הכפול מופעל בחשבון ה-Delivyr שלכם, Delivyr שולחת תבניות רגילות למספר רק אחרי שהנמען מאשר. ל-Joryio יש סטטוס איש קשר תואם, ממתין לאישור - ראו ניהול מינויים.

אחרי שמגדירים דוחות מסירה, ההסרות של Delivyr מועתקות לאיש הקשר ב-Joryio: STOP מסיר אותו מ-SMS, ותשובת YES או UNSTOP רושמת אותו מחדש (ומאשרת איש קשר שנמצא בסטטוס ממתין לאישור). בלי דוחות מסירה, תשובות STOP ואישורים נשארים רק בצד של Delivyr. כש-Delivyr מחזיקה הסרה מ-SMS של איש קשר, דף איש הקשר מציין זאת: עדיין אפשר לרשום אותו מחדש ב-Joryio, אבל Delivyr ממשיכה לחסום SMS עד שישלח START.

אישור הרשמה כפול ב־SMS. ל־Delivyr יש אישור הרשמה כפול משלה, ולכן כשמספר ה־SMS של סביבת העבודה נמצא בחשבון Delivyr, אישור ההרשמה הכפול ב־SMS של Joryio לא שולח אישור שני: הרשמות חדשות ל־SMS נרשמות כרגיל ו־Delivyr מעכבת הודעות למספרים שלא אושרו ("Not confirmed yet") עד שאיש הקשר משיב YES ל־Delivyr.

דוחות מסירה, הסרות ותשובות

Delivyr שולחת דוחות מסירה, הסרות ותשובות רק ל-webhook שאתם מוסיפים בפורטל Delivyr, ואתם כותבים את התוכן שהיא שולחת לכל אירוע. Joryio נותנת לכם את שניהם: כתובת webhook אחת ומטען מוכן לכל אירוע. עד שתוסיפו אותם, שום דבר לא חוזר - Joryio יודעת שהודעה נמסרה ל-Delivyr, אבל לא אם היא הגיעה, ותשובות STOP לא מועתקות לאיש הקשר ב-Joryio.

הגדרה

1. פתחו אינטגרציות > Delivyr, ובקטע דוחות מסירה לחצו הגדרת דוחות מסירה. רק מנהלי סביבת העבודה - הגדרות: כתיבה - רואים את הכתובת.
2. בפורטל Delivyr, פתחו Settings > Webhooks וצרו webhook עם כתובת ה-webhook ש-Joryio מציגה. אותה כתובת משמשת לכל האירועים.
3. הרשמו ב-webhook לכל אחד מהאירועים בטבלה שלמטה. לכל אירוע הדביקו את המטען של Joryio (JSONata) - בכרטיס יש כפתור העתקה לכל אחד, והם גם מופיעים בהמשך.
4. שמרו. הכרטיס מציג מתי הגיע הדוח האחרון.

אירוע ב-Delivyr	מה Joryio עושה איתו
delivery_receipt	מסמנת את ההודעה נמסרה, או נכשלה עם הסיבה (לא ניתנת למסירה, פג תוקף, נדחתה על ידי הספק), באנליטיקה של קמפיינים ומסעות.
rejected_message	מסמנת את ההודעה נכשלה עם הסיבה של Delivyr. קוד 1 (הוסר) גם מסיר את איש הקשר מ-SMS.
opt_out	STOP מסיר את איש הקשר מ-SMS עבור מספר ה-Delivyr שלכם. YES או UNSTOP רושמים אותו מחדש - רק כש-Joryio עצמה קיבלה את התשובה הזו מאיש הקשר במספר ה-Delivyr שלכם ב-24 השעות האחרונות, ורק עבור מספר ה-Delivyr שלכם: הסרה מ-SMS מהמספרים האחרים שלכם נשארת.
incoming_messages	שומרת את התשובה על איש הקשר; היא יכולה להתחיל או לקדם מסע, ו-{{ reply.text }} קורא אותה. תשובה שהיא מילת הסרה (STOP, UNSUBSCRIBE, CANCEL, END, QUIT, REVOKE, OPT OUT ושאר רשימת ההסרה של Joryio) גם מסירה את איש הקשר מ-SMS - פעם אחת, גם כשדוח ה-opt_out של Delivyr על אותו STOP מגיע גם הוא. תשובת START או YES לא רושמת אותו מחדש: רק דוח ה-opt_out של Delivyr עושה זאת.
message_log	מאשרת ש-Delivyr קיבלה את ההודעה.
event_log	סופרת קליקים על קישורים ש-Delivyr עוקבת אחריהם. תצוגות מקדימות של קישורים על ידי רובוטים לא נספרות.

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

המטענים

הדביקו כל אחד, ללא שינוי, כמטען של האירוע שלו.

delivery_receipt

{ "version": 1, "type": "delivery_receipt", "id": id, "request_id": request_id, "message_log_id": message_log_id, "status": status, "status_mapped": status_mapped, "epoch": epoch }

rejected_message

{ "version": 1, "type": "rejected_message", "id": id, "request_id": request_id, "phone_number": phone_number, "rejection_code": rejection_code, "rejection_reason": rejection_reason }

opt_out

{ "version": 1, "type": "opt_out", "dml": dml, "phone_number": phone_number, "system_number": system_number, "incoming_log_id": incoming_log_id, "request_id": request_id }

incoming_messages

{ "version": 1, "type": "incoming_messages", "id": id, "from": from, "to": to, "body": body, "message_log_id": message_log_id, "request_id": request_id }

message_log

{ "version": 1, "type": "message_log", "id": id, "request_id": request_id, "sending_number": sending_number, "segments": segments, "testing": testing }

event_log

{ "delivyr_ignore": event != "click", "version": 1, "type": "event_log", "event": event, "message_log_id": message_log_id, "request_id": request_id }

• גרסה. כל מטען כולל "version": 1. אם Joryio תשנה את המטען, הכרטיס יציין זאת; אז הדביקו את החדש. דוח שהמטען שלו לא מוכר ל-Joryio נדחה ונספר בכרטיס.
• שמרו את הכתובת בסוד. כל מי שמחזיק בה יכול לשלוח דוחות והסרות עבור סביבת העבודה הזו. אם היא דלפה, לחצו יצירת כתובת חדשה בכרטיס: הישנה מפסיקה לעבוד מיד, והדוחות נעצרים עד שתדביקו את הכתובת החדשה ב-Delivyr.
• רק ההודעות שלכם נספרות. Joryio מתאימה כל דוח להודעה שנשלחה מסביבת העבודה הזו. דוח שלא ניתן להתאים נספר בכרטיס כלא מותאם, ולעולם לא נוסף לאיש קשר או לקמפיין.

מגבלות כרגע

• אין SMS בטקסט חופשי. כל הודעה חייבת להיות תבנית מאושרת. קמפיין שנוצר דרך ה-API עם הודעה בטקסט חופשי בחשבון Delivyr נדחה.
• ארצות הברית וקנדה בלבד. שליחה למספר מחוץ ל-+1 נכשלת עם "Delivyr sends to US and Canada (+1) numbers only" ולא מנוסה שוב.
• דוחות מסירה דורשים את ה-webhook. הודעות שנמסרו או נכשלו, הסרות ותשובות מגיעות ל-Joryio רק אחרי שמוסיפים את ה-webhook של Joryio בפורטל Delivyr - ראו דוחות מסירה, הסרות ותשובות. דוחות המסירה חדשים: אם הכרטיס מציג דוחות שלא הותאמו להודעה בזמן ש"נמסרו" נשאר אפס, פנו אלינו.

API ציבורי

אותן תבניות זמינות גם דרך ה-REST API הציבורי, לסביבות עבודה של Delivyr בלבד. ראו תבניות SMS ב-Messaging API.