تخطّي إلى المحتوى

ربط Zapier بمفتاح API شخصي

باستخدام تطبيق Marcomm AI لـ Zapier، ابدأ Zaps من البيانات الصحفية ومقالات المدونة والفعاليات الصحفية، وأنشئها وانشرها وأرسلها. يُستخدم التطبيق بدعوة فقط.

  1. 1
    في Marcomm، انتقل إلى الإعدادات → التكاملات → Zapier لترى الحالة والقيم التي تحتاجها.
    الإعدادات، التكاملات، Zapier، مع الحالة وخطوات الاتصال والنطاقات المطلوب تحديدها وحالة الوصول إلى API
    تعرض صفحة Zapier الحالة الحالية والخطوات والقيم المطلوب نسخها، وما إذا كان الوصول إلى API معتمدًا لمساحة العمل هذه.
  2. 2
    افتح الإعدادات → API. إذا لم يكن لمساحة العمل وصول إلى API بعد، يملأ المالك أو المسؤول التقدّم بطلب الوصول إلى API ويختار إرسال الطلب.
  3. 3
    بعد الموافقة، افتح إنشاء مفتاح، واختر مفتاح شخصي، وحدّد النطاقات التي تحتاجها، ثم اختر إنشاء المفتاح. انسخ المفتاح فورًا لأنه يظهر مرة واحدة فقط.
  4. 4
    افتح رابط الدعوة من Marcomm AI وأضف تطبيق Marcomm AI إلى حسابك في Zapier.
  5. 5
    أنشئ Zap واختر Marcomm AI مشغّلًا أو إجراءً، ثم الصق المفتاح في API Key (مفتاح API) عندما يطلب Zapier الاتصال.

جرّب خطوات النشر والإرسال أولًا بمسودة، لأنه لا يمكن التراجع عنها.

التطبيق ليس في دليل Zapier العام بعد، لذا تحتاج إلى رابط دعوة من Marcomm AI. يحتوي على سبعة مشغّلات: New Press Release و Press Release Approval Requested و Press Release Published و New Blog Post و Blog Post Published و New Press Event و RSVP Invite Updated. تنشئ إجراءاته البيانات الصحفية وتحدّثها وتطلب الموافقة عليها وتنشرها وترسلها، وتنشئ مقالات المدونة وتنشرها، وتنشئ الفعاليات الصحفية، وتنشئ دعوات RSVP وتضيف المستلمين وترسلها. ويجد بحثان بيانًا صحفيًا أو مقالة مدونة.

تحدّد النطاقات ما يستطيع المفتاح فعله. المحتوى (content) يقرأ البيانات الصحفية ومقالات المدونة والفعاليات الصحفية، وكتابة المحتوى (content:write) ينشئ المسودات ويعدّلها، والنشر والإرسال (distribution) ينشر ويرسل بالبريد الإلكتروني، والموافقات (approvals) يغطي خطوات الموافقة. تعمل النطاقات الثلاثة الأخيرة مع مفتاح شخصي فقط، لأن الإجراء يُسجَّل باسم من أنشأ المفتاح. أما مفتاح مساحة العمل فيقرأ فقط، وكل مفتاح يعمل بدور منشئه وصلاحياته.

لا يمكن التراجع عن النشر والإرسال. لا تنفّذهما API إلا إذا احتوى الطلب على confirm: true أو ترويسة Idempotency-Key، ولا تنشر شيئًا وتردّ بالرمز 409 ما دامت الموافقة مطلوبة أو كان المحتوى مجدولًا أو تحت حظر النشر. إعادة المحاولة بالمفتاح Idempotency-Key نفسه والطلب نفسه تعيد النتيجة الأولى لمدة 24 ساعة بدل التنفيذ مرة أخرى. ترسل كل خطوة كتابة مفتاح idempotency مبنيًا من الـ Zap ومدخلاته. إذا احتاج Zap إلى تكرار الخطوة نفسها تمامًا عمدًا خلال 24 ساعة، فأدخل في Repeat Key قيمة تتغيّر في كل تشغيل.

تتوفر API في خطة Team وما فوقها. يراجع فريق Marcomm AI كل طلب، ولا تعمل المفاتيح إلا بعد الموافقة. لا يستخدم المفتاح إلا النطاقات المعتمدة لمساحة العمل، ويمكن لكل شخص امتلاك 10 مفاتيح كحد أقصى. افتراضيًا يمكن لمساحة العمل إرسال 60 طلبًا في الدقيقة و10,000 طلب في اليوم، وبعد ذلك تردّ API بالرمز 429 مع ترويسة Retry-After. لرفع الحدود، استخدم تحتاج إلى حدود أعلى؟ في الإعدادات → API. لفصل Zapier، اختر إلغاء بجانب المفتاح، فتفقد الأنظمة التي تستخدمه الوصول فورًا.

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

استدعِ GET https://marcomm.works/api/v1/me مع الترويسة Authorization: Bearer متبوعة بمفتاحك. يعمل ذلك مع أي مفتاح معتمد أيًا كانت نطاقاته، ويعيد مساحة العمل واسم المفتاح ونطاقاته.

لا يسجّل المفتاح الخدمة التي تستخدمه، لذلك لا يضع Marcomm علامة متصل على بطاقة Zapier. تعرض الإعدادات → API آخر مرة استُخدم فيها كل مفتاح.

لا. يستطيع تطبيق Zapier طلب الموافقة، ويقرّر الموافِق في Marcomm. عبر API، يستطيع مفتاح شخصي يملك نطاق الموافقات الموافقة أو الرفض.

التكاملات