n8n
تبدأ عُقد MailInApp لـ n8n تدفقات العمل عندما يحدث شيء في MailInApp، وتتيح لتدفقات العمل إضافة جهات اتصال ونقل الصفقات وإدخال جهات اتصال في رحلات وإرسال بريد معاملاتي. وهي منشورة على npm باسم n8n-nodes-mailinapp.
التثبيت
في n8n، انتقل إلى Settings ← Community Nodes ← Install وأدخل n8n-nodes-mailinapp. التفاصيل في دليل العُقد المجتمعية من n8n.
يمكنك تثبيتها الآن على n8n المستضاف ذاتيًا. أما n8n Cloud فلا يقدّم إلا العُقد المجتمعية التي تحققت منها n8n، وهذه الحزمة لم يُتحقق منها بعد. وهي مبنية وفق قواعد التحقق في n8n، لذا ستصبح متاحة على Cloud بمجرد موافقة n8n عليها.
ربط حسابك
- في MailInApp، انتقل إلى المطوّرون وأنشئ مفتاح API. يبدأ بـ
mia_live_ولا يُعرض إلا مرة واحدة. - في n8n، أنشئ بيانات اعتماد MailInApp API والصق المفتاح. اترك Base URL على
https://mailinapp.com.
يتصرف المفتاح باسم حسابك في MailInApp بالكامل، فتعامل معه ككلمة مرور. وإلغاؤه في MailInApp يوقف أيضًا كل المشغّلات التي أعدّها.
عقدة MailInApp Trigger
اختر حدثًا أو أكثر. عند تفعيل تدفق العمل، تشترك العقدة فيها لدى MailInApp. وعند إيقافه، يُزال الاشتراك. ترى هذه الاشتراكات في المطوّرون ← خطافات الويب موسومة بـ n8n.
الأحداث هي أحداث الحساب الاثنا عشر: Interaction Received وForm Submitted وContact Created وContact Updated وLead Turned Hot وNew Lead وMeeting Booked وMeeting Cancelled وDeal Created وDeal Stage Changed وPurchase Completed وJourney Completed.
يتلقى كل تشغيل الحدث كما أرسله MailInApp، مع id وtype وcreatedAt وdata. قيمة id واحدة في كل تسليمات الحدث نفسه، فيمكنك استخدامها لتجاهل المكرر. كل تسليم موقَّع. ترفض العقدة أي طلب بلا توقيع صالح أو بطابع زمني أقدم من 5 دقائق، فمعرفة عنوان الـ Webhook لا تكفي لتشغيل تدفق عملك.
عقدة MailInApp
| المورد | العمليات |
|---|---|
| Contact | Create or Update عنوانًا في قائمة جهات اتصال. يتحقق MailInApp من العنوان عند حفظه. Get جهة اتصال العنوان في كل قائمة أو في قائمة واحدة. |
| Contacts List | Get Many القوائم مع حقولها وعدد جهات الاتصال فيها. |
| Deal | Create صفقة لجهة اتصال عبر بريدها. اضبط Idempotency Key (رقم طلب مثلًا) حتى لا ينشئ تشغيل معاد صفقة ثانية. Update صفقة: نقلها إلى مرحلة أخرى، بما فيها الفوز والخسارة، أو تغيير عنوانها أو قيمتها أو عملتها. |
Send Transactional: موضوعك ومحتوى HTML أو نصي خاص بك، أو مشروع من الاستوديو مع بيانات الدمج. الإرسال الفاشل خطأ. ونتيجة suppressed (ارتد العنوان أو كان غير صالح) نتيجة عادية يمكنك التفرع بناءً عليها. | |
| Journey | Enroll Contact في رحلة مشغّلها استدعاء API، وGet Many الرحلات. |
| Pipeline | Get Many المسارات مع مراحلها. |
تعرض القوائم المنسدلة قوائمك وحقولها ورحلاتك ومساراتك ومراحلها. وتدعم العقدة خيار Continue On Fail في n8n.
لا يتوفر إرسال البريد التسويقي: لا يستطيع تدفق العمل إثبات موافقة المستلم. أرسل البريد التسويقي من MailInApp، أو أدخل جهة الاتصال في رحلة.
الاستخدام مع وكيل ذكاء اصطناعي
يمكن استخدام عقدة MailInApp أداةً لدى AI Agent في n8n. ولمجموعة أدوات أوسع، اربط الوكيل أيضًا بـ خادم MCP الخاص بـ MailInApp عبر عقدة MCP Client Tool: نقطة النهاية https://mailinapp.com/api/mcp، مع مفتاح API بصفته بيانات اعتماد Bearer.
تتضمن الحزمة تدفق عمل نموذجيًا جاهزًا (examples/ai-agent-mcp.workflow.json داخل الحزمة). يستطيع وكيله قراءة جهات الاتصال والنتائج وإجابات النماذج والشرائح والرحلات، وكتابة مسودّات لرحلات جديدة، لكنه لا يملك أي أداة ترسل بريدًا. وتُحفظ الرحلات التي يبنيها الوكيل متوقفة دائمًا، ليراجعها شخص ويشغّلها.
بدون العُقد
يمكن لأي تدفق عمل في n8n أيضًا استخدام MailInApp عبر المشغّل العام Webhook، الذي يغذّيه Webhook تضيفه في المطوّرون ← خطافات الويب، وعقدة HTTP Request التي تستدعي واجهة API.