حالة نصية
انشر حالة نصية (قصة) على واتساب.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
استخدم هذا للإعلانات القصيرة (مثل، 'نحن مفتوحون!').
اجعل النص قصيرًا ومقروءًا.
فن الحالة النصية
تسمح لك نقطة النهاية /v2/status/text بنشر تحديثات نصية ملونة تمثل حوالي 40% من إجمالي التفاعل مع الحالات على واتساب. على عكس حالات الوسائط، يتم عرض الحالات النصية محلياً على جهاز المستخدم، مما يضمن خطوطاً واضحة وتحميلاً فورياً حتى على الشبكات الضعيفة.
🎨 التنسيق والجماليات
ألوان الخلفية (backgroundColor)
يجب تقديم كود لون سداسي عشري (Hex). ومع ذلك، لا يدعم واتساب كل كود عشوائي.
- أفضل ممارسة: التزم بلوحة ألوان واتساب الرسمية أو ألوان التصميم المادي (Material Design) الآمنة.
- قاعدة "الوضع الداكن": تجنب الخلفيات البيضاء النقية (
#FFFFFF) أو السوداء النقية (#000000) لأنها ترهق العين. استخدم نغمات هادئة مثل الأخضر (#38b42f) أو التيل (#008069) أو الأرجواني (#6f4c9c). - التباين: النص دائماً باللون الأبيض. تأكد من أن خلفيتك توفر تبايناً جيداً.
الخطوط (font)
يوفر واتساب 5 أنواع خطوط مدمجة:
0: Monitor (Sans Serif قياسي) - نظيف واحترافي.1: Script (متصل) - جيد للرسائل الشخصية والتحيات.2: Bold (نمط Impact) - جيد للعناوين العريضة أو التنزيلات.3: Typewriter (Monospace) - جيد للأكواد التقنية.4: Norican (مزخرف) - مشابه للخط المتصل ولكنه أعرض.
🔗 قوة معاينات الروابط
هذه هي الميزة الأقوى في الحالة النصية. إذا قمت بتضمين رابط URL في نص الحالة، فلديك خياران:
1. رابط بسيط
- النتيجة: الرابط قابل للنقر، لكنه يظهر كنص عادي.
- معدل النقر (CTR): منخفض (~2-3%).
2. معاينة غنية (linkPreview: true)
- النتيجة: تقوم الواجهة بجلب معلومات OpenGraph من الموقع المستهدف.
- الصورة: تعرض الصورة البارزة للموقع.
- العنوان: يظهر عنوان الصفحة بخط عريض.
- الوصف: يظهر الوصف التعريفي (Meta Description).
- معدل النقر (CTR): مرتفع (~15-20%).
⚠️ القيود المعروفة
حد الحروف
على الرغم من أن الحد النظري مرتفع، إلا أن واتساب يقتطع الحالات الطويلة جداً.
- منطقة الأمان: حافظ على نصك أقل من 700 حرف.
- الاقتطاع: إذا كتبت نصاً طويلاً جداً، سيرى المستخدمون زر "قراءة المزيد"، مما قد يقلل من جاذبية القصة.
معاينة الرابط "الشبح"
أحياناً، حتى مع تفعيل المعاينة، لا تظهر.
- السبب: الموقع الهدف بطيء (>5 ثوانٍ) أو يفتقر إلى وسوم
og:image. - التراجع: ستراجع الواجهة تلقائياً إلى رابط نصي عادي إذا فشل إنشاء المعاينة.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
محتوى الطلب
يرسل كـ JSONstring | WhatsApp Instance ID مثال: | ||
string | API Access Token مثال: | ||
string | المحتوى النصي للحالة مثال: | ||
string | لون الخلفية بتنسيق #RRGGBB مثال: | ||
number | معرف الخط (0-5 غالباً) مثال: | ||
boolean | تمكين معاينة الرابط مثال: | ||
boolean | معاينة رابط عالية الجودة مثال: | ||
string | جهات اتصال اختيارية للإشارة إليها مثال: |
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"success": true,
"message": "Operation completed successfully"
}Command Palette
Search for a command to run...