بدء سريع · Laravel / PHP

إرسال أول رسالة واتساب من Laravel أو PHP

طريقتان: حزمة Composer الرسمية إن كان مشروعك PHP أو Laravel، أو طلب cURL خام إن لم تُرد أي اعتمادية إضافية. كلاهما يصل إلى نفس واجهة REST API.

الطريقة الأولى: حزمة Composer

bash
composer require wasaas/wasaas-php

تتطلب PHP ^8.1 with ext-json. في Laravel، الاكتشاف التلقائي يسجّل الخدمة بدون أي تعديل في config/app.php. أضف المفتاح إلى .env:

dotenv
WASAAS_API_KEY=wsa_your_api_key

ثم أرسل الرسالة من أي Controller أو سكربت:

php
<?php

use Wasaas\WasaasClient;

$wasaas = app(WasaasClient::class); // أو حقنه عبر الـ constructor

$wasaas->messages->sendText(
    sessionId: 'customer-5-1',
    to:        '966501234567',
    message:   'مرحبًا من Wasaas 👋',
);

خارج Laravel، أنشئ العميل مباشرة بدلًا من الحاوية:

php
$wasaas = new Wasaas\WasaasClient(apiKey: "wsa_your_api_key");

الطريقة الثانية: cURL خام (بدون أي اعتمادية)

إن لم يكن مشروعك على Composer، أو أردت اختبارًا سريعًا بدون تثبيت أي شيء، نفس الطلب بـ cURL الخام في PHP:

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 وPHP | Wasaas