Senders Management API

Manage sender IDs for your SMS messages.

Add Sender Text

Add a text sender ID to your account.

Endpoint

GET https://www.sms.deals/api/ws.php?service=add_sender_text

Parameters

Parameter	Type	Required	Description
service	String	Required	Must be add_sender_text
token	String	Optional	Account identification token
sender	String	Required	Sender text (Latin letters first, 3-11 chars, can contain a-z, A-Z, 0-9, _, -)

PHP Example

<?php
$token = "xxxxxx...";
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://sms.deals/api/ws.php?service=add_sender_text&sender=test",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "utf-8",
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer " . $token
    )
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

---

Add Sender Phone

Add a phone number as a sender ID (two-step verification process).

Step 1: Request Verification Code

POST https://www.sms.deals/api/ws.php?service=add_sender_phone_step1

Parameter	Type	Required	Description
service	String	Required	Must be add_sender_phone_step1
token	String	Optional	Account identification token
sender	Integer	Required	Phone number (no dashes) or speed dial (*XXXX)
otp_type	String	Required	sms, call, or distributor

Step 2: Verify Code

POST https://www.sms.deals/api/ws.php?service=add_sender_phone_step2

Parameter	Type	Required	Description
service	String	Required	Must be add_sender_phone_step2
token	String	Optional	Account identification token
sender	Integer	Required	Same phone number as Step 1
otp_key	Integer	Required	6-digit verification code
sender_description	String	Optional	Description (English and/or Hebrew)

---

Get Sender List

Retrieve list of approved senders.

Endpoint

GET https://www.sms.deals/api/ws.php?service=get_sender_list

Parameters

Parameter	Type	Required	Description
service	String	Required	Must be get_sender_list
token	String	Optional	Account identification token
search	String	Optional	Search filter (numbers and Latin letters)

Response Example

{
    "status": "success",
    "senders": [
        {
            "sender": "0541234567",
            "type": "phone",
            "description": "Main office",
            "verified": true
        },
        {
            "sender": "MyCompany",
            "type": "text",
            "description": "",
            "verified": true
        }
    ]
}

השפעות על המערכת

שם השולח (Sender ID) מגדיר איך הנמען רואה את ההודעה:

• תצוגה אצל הנמען — שם השולח (טקסטואלי או מספרי) מופיע כ‑from; חובה שיהיה מאושר מראש
• אימות טלפון — הוספת מספר כשולח היא תהליך דו‑שלבי (OTP ב‑SMS/שיחה/מפיץ); ללא אימות השולח לא יהיה זמין לשליחה
• רגולציה — שמות שולח טקסטואליים כפופים לאישור רגולטורי באזורים שונים; יש חברות ומדינות הדורשות רישום מקדים
• מגבלות פורמט — שם טקסטואלי: 3‑11 תווים, אותיות לטיניות תחילה, ללא רווחים; מספר: ללא מקפים (תומך גם ב‑Speed Dial *XXXX)
• שליחה ללא sender מאושר — כל קריאת send_sms עם sender לא מאושר תיכשל עם שגיאת הרשאה

ראו גם

• שליחת SMS
• שליחה מרוכזת
• יתרת קרדיט
• ניהול אנשי קשר