بدء سريع · Laravel / PHP
إرسال أول رسالة واتساب من Laravel أو PHP
طريقتان: حزمة Composer الرسمية إن كان مشروعك PHP أو Laravel، أو طلب cURL خام إن لم تُرد أي اعتمادية إضافية. كلاهما يصل إلى نفس واجهة REST API.
الطريقة الأولى: حزمة Composer
composer require wasaas/wasaas-phpتتطلب PHP ^8.1 with ext-json. في Laravel، الاكتشاف التلقائي يسجّل الخدمة بدون أي تعديل في config/app.php. أضف المفتاح إلى .env:
WASAAS_API_KEY=wsa_your_api_keyثم أرسل الرسالة من أي Controller أو سكربت:
<?php
use Wasaas\WasaasClient;
$wasaas = app(WasaasClient::class); // أو حقنه عبر الـ constructor
$wasaas->messages->sendText(
sessionId: 'customer-5-1',
to: '966501234567',
message: 'مرحبًا من Wasaas 👋',
);خارج Laravel، أنشئ العميل مباشرة بدلًا من الحاوية:
$wasaas = new Wasaas\WasaasClient(apiKey: "wsa_your_api_key");الطريقة الثانية: cURL خام (بدون أي اعتمادية)
إن لم يكن مشروعك على Composer، أو أردت اختبارًا سريعًا بدون تثبيت أي شيء، نفس الطلب بـ cURL الخام في PHP:
<?php
$ch = curl_init('https://wasaas.org/api/v1/messages');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer wsa_your_api_key',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'session_id' => 'customer-5-1',
'to' => '966501234567',
'message' => 'مرحبًا من Wasaas 👋',
]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
// $response === ["success" => true, "to" => "966501234567", "status" => "sent"]إن فشل الطلب
حزمة Composer ترمي Wasaas\Exceptions\WasaasApiException وتعرض getStatusCode(). أهمها: 401 مفتاح غير صالح · 404 الجلسة غير موجودة · 429 تجاوز الحصة الشهرية. طريق cURL الخام يقرأ نفس الحقول من جسم استجابة JSON مباشرة.
حدود حقيقية
هذا ربط غير رسمي ومبني على الجلسات عبر رمز QR، وليس منصة واتساب الرسمية لمنتجات الأعمال. أنواع الرسائل المدعومة هي النص والصورة والمستند فقط، ولا يوجد حاليًا إرسال أحداث (webhooks) إلى سيرفرك الخاص.
إلى أين تذهب بعد ذلك
- دليل Laravel الكامل — الحقن عبر الحاوية، الأخطاء الشائعة، تشغيل الإرسال داخل Queue
- الحصول على مفتاح API — إن لم ينشئ المفتاح بعد
- توثيق REST API (بالإنجليزية) — كل نقطة نهاية وحقل تستدعيه الحزمة أو cURL
- أسعار واجهة API للواتساب — حدود الرسائل لكل باقة