هايبرسندر
الميزاتOTPباكدج Laravelحالات الاستخدامMCPالأسعارالأسئلة الشائعةالوثائقالمدونة
تسجيل الدخولابدأ الآن
هايبرسندر

المنتج

  • الميزات
  • حالات الاستخدام
  • MCP server
  • الأسعار
  • أسعار WhatsApp API
  • باكدج Laravel
  • الوثائق

مصادر

  • الأسئلة الشائعة
  • المدونة
  • ديسكورد
  • واتساب

قانوني

  • الشروط والأحكام
  • سياسة الخصوصية

حقوق النشر © 2026 هايبرسندر. جميع الحقوق محفوظة.

Featured on LaunchAFGET IT ONGoogle Play
HypersenderHypersenderHypersenderHypersenderHypersender
جميع المقالات

أدلة المطورين

كيفية إرسال رسائل واتساب في Laravel

تعلّم تثبيت Hypersender Laravel SDK وإعداد بيانات API وإرسال رسائل واتساب من تطبيق Laravel، مع أمثلة على الطلبات المؤجلة وwebhooks.

Hypersender·11 ديسمبر 2025·3 دقائق للقراءة
موجات خضراء عمودية تتدفق على خلفية داكنة
في هذه الصفحة
  1. إيش راح تحتاج
  2. التثبيت
  3. أرسل أول رسالة لك
  4. ملاحظة حول safeSendTextMessage
  5. أرسل أنواع رسائل مختلفة
  6. الصور
  7. الفيديوهات
  8. المستندات
  9. الموقع
  10. مثال حقيقي: إشعارات الطلبات
  11. استخدم Queues لأداء أفضل
  12. تعامل مع الرسائل الواردة
  13. مشاكل شائعة
  14. الرسائل ما ترسل
  15. صيغة Chat ID غلط
  16. الواتساب يحد من عدد الرسائل
  17. الخطوات الجاية

في هذه الصفحة

  1. إيش راح تحتاج
  2. التثبيت
  3. أرسل أول رسالة لك
  4. ملاحظة حول safeSendTextMessage
  5. أرسل أنواع رسائل مختلفة
  6. الصور
  7. الفيديوهات
  8. المستندات
  9. الموقع
  10. مثال حقيقي: إشعارات الطلبات
  11. استخدم Queues لأداء أفضل
  12. تعامل مع الرسائل الواردة
  13. مشاكل شائعة
  14. الرسائل ما ترسل
  15. صيغة Chat ID غلط
  16. الواتساب يحد من عدد الرسائل
  17. الخطوات الجاية

تبي تستخدم WhatsApp API في Laravel؟ يشرح هذا الدليل تثبيت Hypersender Laravel SDK وإرسال أول رسالة ومعالجة الطلبات المؤجلة وwebhooks. للاطلاع على تفاصيل الحزمة الحالية، راجع وثائق Laravel SDK.

إيش راح تحتاج

قبل ما تبدأ، تحتاج:

  • تطبيق Laravel (8.x أو أحدث)
  • PHP 8.2+
  • حساب Hypersender (سجل هنا)
  • مفتاح الـAPI ورقم الـInstance من لوحة تحكم Hypersender

التثبيت

ثبّت Hypersender SDK عن طريق Composer:

bash
composer require hypersender/hypersender-laravel

انشر ملف الإعدادات:

bash
php artisan vendor:publish --tag=hypersender-config

حط بياناتك في ملف .env:

env
HYPERSENDER_WHATSAPP_API_KEY=your_api_key
HYPERSENDER_WHATSAPP_INSTANCE_ID=your_instance_id

تلاقي مفتاح الـAPI ورقم الـInstance في لوحة تحكم Hypersender تحت الإعدادات.

أرسل أول رسالة لك

هذي أسهل طريقة ترسل رسالة واتساب:

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

صيغة chat_id تكون رقم الجوال (مع كود الدولة) وبعدين @c.us. مثلاً، رقم سعودي +966 50 123 4567 يصير 966501234567@c.us.

ملاحظة حول safeSendTextMessage

توضح وثائق الإرسال سلوك safeSendTextMessage وخياراته. لا تضمن هذه الطريقة تجنب قيود الحساب أو حظر الرقم؛ اتبع شروط WhatsApp وتواصل مع العملاء بما يتوافق مع توقعاتهم.

أرسل أنواع رسائل مختلفة

الصور

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

أو ارفع من storage Laravel حقك:

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

الفيديوهات

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

المستندات

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

الموقع

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

مثال حقيقي: إشعارات الطلبات

هذا كيف ترسل تأكيدات الطلبات باستخدام نظام الإشعارات في Laravel:

أول شي، سوّي كلاس notification:

bash
php artisan make:notification OrderConfirmed

بعدين سوّي الـnotification:

php
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);
    }
}

حط method الـrouteNotificationForWhatsapp في model User حقك:

php
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';
    }
}

الحين أرسل الإشعارات من الـcontroller حقك:

php
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);
    }
}

تقدر أيضاً ترسل لأي مستخدم:

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

أو استخدم on-demand notifications للضيوف:

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

استخدم Queues لأداء أفضل

إرسال الرسائل بشكل مباشر ممكن يبطّي تطبيقك. استخدم Laravel queues عشان ترسل الرسائل في الخلفية:

php
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
            );
    }
}

شغّل الـjob:

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

تعامل مع الرسائل الواردة

الـSDK تلقائياً يسوي webhook route للرسائل الواردة. استمع للأحداث في EventServiceProvider حقك:

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

سوّي الـlistener:

php
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,
        ]);
 
        // حط الكود حقك هنا
        // رد على الرسالة، احفظها في قاعدة البيانات، الخ.
    }
}

مشاكل شائعة

الرسائل ما ترسل

تأكد إن رقم الواتساب حقك متصل في لوحة تحكم Hypersender. تحتاج تمسح رمز الـQR قبل ما تقدر ترسل رسائل.

صيغة Chat ID غلط

الـchat ID لازم يكون بصيغة phonenumber@c.us. لا تحط علامة + أو أي مسافات. بس أرقام وبعدين @c.us.

الواتساب يحد من عدد الرسائل

راجع استجابة API وحدود خطتك، وتأكد من اتصال الرقم. تساعدك وثائق الطلبات المؤجلة على متابعة حالة المعالجة. لا تضمن طريقة الإرسال أو التأخير وصول الرسالة أو تجنب قيود الحساب.

الخطوات الجاية

الحين إنك عرفت الأساسيات، تقدر:

  • تسوي معالجة webhook لمحادثات ذهاب وإياب
  • تابع معالجة الطلب في قائمة الانتظار وراجع إشعار استلام الرسالة لمعرفة حالة التسليم
  • افحص محاولات تسليم Webhook الفاشلة وأعد المحاولة
  • تكتشف وثائق الـAPI الكاملة

وثائق الـSDK الكاملة موجودة في docs.hypersender.com.

جاهز ترسل من تطبيقك؟ سجل حساب Hypersender وتحصل على مفتاح الـAPI ورقم الـInstance.

تابع القراءة

شبكة خضراء دقيقة تتوهج بهدوء على سطح داكن

تحديثات المنتج

نقدم لكم سجلات Webhook

تعرّف على سجلات Webhook في Hypersender لتتبع الأحداث، وفحص الطلبات والردود، وتصفية المحاولات، وإعادة إرسال عمليات التسليم الفاشلة.

20 أكتوبر 2025·1 دقائق للقراءة

بقلم Hypersender

خطوط خضراء رفيعة تتجه نحو نقطة مضيئة على خلفية داكنة

أدلة

كيفية تجنب حظر رقم واتساب

خايف رقمك ينحظر في الواتساب؟ تعلم الطرق المجربة والاستراتيجيات عشان تبقى في الجانب الآمن وتضمن تواصل فعّال وآمن!

7 أبريل 2025·1 دقائق للقراءة

بقلم Hypersender

حلقات خضراء واسعة تنتشر للخارج على خلفية داكنة

أدلة

استخدام واتساب بزنس مع خط أرضي

اكتشف كيف تستفيد من رقم خطك الأرضي الموجود عشان تفتح قوة واتساب بزنس. دليل بسيط للتواصل مع عملائك بطريقة جديدة!

7 أبريل 2025·1 دقائق للقراءة

بقلم Hypersender