تخطَّ إلى المستندات
خادم MCP

الإرسال إلى الجماهير

رسالة واحدة إلى كل من في جمهور أو أكثر، بنسخة منفصلة لكل شخص.

أدوات الإرسال إلى الجماهير

الأداةما تفعله
previewAudienceSendكم شخصًا سيصل إليه إرسال إلى هذه الجماهير، قبل إرسال أي شيء، مع عدد من سيُتخطون لأنهم ألغوا اشتراكهم وعدد من سيُتخطون لأن عناوينهم محظورة. والشخص الموجود في عدة جماهير يُحسب مرة واحدة.
sendToAudienceيرسل رسالة واحدة من أحد عناوينك إلى كل من في جماهير يصل عددها إلى 10، ولكل شخص نسخته. يقبل html أو text مع حقول دمج مثل {{firstName|there}}، أو قالبًا، ووقت إرسال اختياريًا. يجيب فورًا ويستمر الإرسال في الخلفية.
listBroadcastsعمليات الإرسال إلى الجماهير من هذا الصندوق، الأحدث أولًا، مع مدى تقدم كل منها، صفحة في كل مرة. سمِّ جمهورًا لترى فقط عمليات الإرسال التي شملته.
getBroadcastإرسال واحد ومدى تقدمه: لكم شخص كان، وكم نسخة تنتظر أو أُرسلت أو فشلت أو أُلغيت، وكم شخصًا تُخطي.
cancelBroadcastيوقف إرسالًا. كل نسخة لم تخرج بعد تُلغى ولا يُضاف أحد آخر. أما النسخ المرسلة فلا يمكن استرجاعها.

كل نسخة رسالة عادية موجهة إلى شخص واحد، فلا يرى أحد لمن ذهبت أيضًا، ولكل منها تتبعها وخطافات الويب الخاصة بها. ولا تُحفظ النسخ في المرسل: الإرسال هو السجل، وgetBroadcast هي طريقة متابعته.

حقول الدمج هي {{firstName}} و{{lastName}} و{{name}} و{{email}} و{{unsubscribeUrl}}، ولكل منها قيمة بديلة اختيارية بعد شرطة. تحمل كل نسخة ترويسة إلغاء اشتراك بنقرة واحدة، والمتن الذي لا يضع {{unsubscribeUrl}} بنفسه يحصل على سطر قصير لإلغاء الاشتراك في آخره. ومن يلغي اشتراكه يُعلَّم كملغٍ للاشتراك في كل جمهور ذهب إليه ذلك الإرسال، وتتخطاه عمليات الإرسال اللاحقة إلى تلك الجماهير، كما تتخطى العناوين الموجودة في قائمة الحظر.

يُقارن الإرسال كله بالخطة قبل أن يخرج أي شيء، فالإرسال الذي لا تغطيه الخطة يُرفض بدلًا من أن يتوقف في منتصفه. ولا شيء يجعل تكرار sendToAudience آمنًا، فبعد ضياع رد اقرأ listBroadcasts قبل المحاولة مجددًا.

تحتاج sendToAudience إلى emails:send وaudiences:read، وتحتاج previewAudienceSend إلى audiences:read، وتحتاج listBroadcasts وgetBroadcast إلى emails:read، وتحتاج cancelBroadcast إلى emails:send. ويسأل المساعد في التطبيق دائمًا قبل sendToAudience، ويسأل قبل cancelBroadcast ما لم تطلبه أنت. ومن يقتصر وصوله على بعض العناوين لا يرسل إلا إلى جهات الاتصال التي أضافها.