حالة صوتية
انشر حالة صوتية (قصة) على واتساب.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
استخدم صوتًا واضحًا؛ يمكن أن تكون ضوضاء الخلفية مشتتة للانتباه.
أضف لون خلفية يطابق علامتك التجارية.
اللمسة الشخصية: الحالة الصوتية
تسمح لك نقطة النهاية /v2/status/voice بنشر تسجيلات صوتية مباشرة في موجز الحالة الخاص بك. يرى المستخدمون مشغل صوت مع تشكيل موجي (Waveform)، مما يجعلها مختلفة عن ملفات الفيديو أو الموسيقى القياسية.
🎙️ لماذا الصوت؟
1. الحميمية على نطاق واسع
الملاحظات الصوتية هي أكثر أشكال التواصل الرقمي خصوصية. سماع صوت مؤسس الشركة وهو يوضح سبباً للتأخير أو يهنئ بـ "عام جديد سعيد" يخلق اتصالاً لا يمكن للنص محاكاته.
- الثقة: يثبت وجود إنسان خلف الأتمتة.
- الفروق الدقيقة: نبرة الصوت والحماس والتعاطف تُفقد في النص ولكنها تُحفظ في الصوت.
🎧 المتطلبات التقنية
واتساب صارم للغاية بشأن صيغ الصوت للحالة الصوتية.
قاعدة "Opus inside OGG"
للحصول على مظهر "الملاحظة الصوتية" الحقيقي (مع التشكيل الموجي)، لا يمكنك مجرد رفع ملف MP3.
- الحاوية: OGG.
- الترميز: Opus.
- القنوات: Mono (قناة واحدة). القنوات الستيريو تجعل التشكيل الموجي يبدو مسطحاً.
- معدل العينة: 16000 هرتز أو 48000 هرتز.
حل convert
إذا كنت لا تريد التعامل مع التحويل يدوياً، اضبط convert: true في استدعاء الواجهة. ستقوم الواجهة بتحويل ملفات MP3/WAV/AAC إلى OGG/Opus نيابة عنك، مع زيادة طفيفة في وقت الاستجابة.
🎨 التخصيص البصري
على عكس الفيديو، الحالة الصوتية هي في الأساس مشغل صوت فوق خلفية ملونة.
- ألوان الخلفية: يمكنك (ويجب عليك) تحديد
backgroundColorبدقة. - الهوية: استخدم كود اللون السداسي (Hex) الخاص بعلامتك التجارية للحفاظ على الاتساق البصري.
⚠️ القيود
حد الـ 30 ثانية (مرة أخرى)
تماماً مثل الفيديو، الحالات الصوتية محدودة بـ 30 ثانية.
- الاقتطاع: إذا رفعت بودكاست مدته 5 دقائق، سيتم تشغيل أول 30 ثانية فقط، وسيتم تجاهل الباقي بصمت.
- توصية: ابقَ موجزاً ومركزاً في رسالتك الصوتية.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
محتوى الطلب
يرسل كـ JSONstring | WhatsApp Instance ID مثال: | ||
string | API Access Token مثال: | ||
string | رابط ملف الصوت (يوصى بـ ogg/opus) مثال: | ||
string | اسم الملف مثال: | ||
string | نوع MIME مثال: | ||
boolean | تمكين التحويل التلقائي مثال: | ||
string | تعليق نصي للحالة الصوتية مثال: |
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"success": true,
"message": "Operation completed successfully"
}Command Palette
Search for a command to run...