n8n
تبدأ عُقد MailInApp لـ n8n تدفقات العمل عندما يحدث شيء في MailInApp، وتتيح لتدفقات العمل إضافة جهات اتصال ونقل الصفقات وإدخال جهات اتصال في رحلات وإرسال بريد معاملاتي. وهي منشورة على npm باسم n8n-nodes-mailinapp.
التثبيت
تحققت n8n من عُقد MailInApp. على n8n Cloud، يفتح مالك المثيل أو مسؤوله لوحة العُقد على مساحة العمل، ويبحث عن MailInApp، ويختارها من More from the community ثم يختار Install. بعدها يستطيع كل من في المثيل استخدامها.
على n8n المستضاف ذاتيًا، اذهب إلى Settings → Community Nodes → Install وأدخل n8n-nodes-mailinapp. راجع دليل العُقد المجتمعية من 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 وExperiment Decided وExperiment Results Ready وResponse 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 صفقة: نقلها إلى مرحلة أخرى، بما فيها الفوز والخسارة، أو تغيير عنوانها أو قيمتها أو عملتها. Get Many للصفقات، الأحدث حركةً أولًا، مع تصفية حسب بريد جهة الاتصال أو الحالة أو خط الأنابيب: ابحث عن صفقة جهة اتصال ثم حدّثها. |
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.
