إرسال رسائل نصية لـ 24 ساعة عبر API من WhatChimp

كيفية إرسال رسائل نصية خلال نافذة جلسة WhatsApp لـ 24 ساعة باستخدام API من WhatChimp.

Updated 5 February 2026

يسمح WhatsApp للشركات بإرسال ردود نصية حرة للعملاء — ولكن فقط خلال 24 ساعة من آخر رسالة للعميل. يُسمى هذا رسالة جلسة أو رسالة نافذة 24 ساعة. يوضح لك هذا الدليل كيفية إرسال رسائل نصية عبر API من WhatChimp ويشرح بالضبط كيف تعمل قاعدة الـ 24 ساعة.

قبل أن تبدأ: تأكد من أن لديك API key و phone number ID. راجع البدء مع واجهة برمجة التطبيقات Developer API من WhatChimp لتعليمات الإعداد.

ما هي نافذة الجلسة لـ 24 ساعة؟

عندما يرسل لك عميل رسالة على WhatsApp، تُفتح جلسة مدتها 24 ساعة. خلال هذه النافذة، يمكنك الرد بأي رسالة نصية تريدها — لا حاجة لقالب، لا حاجة لموافقة.

بمجرد إغلاق نافذة الـ 24 ساعة (لم يرسل العميل رسالة لك منذ أكثر من 24 ساعة)، لا يمكنك إرسال رسائل نصية بعد الآن. ستُرجع API خطأ.

نقاط رئيسية:

ساعة الـ 24 ساعة تُعاد تعيينها في كل مرة يرسل لك العميل رسالة
فقط العميل يمكنه فتح جلسة — لا يمكنك فتح واحدة بنفسك
الرسائل النصية خلال الجلسة هي جزء من محادثة بدأها العميل (مستوى تكلفة أقل)
خارج نافذة الـ 24 ساعة، يجب عليك استخدام رسالة قالب بدلاً من ذلك

API console تعرض endpoint Send Message وشرح الرسائل النصية مقابل رسائل القوالب

متى تستخدم الرسائل النصية

الرسائل النصية هي الخيار الصحيح عندما:

أرسل لك عميل رسالة في آخر 24 ساعة وأنت تجيب عليه
أنت تبني chatbot يستجيب للرسائل الواردة
أنت تتعامل مع ردود Live Chat على استفسارات العملاء
أنت ترسل متابعة سريعة بينما المحادثة لا تزال نشطة

لا تستخدم الرسائل النصية لـ:

إرسال إشعارات أو تذكيرات أو تحديثات طلبات — استخدم رسالة قالب
الوصول إلى العملاء الذين لم يرسلوا لك رسائل مؤخراً
Broadcasting رسائل ترويجية
إرسال OTP أو أكواد تحقق

API Endpoint

Endpoint: GET/POST /api/v1/whatsapp/send

URL كامل: https://app.whatchimp.com/api/v1/whatsapp/send

المعاملات:

المعامل	النوع	مطلوب	الوصف
`apiToken`	String	نعم	مفتاح API الخاص بـ WhatChimp
`phone_number_id`	String	نعم	معرّف رقم هاتف WhatsApp الخاص بك
`message`	String	نعم	محتوى الرسالة النصية (ترميز URL لطلبات GET)
`phone_number`	String	نعم	رقم هاتف المستلم مع رمز البلد، رقمي فقط (مثل `919999999999`)

إرسال رسالة نصية

طلب GET:

https://app.whatchimp.com/api/v1/whatsapp/send?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&message=مرحباً%2C+شكراً+للتواصل+معنا!&phone_number=919999999999

طلب POST (curl):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/send' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'message=مرحباً، شكراً للتواصل معنا!' \
  -d 'phone_number=919999999999'

استجابة النجاح:

{
  "status": "1",
  "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
  "message": "Message sent successfully."
}

استجابات الخطأ

نافذة الـ 24 ساعة منتهية الصلاحية:

إذا حاولت إرسال رسالة نصية خارج نافذة الجلسة، فستُرجع API خطأ. عندما يحدث هذا، انتقل إلى رسالة قالب.

تجاوز حد المشتركين:

{"status": "0", "message": "Subscriber limit has been exceeded. You cannot have more subscribers."}

هذا يعني أنه تم الوصول إلى حد المشتركين في خطة WhatChimp الخاصة بك. قم بترقية خطتك أو إزالة المشتركين غير النشطين.

نصائح

قم بترميز رسالتك بـ URL عند استخدام طلبات GET. تصبح المسافات %20 أو +، تحتاج الأحرف الخاصة إلى ترميز.
احفظ wa_message_id من استجابة النجاح — يمكنك استخدامه لتتبع حالة التسليم لاحقاً.
إذا فشلت رسالتك، تحقق مما إذا كانت نافذة الـ 24 ساعة لا تزال مفتوحة. إذا لم يكن الأمر كذلك، استخدم رسالة قالب بدلاً من ذلك.
للردود التلقائية (chatbots)، تعمل الرسائل النصية بشكل مثالي حيث يبدأ العميل المحادثة.