חיבור API לשליחת מסרונים – מדריך טכני שלב אחר שלב

מבוא

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

שלב 1: הרשמה וקבלת מפתח API

לפני שמתחילים, יש להירשם לחשבון מסר 10 ולקבל מפתח API:

1. היכנסו ל-meser10.co.il ולחצו על "כניסת לקוחות"
2. עברו להגדרות חשבון ← API
3. העתיקו את מפתח ה-API שלכם

שלב 2: הבנת ה-Endpoint

ה-API של מסר 10 פועל על בסיס HTTP REST. נקודת הקצה (Endpoint) לשליחת SMS היא:

POST https://www.meser10.co.il/wp-json/meser/v1/sms/send

שלב 3: פרמטרים נדרשים

כל בקשה חייבת לכלול את הפרמטרים הבאים:

• api_key – מפתח ה-API שלכם
• phone – מספר הטלפון של הנמען (פורמט: 05X-XXXXXXX)
• message – תוכן ההודעה (עד 160 תווים לSMS בודד)
• from – שם השולח (אופציונלי)

שלב 4: דוגמת קוד – PHP

<?php
$api_key = 'YOUR_API_KEY';
$phone   = '0501234567';
$message = 'שלום! הזמנתך #1234 אושרה ותגיע תוך 3 ימי עסקים.';

$response = wp_remote_post('https://www.meser10.co.il/api/sms', [
    'body' => [
        'api_key' => $api_key,
        'phone'   => $phone,
        'message' => $message,
    ]
]);

$result = json_decode(wp_remote_retrieve_body($response), true);
echo $result['status']; // success / error
?>

שלב 5: דוגמת קוד – Python

import requests

api_key = 'YOUR_API_KEY'
phone   = '0501234567'
message = 'שלום! הזמנתך אושרה.'

response = requests.post('https://www.meser10.co.il/api/sms', data={
    'api_key': api_key,
    'phone':   phone,
    'message': message,
})

result = response.json()
print(result['status'])  # success / error

שלב 6: טיפול בתגובות

ה-API מחזירה תגובת JSON עם הפרמטרים הבאים:

• status: "success" או "error"
• message_id: מזהה ייחודי לכל הודעה (לצורכי מעקב)
• credits_used: מספר הקרדיטים שנוצלו
• error_code: קוד שגיאה (אם ישנה)

טיפים חשובים

• אל תכניסו את מפתח ה-API ישירות בקוד — שמרו אותו בקובץ הגדרות (.env)
• טפלו בשגיאות בצורה מסודרת — בדקו את קוד ה-status לפני שממשיכים
• לשליחת הודעות בעברית, ודאו שהקידוד הוא UTF-8
• בדקו את הדוקומנטציה המלאה באתר מסר 10 לפרמטרים נוספים

תיעוד מלא

לתיעוד המלא של ה-API, כולל כל הפרמטרים האפשריים ודוגמאות בשפות נוספות (Node.js, Java, C#), בקרו בדף תיעוד ה-API שלנו.