composer require hypersender/hypersender-laravel
 
انشر ملف الإعدادات:
 
```bash
php artisan vendor:publish --tag=hypersender-config

HYPERSENDER_WHATSAPP_API_KEY=your_api_key
HYPERSENDER_WHATSAPP_INSTANCE_ID=your_instance_id

use Hypersender\Hypersender;
 
Hypersender::whatsapp()
    ->safeSendTextMessage(
        chat_id: '20123456789@c.us',
        text: 'مرحباً من Laravel!'
    );

Hypersender::whatsapp()
    ->sendImageUrl(
        chat_id: '20123456789@c.us',
        url: 'https://example.com/image.jpg',
        caption: 'شوف هذا!'
    );

use Illuminate\Support\Facades\Storage;
 
$filePath = Storage::path('images/photo.jpg');
 
Hypersender::whatsapp()
    ->sendImageUpload(
        chat_id: '20123456789@c.us',
        filePath: $filePath,
        caption: 'صورة من تطبيقنا'
    );

Hypersender::whatsapp()
    ->sendVideoUrl(
        chat_id: '20123456789@c.us',
        url: 'https://example.com/video.mp4',
        caption: 'فيديو تعليمي'
    );

Hypersender::whatsapp()
    ->sendFileUrl(
        chatId: '20123456789@c.us',
        url: 'https://example.com/invoice.pdf',
        fileName: 'invoice.pdf',
        mimeType: 'application/pdf',
        caption: 'فاتورتك'
    );

Hypersender::whatsapp()
    ->sendLocation(
        chat_id: '20123456789@c.us',
        latitude: '37.7749',
        longitude: '-122.4194',
        title: 'مكتبنا'
    );

php artisan make:notification OrderConfirmed

namespace App\Notifications;
 
use App\Models\Order;
use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;
use Hypersender\Notifications\WhatsappChannel;
use Hypersender\Notifications\WhatsappMessage;
 
class OrderConfirmed extends Notification
{
    use Queueable;
 
    public function __construct(
        public Order $order
    ) {}
 
    public function via($notifiable): array
    {
        return [WhatsappChannel::class];
    }
 
    public function toWhatsapp($notifiable): WhatsappMessage
    {
        $message = "مرحباً {$notifiable->name}!\n\n";
        $message .= "طلبك #{$this->order->id} تأكد.\n\n";
        $message .= "المنتجات:\n";
 
        foreach ($this->order->items as $item) {
            $message .= "• {$item->name} (x{$item->quantity})\n";
        }
 
        $message .= "\nالمجموع: {$this->order->total} ريال\n";
        $message .= "وقت التوصيل المتوقع: {$this->order->delivery_date}";
 
        return WhatsappMessage::create()
            ->text($message);
    }
}

namespace App\Models;
 
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
 
class User extends Authenticatable
{
    use Notifiable;
 
    public function routeNotificationForWhatsapp(): string
    {
        // الصيغة: رقم الجوال مع كود الدولة + @c.us
        $phone = preg_replace('/[^0-9]/', '', $this->phone);
        return $phone . '@c.us';
    }
}

use App\Notifications\OrderConfirmed;
 
class OrderController extends Controller
{
    public function store(Request $request)
    {
        $order = Order::create($request->validated());
 
        // أرسل إشعار واتساب
        $request->user()->notify(new OrderConfirmed($order));
 
        return redirect()->route('orders.show', $order);
    }
}

use App\Models\User;
use App\Notifications\OrderConfirmed;
 
$user = User::find(1);
$user->notify(new OrderConfirmed($order));

use Illuminate\Support\Facades\Notification;
use App\Notifications\OrderConfirmed;
 
Notification::route('whatsapp', '966501234567@c.us')
    ->notify(new OrderConfirmed($order));

namespace App\Jobs;
 
use Hypersender\Hypersender;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
 
class SendWhatsAppMessage implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable;
 
    public function __construct(
        public string $chatId,
        public string $message
    ) {}
 
    public function handle(): void
    {
        Hypersender::whatsapp()
            ->safeSendTextMessage(
                chat_id: $this->chatId,
                text: $this->message
            );
    }
}

SendWhatsAppMessage::dispatch($chatId, $message);

use Hypersender\Events\Whatsapp\MessagesAny;
 
protected $listen = [
    MessagesAny::class => [
        HandleIncomingWhatsAppMessage::class,
    ],
];

namespace App\Listeners;
 
use Hypersender\Events\Whatsapp\MessagesAny;
use Illuminate\Support\Facades\Log;
 
class HandleIncomingWhatsAppMessage
{
    public function handle(MessagesAny $event): void
    {
        $message = $event->payload;
 
        Log::info('استقبلت رسالة واتساب', [
            'من' => $message['key']['remoteJid'],
            'النص' => $message['message']['conversation'] ?? null,
        ]);
 
        // حط الكود حقك هنا
        // رد على الرسالة، احفظها في قاعدة البيانات، الخ.
    }
}