מדריך תפעול דואר

תם הזמן הקצוב לבקשת API. איך אדע אם התיבה נוצרה?

מאת Alexey Bulygin
זכוכית מגדלת לפני תיבת דואר ירוקה ולצדה שעון חול

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

אפשר לתת לתוכנה ליצור תיבות ולהגדיר העברות דרך API של TrekMail. API מאפשר למערכת שלכם לשלוח לשירות פקודות מוגדרות במקום שעובד יבצע אותן שוב ושוב בלוח הבקרה. לשינויים האלה צריך Pro או Agency, הרשאות מתאימות וגישה לדומיין שנבחר.

הגדירו מה בדיוק צריך ליצור

התחילו בתיאור רגיל של המשימה. ״עובד צריך תיבה אישית״ ו״הודעות לכתובת כללית צריכות להגיע לתיבה אחרת״ דורשים הגדרות שונות.

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

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

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

הכינו מסלול וגישה מוגבלת

אפשרות להגדיר תכונה ידנית לא בהכרח נותנת זכות לשנות אותה דרך API. יצירת תיבות ושינוי העברה דורשים Pro או Agency. Starter מאפשר קריאת הגדרות תשתית נגישות, וזה אינו מספיק לאוטומציה הזאת.

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

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

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

בנו סדר פעולות ליצירה

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

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

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

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

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

טפלו בבקשות חוזרות ובשגיאות

בפעולה שמתועדת כאידמפוטנטית, השתמשו באותו Idempotency-Key עבור אותה בקשה ותוכן. שמרו את מזהה התיבה ובדקו בנפרד את כללי החזרה של פעולות אחרות.

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

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

בקליטה מרוכזת אל תבטיחו שכל הבקשות יסתיימו באותו זמן. הציגו מצב לכל אחת ורשימת מקרים שדורשים תשומת לב.

בדקו את התהליך בדומיין אחד

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

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

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

היעזרו בסקירת ה-API. יצירת התשתית אינה דורשת לקרוא את הודעות המשתמש החדש; תנו רק את הרשאות הניהול הדרושות.

קריאה נוספת

שתפו מאמר זה

התחברות ל-TrekMail

גישה ללוח הבקרה, לתיבות הדואר ול-DNS שלכם.

12 תווים

דוא״ל האיפוס נשלח

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

בהמשך אתם מסכימים ל תנאי השימוש ול מדיניות הפרטיות של TrekMail.