Laravel
ربط واتساب مع Laravel
دعم Laravel يأتي داخل نفس حزمة Composer الخاصة بعميل PHP. ثبّتها، ويقوم الاكتشاف التلقائي في Laravel بتسجيل مزود خدمة يبني العميل من إعداداتك — فتحقنه مثل أي خدمة أخرى، وترسل رسائل واتساب من الـ Controllers أو الـ Jobs أو الأوامر.
حزمة واحدة، وليست حزمتين
لا توجد حزمة Laravel منفصلة. wasaas/wasaas-php تُعرّف مزود خدمة Laravel واسمًا مستعارًا (facade) داخل قسم extra.laravel في ملفها، وهذا ما يجعل الاكتشاف التلقائي يعمل. كل ما هو موضح في صفحة PHP (بالإنجليزية) ينطبق هنا أيضًا؛ هذه الصفحة تغطي فقط إعداد Laravel.
التثبيت
composer require wasaas/wasaas-phpمنشورة على Packagist باسم wasaas/wasaas-php (الإصدار 1.0.0).
تتطلب PHP ^8.1 with ext-json. يكتشف Laravel Wasaas\Laravel\WasaasServiceProvider تلقائيًا — لا حاجة لإضافة أي شيء في config/app.php.
الإعداد
أضف بيانات الاعتماد إلى .env:
WASAAS_API_KEY=wsa_your_api_key
WASAAS_BASE_URL=https://wasaas.orgWASAAS_BASE_URL اختياري وقيمته الافتراضية https://wasaas.org. انشر ملف الإعدادات إذا أردته داخل مستودعك:
php artisan vendor:publish --tag=wasaas-configهذا الأمر ينشئ config/wasaas.php، والذي يقرأ القيمتين من متغيرات البيئة.
استخدام العميل عبر الحقن
يُسجّل المزود Wasaas\WasaasClient كـ singleton مبني من إعداداتك، مع اسم مستعار في الحاوية هو wasaas. الحقن عبر الـ constructor هو الأسلوب المعتاد:
<?php
namespace App\Http\Controllers;
use Wasaas\WasaasClient;
class OrderController extends Controller
{
public function __construct(private readonly WasaasClient $wasaas) {}
public function shipped(Order $order)
{
$this->wasaas->messages->sendText(
sessionId: config('services.wasaas.session'),
to: $order->customer->whatsapp,
message: "تم شحن طلبك رقم #{$order->id}.",
);
return back();
}
}خارج الـ constructor، احصل عليه من الحاوية مباشرة:
app(\Wasaas\WasaasClient::class)->messages->sendText($sessionId, $to, $message);
// الاسم المستعار في الحاوية يحل إلى نفس الـ singleton:
app('wasaas')->messages->sendText($sessionId, $to, $message);استدعِ الموارد مباشرة، وليس اختصار الـ facade
تُسجّل الحزمة اسمًا مستعارًا (facade) باسم Wasaas، وتوثيقها الداخلي يُشير إلى اختصارات ثابتة مثل Wasaas::sendText(...). هذه الاختصارات لا تعمل في الإصدار 1.0.0: الـ facade يُحل إلى WasaasClient، والذي يعرض messages و sessions و numbers كخصائص، ولا يُعرّف دالة sendText، فيرمي الاستدعاء الثابت استثناء BadMethodCallException.
استخدم الحقن أو app(...) كما في المثال أعلاه، عبر ->messages->sendText(...).
ضعها داخل Queue
الإرسال هو استدعاء HTTP متزامن، لذا ضعه داخل Job بدلًا من دورة الطلب عندما يكون المستخدم بانتظار الرد. محاولات الإرسال الفاشلة ترمي WasaasApiException، والتي يتعامل معها Laravel مثل أي استثناء آخر عند إعادة المحاولة.
<?php
namespace App\Jobs;
use Illuminate\Contracts\Queue\ShouldQueue;
use Wasaas\Exceptions\WasaasApiException;
use Wasaas\WasaasClient;
class SendWhatsAppMessage implements ShouldQueue
{
public int $tries = 3;
public function __construct(
private readonly string $to,
private readonly string $message,
) {}
public function handle(WasaasClient $wasaas): void
{
try {
$wasaas->messages->sendText(
sessionId: config('services.wasaas.session'),
to: $this->to,
message: $this->message,
);
} catch (WasaasApiException $e) {
// 429 تعني استهلاك الحصة الشهرية — لا تُعد المحاولة
if ($e->getStatusCode() === 429) {
$this->fail($e);
return;
}
throw $e;
}
}
}حدود حقيقية
هذا ربط غير رسمي ومبني على الجلسات عبر رمز QR، وليس منصة واتساب الرسمية لمنتجات الأعمال. لا يوجد حاليًا إرسال أحداث (webhooks) إلى سيرفرك الخاص. أنواع الرسائل المدعومة هي النص والصورة والمستند فقط.
إلى أين تذهب بعد ذلك
- واتساب API للمطورين — الصورة الكاملة: المكتبات وخطوات الربط
- واجهة PHP الكاملة (بالإنجليزية) — كل الدوال: الصور والمستندات والجلسات والتحقق من الأرقام
- توثيق REST API (بالإنجليزية) — نقاط النهاية والحقول ورموز الأخطاء
- أسعار واجهة API للواتساب — حدود الرسائل والجلسات لكل باقة