الانتقال إلى المحتوى الرئيسي
POST
أرسل رسالة مباشرة جديدة إلى مستلم.
الأسعار والحدود: يمكن لكل ملف مستخدم أن يحتوي على ما يصل إلى 1,000 محادثة نشطة لكل دورة فوترة عبر جميع شبكات التواصل الاجتماعي. تعتمد الأسعار على خطتك: تدفع خطط Premium إضافة ثابتة بقيمة 49 دولارًا شهريًا، بينما تُحاسب خطط Launch وBusiness بمعدل 0.09 دولار لكل محادثة نشطة. تُحتسب المحادثة نشطة عند إرسال رسالة إلى مستلم خلال دورة الفوترة؛ الرسائل الواردة وحدها لا تُحتسب. عدد الرسائل داخل محادثة نشطة غير محدود.
  • يمكنك إرسال رمز تعبيري كجزء من نص message.
  • يجب أن تنتهي mediaUrls لـ Facebook وInstagram بامتداد معروف. تضمين معاملات استعلام سيؤدي إلى فشل عنوان URL للوسائط.

معاملات الترويسة

معاملات المسار

platform
string
مطلوب
المنصة لإرسال الرسالة: facebook أو instagram أو twitter

معاملات النص

recipientId
string
مطلوب
معرّف مستلم الرسالة.
message
string
مطلوب
الرسالة المراد إرسالها إلى المستلم.
  • قد تكون رسالة Facebook وInstagram سلسلة فارغة أو غير مضمّنة إذا تم تقديم mediaUrls.
  • يتطلب X رسالة من حرف واحد على الأقل حتى لو تم تقديم mediaUrls.
mediaUrls
array
مصفوفة من عناوين URL للوسائط لإرفاق صور أو فيديو أو رسالة صوتية.
  • يجب أن تنتهي عناوين URL لعناصر الوسائط بامتداد الملف دون إضافة معاملات إضافية.
  • يدعم Facebook وInstagram عدة عناوين URL للوسائط.
  • يقبل X عنوان URL واحدًا فقط للوسائط.
  • الرسائل الصوتية مدعومة على Facebook وInstagram كملف aac أو wav.