ניהול כינויי דומיין דרך API ו-MCP

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

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

מתי זה שימושי

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

לדוגמה:

hello@brand.example   → hello@company.example
billing@brand.example → billing@company.example

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

תוכניות ומגבלות

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

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

מה שומר על עדיפות

כינוי הדומיין פועל רק לאחר ש-TrekMail בודק כתובות מדויקות שכבר הוגדרו בדומיין המחובר. תיבות דואר, כינויים, כתובות העברה, העברת תיבות דואר והגדרות catch-all קיימים שומרים על העדיפות המתועדת שלהם.

המשמעות היא שכלל מכוון של sales@brand.example אינו מוחלף ללא הודעה ב-sales@company.example.

REST API

שלוש נקודות הקצה משתמשות במזהה של הדומיין המחובר:

נקודת הקצה שומרת על הנתיב המקורי /matching-addresses כדי ששילובים קיימים לא יישברו. לוח הבקרה והתיעוד משתמשים במונח הענפי הברור יותר כינוי דומיין.

PUT ו-DELETE דורשים כותרת Idempotency-Key. בטוח לחזור על אותה בקשה מוצלחת עם אותו מפתח.

חיבור דומיין

PUT /api/v1/domains/42/matching-addresses
Authorization: Bearer tm_live_...
Idempotency-Key: matching-brand-company-v1
Content-Type: application/json

{
  "primary_domain_id": 7
}

קריאת התוצאה

{
  "configured": true,
  "enabled": true,
  "delivering": true,
  "status": "delivering",
  "paused_reason": null,
  "alias_domain": {
    "id": 42,
    "domain": "brand.example"
  },
  "primary_domain": {
    "id": 7,
    "domain": "company.example"
  },
  "primary_domain_restricted": false
}

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

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

מצבי מסירה

כלי MCP

אותו תהליך עבודה זמין באמצעות שלושה כלי דומיין:

• get_domain_alias: קריאת החיבור השמור ומצב המסירה בזמן אמת;
• set_domain_alias: חיבור או שינוי הדומיין הראשי;
• remove_domain_alias: ניתוק לאחר confirm_remove: true.

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

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

הסרה בטוחה ושדרוג לאחור

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

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

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

יומן ביקורת

כל שינוי דרך API או MCP מופיע תחת סוכני AI ו-API ← יומן ביקורת. אירועי חיבור ושינוי מתעדים את שני מזהי הדומיינים, את הדומיין הראשי הקודם כאשר הדבר רלוונטי, את האסימון שביצע את הפעולה, את מזהה הבקשה ואת השעה. אירוע הסרה מתעד איזה חיבור הוסר. תוכן הודעות ופרטי כניסה אינם נכתבים באירועים אלה.

רשימת פעולות לפתרון בעיות

1. ודאו ששני הדומיינים מוצגים כ-פעילים ומשתמשים ב-TrekMail לדואר נכנס.
2. בדקו שרשומות ה-MX של שני הדומיינים תקינות.
3. ודאו שהחשבון נמצא בתוכנית Starter, Pro או Agency.
4. בדקו יחד את configured,‏ delivering,‏ status ו-paused_reason.
5. בדקו אם תיבת דואר מדויקת, כינוי, כתובת העברה או כלל catch-all כבר מטפלים בכתובת.
6. עיינו ביומן הביקורת כדי למצוא את פעולת החיבור, השינוי או ההסרה האחרונה.