رسائل معاملات تفاعلية عبر Send API

الإيصالات ورسائل التأكيد هي أكثر رسائل يفتحها العملاء. صمّمها مرة في الاستوديو وأرسلها من خادمك عبر Send API، فيسأل كل إيصال عن تجربة الطلب ويقترح المنتج التالي.

الموضوع

Your order receipt

الإيصالات ورسائل التأكيد هي أكثر رسائل يفتحها العملاء. أرسلها من خادمك عبر Send API بالقوالب التفاعلية نفسها التي في حملاتك، فيسأل كل إيصال عن تجربة الطلب ويقترح المنتج التالي.

يصل الإيصال إلى كل عميل تقريبًا، بعد الشراء مباشرة. وهذا يجعله أفضل مكان لتقييم سريع أو عبوة إعادة تعبئة أو رمز للمرة القادمة، ما دام إرساله سهلًا كإرسال إيصال عادي.

صمّمه مرة وأرسله من خادمك

ابنِ الإيصال كرسالة عادية في الاستوديو، مع وسوم دمج مثل {{order_number}} والقوالب التي تريدها:

  • تقييم: «كيف كان طلبك؟» بالنجوم أو الوجوه التعبيرية. ومع طرح سؤال متابعة عندما يكون التقييم على الأكثر يفتح التقييم المنخفض سؤالًا قصيرًا عمّا حدث.
  • منتج: منتج مرتبط أو عبوة إعادة تعبئة، يُشترى من الإيصال بـ اشترِ الآن.
  • قسيمة: رمز للطلب القادم يُنسخ بلمسة.
  • زر: حالة الطلب أو الفاتورة أو الدعم.

ثم يستدعي خادمك POST /api/v1/send مع projectId للرسالة وكائن mergeData فيه قيم ذلك الطلب، حتى 100 حقل. راجع القالب في مرجع API.

يستطيع كل عميل التقييم والشراء والنقر من الإيصال، أيًّا كان التطبيق الذي يقرؤه به.

مرتبط بجهات اتصالك

إن كان العميل من جهات اتصالك، يُربط الإيصال به: مرّر listId، أو دع MailInApp يجد العنوان في قوائمك. فيُسجَّل تقييمه في نشاطه ونقاط تفاعله، ويمكنه ملء حقل في جهة الاتصال وبدء رحلة، ويتم حجز الاجتماع بنقرة واحدة. راجع مرجع API.

مصمم للإنتاج

  • type: "transactional"، الافتراضي، يصل إلى العملاء الذين ألغوا الاشتراك في الرسائل التسويقية، لأنهم يحتاجون إيصالهم. ويتخطى العناوين المرتدة. راجع المعاملاتي مقابل التسويقي.
  • Idempotency-Key: يعيد الاستدعاء المكرر بالمفتاح نفسه النتيجة الأولى، فيتلقى كل عميل إيصالًا واحدًا. راجع منع التكرار.
  • الحدود: لكل مفتاح API حد في الدقيقة، وتشمل خطتك عددًا شهريًا من استدعاءات Send API. وتظهر الاستدعاءات الأخيرة في صفحة المطوّرون.
  • دون برمجة: يرسل إجراء Send Transactional Email في Zapier وعقدة n8n بالطريقة نفسها.
  • رمز لمرة واحدة: أرسل html أو text بدل projectId، فتخرج الرسالة كما هي تمامًا.

ما يعود إليك

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

البدء

ابنِ الإيصال في الاستوديو مع تقييم، وأنشئ مفتاح API من المطوّرون، واستدعِ POST /api/v1/send مع projectId وmergeData. يرشدك البدء السريع في أول استدعاء.

تسلسل نموذجي للبناء والإرسال

  1. 1

    صمّم الإيصال في الاستوديو

    ابنِه كرسالة عادية بتقييم أو منتج أو قسيمة، ووسوم دمج مثل {{order_number}}.

  2. 2

    أنشئ مفتاح API

    أنشئ مفتاح API باسم من صفحة المطوّرون. يرسله كل استدعاء كرمز Bearer.

  3. 3

    استدعِ Send API

    يرسل خادمك طلب POST إلى /api/v1/send مع projectId للرسالة وكائن mergeData فيه قيم ذلك الطلب.

  4. 4

    اقرأ ما يعود

    تظهر التقييمات والنقرات والمشتريات في الرؤى الخاصة بالرسالة، ويرسل الويب هوك كلًا منها فور وصوله.

الأسئلة الشائعة

هل تحمل الرسالة المرسلة عبر API القوالب التفاعلية نفسها التي في الحملة؟

نعم. يُنشئ وضع القالب رسالة الاستوديو التي تحددها بكل قوالبها، تمامًا كالإرسال من لوحة التحكم.

كيف تصل بيانات الطلب إلى الرسالة؟

عبر mergeData: كائن مسطّح يصل إلى 100 حقل يملأ وسوم الدمج {{field}} في الرسالة لهذا الاستدعاء فقط. مرّر listId أيضًا، وإن كان العميل جهة اتصال لديك تُربط الرسالة به، فيُسجَّل تقييمه في نشاطه.

ما الفرق بين transactional وmarketing؟

يحدد الحقل type قائمة الحظر التي تُفحص. transactional، الافتراضي، يصل إلى العملاء الذين ألغوا الاشتراك في الرسائل التسويقية، لأنهم يحتاجون إيصالهم. وmarketing يتصرف كحملة. وكلاهما يتخطى العناوين المرتدة.

ما حدود Send API؟

لكل مفتاح API حد في الدقيقة، وتشمل خطتك عددًا شهريًا من استدعاءات Send API (500 في الخطة المجانية)، ويُحتسب كل إرسال ضمن الرسائل الشهرية لخطتك. ومع ترويسة Idempotency-Key يعيد الاستدعاء المكرر النتيجة الأولى، فيتلقى كل عميل إيصالًا واحدًا.

هل يمكنني إرسال HTML خاص بي عبر نقطة النهاية نفسها؟

نعم. أرسل html أو text بدل projectId، فتخرج الرسالة كما هي. يناسب ذلك رمزًا لمرة واحدة؛ أما القوالب التفاعلية فلها وضع القالب.

ابنِ هذا في الاستوديو

ابدأ بالباقة المجانية — كل عنصر تفاعلي ومحرك البدائل الكامل مضمَّنان في كل فئة.