البدء السريع
من الصفر إلى رسالة واصلة في خمس خطوات.
1. أنشئ حسابًا#
سجّل في sms.liscosolutions.com. تحصل على مساحة عمل خاصة بك، يتبع لها فريقك وهواتفك ومفاتيح API.
2. اربط هاتفًا#
- على هاتف أندرويد فيه شريحة SIM، ثبّت تطبيق LiSco SMS Gateway من
sms.liscosolutions.com/download. - في لوحة التحكم افتح الأجهزة ← ربط هاتف. يظهر رمز QR ورمز ربط من 6 خانات (
XXX-XXX) صالحان لمدة 10 دقائق. - في التطبيق امسح رمز QR أو اكتب رمز الربط. يظهر الهاتف خلال ثوانٍ في قائمة الأجهزة بحالة متصل.
3. أنشئ مفتاح API#
افتح مفاتيح API والـ Webhooks ← إنشاء مفتاح، وأعطه اسمًا، ثم انسخ المفتاح. يبدأ بـ lsk_live_ ويُعرض مرة واحدة فقط.
احفظ المفتاح على خادمك. لا تضعه أبدًا في موقع ويب أو إضافة متصفح أو تطبيق جوال: من يملكه يستطيع إرسال الرسائل من هواتفك.
4. أرسل رسالتك الأولى#
ضع مفتاحك ورقمك مكان القيم في المثال:
curl -X POST "https://sms.liscosolutions.com/v1/messages" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"to":"+905321234567","text":"Order #1042 is ready for pickup."}'const res = await fetch("https://sms.liscosolutions.com/v1/messages", {
method: "POST",
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
to: "+905321234567",
text: "Order #1042 is ready for pickup."
}),
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/messages");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"to" => "+905321234567",
"text" => "Order #1042 is ready for pickup.",
]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.post(
"https://sms.liscosolutions.com/v1/messages",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"to": "+905321234567",
"text": "Order #1042 is ready for pickup.",
},
)
print(res.status_code, res.json())الرد · 201
{
"id": "6650f1c2e4b0a1b2c3d4e5f6",
"to": "+905321234567",
"text": "Order #1042 is ready for pickup.",
"status": "pending",
"deviceId": null,
"sim": null,
"error": null,
"requestId": null,
"createdAt": "2026-11-20T09:15:02.481Z",
"updatedAt": "2026-11-20T09:15:02.481Z",
"expiresAt": "2026-11-21T09:15:02.481Z"
}يعود الرد فورًا بالحالة pending، ويسحب الهاتف الرسالة خلال 3 ثوانٍ تقريبًا.
5. تحقّق من حالتها#
استخدم id الوارد في الرد:
curl "https://sms.liscosolutions.com/v1/messages/6650f1c2e4b0a1b2c3d4e5f6" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"const res = await fetch("https://sms.liscosolutions.com/v1/messages/6650f1c2e4b0a1b2c3d4e5f6", {
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
},
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/messages/6650f1c2e4b0a1b2c3d4e5f6");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.get(
"https://sms.liscosolutions.com/v1/messages/6650f1c2e4b0a1b2c3d4e5f6",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(res.status_code, res.json())الرد · 200
{
"id": "6650f1c2e4b0a1b2c3d4e5f6",
"to": "+905321234567",
"text": "Order #1042 is ready for pickup.",
"status": "delivered",
"deviceId": "6650e0a1e4b0a1b2c3d4e500",
"sim": 1,
"error": null,
"requestId": null,
"createdAt": "2026-11-20T09:15:02.481Z",
"updatedAt": "2026-11-20T09:15:09.210Z",
"expiresAt": "2026-11-21T09:15:02.481Z",
"events": [
{
"at": "2026-11-20T09:15:02.481Z",
"type": "queued",
"deviceId": null,
"sim": null,
"detail": null
},
{
"at": "2026-11-20T09:15:03.902Z",
"type": "claimed",
"deviceId": "6650e0a1e4b0a1b2c3d4e500",
"sim": null,
"detail": null
},
{
"at": "2026-11-20T09:15:06.114Z",
"type": "sent",
"deviceId": "6650e0a1e4b0a1b2c3d4e500",
"sim": 1,
"detail": null
},
{
"at": "2026-11-20T09:15:09.210Z",
"type": "delivered",
"deviceId": "6650e0a1e4b0a1b2c3d4e500",
"sim": 1,
"detail": null
}
]
}الحقل events هو المسار الزمني للرسالة. في بيئة الإنتاج لا تستعلم مرارًا: اضبط Webhook ليستدعي LiSco SMS خادمك كلما تغيّرت الحالة.