שלח הודעות טקסט מהאתר שלך באמצעות REST API (MTS Marketer)

חנות מקוונת מאבדת עד 30% מההזמנות אם אישור לא מגיע בזמן. כל שנייה של עיכוב עולה בלקוחות. MTS Marketer פותר זאת: ה-API מסוג REST שלו מספק גישה למאגר המנויים של MTS עם אחריות אספקה של 99.9% ומיקוד לפי מיקום גיאוגרפי, מגדר ותחומי עניין. לפי התיעוד הרשמי של MTS Marketer, זמן האספקה הממוצע להודעות SMS טרנזקציונליות הוא פחות משנייה אחת, ולהודעות שיווקיות עד 5 שניות. ביצענו 50 אינטגרציות למסחר אלקטרוני, בנקים ולוגיסטיקה, תוך טיפול ביותר מ-10 מיליון הודעות בחודש. עם הגדרה נכונה, תקבלו 90% מההודעות שנמסרות תוך 3 שניות. אנו מחברים את השירות לאתר שלכם—מהודעות פשוטות ועד קמפיינים שיווקיים מורכבים. אינטגרציית MTS Marketer מאפשרת לשלוח הודעות טקסט ישירות מהאתר שלכם, תוך הפחתת עלויות בעד 30% באמצעות ניתוב ומיקוד אופטימליים. שליחת הודעות טקסט מהאתר היא פשוטה: להלן דוגמה לשליחה באמצעות PHP עם Laravel.

איך לשלוח SMS דרך API של MTS Marketer?

// Авторизация через Bearer-токен
$token = Http::post('https://api.mts-marketer.ru/v1/oauth/token', [
    'grant_type' => 'client_credentials',
    'client_id' => env('MTS_CLIENT_ID'),
    'client_secret' => env('MTS_CLIENT_SECRET')
])->json()['access_token'];

// Отправка SMS
$response = Http::withToken($token)
    ->post('https://api.mts-marketer.ru/v1/sms/send', [
        'from' => env('MTS_SENDER_NAME'),
        'to' => [$phone],
        'text' => "Код подтверждения: {$code}",
        'is_test' => false
    ]);

לאחר השליחה, ה-API מחזיר מזהה הודעה. ניתן לקבל את סטטוס האספקה באמצעותו:

$status = Http::withToken($token)
    ->get("https://api.mts-marketer.ru/v1/sms/status/{$messageId}")
    ->json(); // status: QUEUED | SENT | DELIVERED | FAILED

מהן שגיאות האינטגרציה הנפוצות?

במהלך שנות היישום, אספנו בעיות תכופות:

• פורמט מספר שגוי. המספר חייב להיות בפורמט בינלאומי: 7XXXXXXXXXX. אחרת, ה-API מחזיר // Авторизация через Bearer-токен $token = Http::post('https://api.mts-marketer.ru/v1/oauth/token', [ 'grant_type' => 'client_credentials', 'client_id' => env('MTS_CLIENT_ID'), 'client_secret' => env('MTS_CLIENT_SECRET') ])->json()['access_token']; // Отправка SMS $response = Http::withToken($token) ->post('https://api.mts-marketer.ru/v1/sms/send', [ 'from' => env('MTS_SENDER_NAME'), 'to' => [$phone], 'text' => "Код подтверждения: {$code}", 'is_test' => false ]); .
• חריגה ממגבלות סגמנט. אם אתם שולחים קמפיין שיווקי ל-100,000 מספרים בבת אחת, ודאו שהתעריף שלכם תומך בנפח זה (פנו לתמיכה של MTS).
• פגיית טוקן. טוקן ה-Bearer חי שעה אחת. בקוד ייצור, אנו מיישמים חידוש אוטומטי באמצעות refresh-token.
• היעדר שם אלפא. ללא שם שולח רשום (3–5 ימי עסקים), ה-API חוסם שליחה.
• התעלמות מסטטוסי אספקה. אל תגדירו בדיקות כל 5 שניות—השתמשו ב-webhooks לקבלת התראות אספקה.

סיבות להפרדת קמפיינים טרנזקציונליים ושיווקיים

MTS Marketer תומך בשני מצבים, וערבוב ביניהם אינו מותר. הודעות טרנזקציונליות (OTP, סטטוסי הזמנות) נמסרות מהר יותר ואינן דורשות הסכמת נמען לפי החוזה. הודעות שיווקיות (מבצעים, חדשות) ממוקדות על בסיס מאגר המנויים של MTS, אך חייבות לעמוד ב-152-FZ. הבדלים במאפיינים:

בחירת המצב משפיעה על קוד האינטגרציה: עבור טרנזקציונלי, הגדירו $status = Http::withToken($token) ->get("https://api.mts-marketer.ru/v1/sms/status/{$messageId}") ->json(); // status: QUEUED | SENT | DELIVERED | FAILED , עבור שיווקי, העבירו פרמטרי סגמנטציה.

הגדרת חידוש טוקן אוטומטי

טוקן ה-Bearer חי שעה אחת. לפעולה רציפה, יישמו חידוש אוטומטי באמצעות refresh-token. התהליך כולל שלושה שלבים:

1. בעת קבלת הטוקן, שמרו את ה-refresh_token מהתשובה.
2. 5 דקות לפני פגיית ה-current_token, שלחו בקשה ל-/v1/oauth/refresh עם ה-refresh_token.
3. עדכנו את האחסון המקומי עם ה-access_token וה-refresh_token החדשים. זה מונע שגיאות 401 Unauthorized בייצור.

שיטות עיקריות של API של MTS Marketer

הבטחת אבטחת אינטגרציה

שמרו את ה-client_secret במשתני סביבה, אל תעבירו אותו בקוד. השתמשו ב-HTTPS. הגבילו הרשאות גישה—צרו משתמש נפרד עם הרשאות שליחת הודעות טקסט בלבד. הפעילו רישום (לוגים) של כל הבקשות. בדקו סטטוסי אספקה דרך webhooks: הגדירו endpoint לקבלת התראות—זה מפחית עומס בדיקות.

מה כלול בעבודה

האינטגרציה שלנו אינה רק הכנסת קוד. אנו מספקים:

• מודול שליחת הודעות טקסט—מחלקה/שירות ייעודיים עם תמיכה במצבים טרנזקציונליים ושיווקיים.
• מטפלי webhook—קבלת סטטוסי אספקה ורישומם לקובץ לוג או למסד נתונים.
• תיעוד—תיאור שיטות, סכמת אינטגרציה, הוראות למנהלים.
• בדיקות בסביבת sandbox—בדיקת שליחה, טיפול בשגיאות, מגבלות.
• הדרכה—הדגמה כיצד להשיק קמפיינים ולקרוא סטטיסטיקות.

לוח זמנים ועלות

אינטגרציה בסיסית דרך REST API אורכת מיום עסקים אחד. אם נדרשת רישום שם אלפא (3–5 ימים לאישור עם MTS), הוסיפו זמן זה. מחזור מלא עם בדיקות ותיעוד אורך עד שבוע. עלות אינטגרציה טיפוסית מתחילה ב-$500, והחיסכון החודשי הממוצע לאחר אינטגרציה מגיע ל-$1,200. אנו תמיד מספקים את המספר הסופי לפני תחילת העבודה. ללא עמלות נסתרות. באמצעות אינטגרציה, אתם מפחיתים עלויות הודעות טקסט בעד 30% על ידי אופטימיזציה של מסלולים ומיקוד.

שלבי אינטגרציה

1. קבלו client_id ו-client_secret מחשבון MTS Marketer האישי שלכם.
2. רשמו שם אלפא (שם שולח) עם MTS (אורך 3–5 ימים).
3. יישמו מנגנון חידוש טוקן כמתואר לעיל.
4. כתבו קוד לשליחת הודעות טקסט טרנזקציונליות או שיווקיות דרך ה-API.
5. הגדירו webhooks לקבלת סטטוסי אספקה.
6. בדקו בסביבת sandbox.
7. פרסו לייצור ועקבו.

לצוות שלנו ניסיון רב באינטגרציות SMS ויישמנו למעלה מ-50 פרויקטים למסחר אלקטרוני, בנקים ולוגיסטיקה. MTS Marketer מספק הודעות פי 2 מהר יותר מפלטפורמות מתחרות, מבטיח אספקה יציבה ועמידה ב-SLA. צרו קשר להערכה מפורטת של הפרויקט שלכם. בקשו ייעוץ עם מהנדס אינטגרציה של MTS Marketer.