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

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

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

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

معاملات النص

string
مطلوب
معرّف مستلم الرسالة.
  • بالنسبة لـ Facebook وInstagram وX/Twitter هذا هو معرّف المستخدم الخاص بالمنصة (PSID أو IGSID أو معرّف المستخدم).
  • بالنسبة لـ WhatsApp هذا هو رقم هاتف المستلم بصيغة E.164 مكوَّنًا من أرقام فقط (على سبيل المثال 14155551234، وليس +1 (415) 555-1234).
string
مطلوب
الرسالة المراد إرسالها إلى المستلم.
  • قد تكون رسالة Facebook وInstagram وWhatsApp سلسلة فارغة أو غير مضمّنة عند تقديم mediaUrls.
  • يتطلب X رسالة من حرف واحد على الأقل حتى لو تم تقديم mediaUrls.
array
مصفوفة من عناوين URL للوسائط لإرفاق صور أو فيديو أو صوت (بما في ذلك الرسائل الصوتية) أو مستندات.
  • يجب أن تنتهي عناوين URL لعناصر الوسائط بامتداد الملف دون إضافة معاملات إضافية.
  • يدعم Facebook وInstagram عدة عناوين URL للوسائط.
  • يقبل X عنوان URL واحدًا فقط للوسائط.
  • الرسائل الصوتية مدعومة على Facebook وInstagram كملف aac أو wav.
  • يقبل WhatsApp عدة عناوين URL للوسائط. يجلب Ayrshare كل عنوان URL ويستخدم Content-Type في استجابته لتحديد فئة وسائط WhatsApp. تقبل Meta:
    • صورة: .jpg, .jpeg, .png
    • فيديو: .mp4, .3gp
    • صوت: .aac, .amr, .mp3, .m4a, .ogg
    • مستند: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx