Zapier

اربط MailInApp بآلاف التطبيقات على Zapier: أرسل العملاء المحتملين الجدد إلى جدول بيانات، وانشر الاجتماعات المحجوزة في Slack، وافتح سجلًا في نظام CRM عند الفوز بصفقة، أو أضف جهة اتصال إلى MailInApp عندما يحدث شيء في مكان آخر.

تطبيق MailInApp على Zapier

يخضع تطبيق MailInApp الرسمي على Zapier حاليًا لمراجعة Zapier، ولم يُدرج بعد في دليل تطبيقاته. بعد إدراجه، ستربطه بمفتاح API وتختار المشغّلات والإجراءات من القوائم، دون نسخ أي عنوان URL:

المشغّلات: واحد لكل حدث في الحساب، ومنها New Lead وLead Turned Hot وMeeting Booked وDeal Stage Changed وForm Submitted وPurchase Completed وJourney Completed.
الإجراءات: Create or Update Contact وTrigger Journey وCreate Deal وUpdate or Move Deal وSend Transactional Email.
البحث: Find Contact، ويُقرن بالإنشاء ليصبح «Find or Create Contact».

ستُربط هذه الصفحة بصفحة التطبيق فور إدراجه. وإلى ذلك الحين، كل ما يلي يعمل اليوم عبر تطبيق Zapier المدمج Webhooks by Zapier.

إرسال أحداث MailInApp إلى Zap

في Zapier، أنشئ Zap مشغّله Webhooks by Zapier وحدثه Catch Hook. انسخ عنوان URL الذي يعطيك إياه Zapier.
في MailInApp، انتقل إلى المطوّرون ← خطافات الويب. الصق العنوان في عنوان URL لنقطة النهاية، وحدد الأحداث التي يجب أن يتلقاها هذا الـ Zap، ثم انقر إضافة خطاف ويب. احتفظ بسر التوقيع إن كنت تنوي التحقق من التوقيعات لاحقًا.
انقر إرسال تجربة على الـ Webhook الجديد، ثم Test trigger في Zapier. سترى الحدث النموذجي مع type وكل حقل داخل data، مثل بريد جهة الاتصال أو مرحلة الصفقة.
أضف خطوات الإجراء، وطابق الحقول التي تحتاجها، ثم شغّل الـ Zap.

لكل حدث الشكل نفسه: id وtype ووقت createdAt وكائن data. تسرد صفحة Webhooks كل حدث وحقوله. إذا كان Catch Hook واحد يتلقى أنواعًا متعددة من الأحداث، فأضف خطوة Filter by Zapier على type، أو أنشئ Webhook لكل Zap.

هل تريد تفاعلات رسالة واحدة فقط، مثل كل إجابة على استبيان معيّن؟ الصق عنوان Catch Hook في Webhook المشروع الخاص بتلك الرسالة، في صفحة الردود الخاصة بها.

العمل على MailInApp من Zap

استخدم إجراء Webhooks by Zapier ← Custom Request لاستدعاء واجهة MailInApp API مع مفتاح API في الترويسة Authorization: Bearer mia_live_…. على سبيل المثال:

إضافة جهة اتصال أو تحديثها عند ملء نموذج في مكان آخر: POST /api/v1/contacts.
فتح صفقة عندما يحجز عميل محتمل مكالمة في أداة أخرى: POST /api/v1/deals. اضبط الترويسة Idempotency-Key، مثل معرّف السجل في الأداة الأخرى، حتى لا تُنشئ إعادة محاولة الـ Zap صفقة ثانية.
إدخال جهة اتصال في رحلة مشغّلها استدعاء API: POST /api/v1/journeys/{id}/trigger.
إرسال إيصال أو إشعار: POST /api/v1/send مع "type": "transactional". لا ترسل بريدًا تسويقيًا من Zap: لا يستطيع الـ Zap إثبات أن المستلم وافق عليه.

عند فشل التسليم

يُعدّ الـ Zap المتوقف مؤقتًا أو المحذوف، أو أي عطل في Zapier، تسليمًا فاشلًا. يعيد MailInApp المحاولة تلقائيًا على مدى عدة ساعات. ويُحفظ الحدث نفسه دائمًا في MailInApp أولًا، فلا يضيع شيء من جهة MailInApp.