LandChat WhatsApp Gateway

1 طلب رمز سحري ورابط واتساب (Request Verification Code)

أرسل طلب POST من خادمك أو تطبيقك:

POST https://api.w.landchat.me/api/v1/verification/request
Headers:
  Authorization: Bearer sk_live_YOUR_API_KEY
  Content-Type: application/json

Body:
{
  "phone": "+9647801234567",
  "app_name": "اسم تطبيقك"
}

الاستجابة (Response 200 OK):

{
  "success": true,
  "session_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "magic_code": "LC-8X9K2M",
  "whatsapp_url": "https://wa.me/9647800000000?text=MyCoolApp%3A%20LC-8X9K2M",
  "whatsapp_scheme_url": "whatsapp://send?phone=9647800000000&text=MyCoolApp%3A%20LC-8X9K2M",
  "expires_in": 60
}

2 توجيه المستخدم إلى واتساب (Redirect User)

في تطبيقك، افتح الرابط whatsapp_url بواسطة متصفح الهاتف أو URL Launcher. سيفتح واتساب محادثة مع البوت بالرسالة معبأة وجاهزة، فيضغط المستخدم «إرسال».

3 التحقق التلقائي من نجاح العملية (Check Status)

قم بفحص حالة الجلسة كل ثانيتين من تطبيقك عبر الطلب:

GET https://api.w.landchat.me/api/v1/verification/status?session_token=a1b2c3d4-e5f6-7890-abcd-ef1234567890
Headers:
  Authorization: Bearer sk_live_YOUR_API_KEY

الاستجابة (عند إرسال المستخدم للرسالة):

{
  "success": true,
  "verified": true,
  "verified_at": "2026-11-07T05:20:00Z",
  "phone": "+9647801234567"
}

أمثلة برمجية بلغات مختلفة (Code Snippets)