موصل Zapier

اربط Zapier بـ Brevo من خلال Tajo لتجسير آلاف التطبيقات الخارجية مع سير عمل أتمتة التسويق الخاص بك، مما يتيح تدفقات بيانات بدون كود ومحفزات قائمة على الأحداث عبر مجموعتك التقنية بأكملها.

نظرة عامة

الخاصيةالقيمة
المنصةZapier
الفئةأتمتة (مخصص)
تعقيد الإعدادسهل
تكامل رسميلا
البيانات المُزامَنةأحداث، جهات اتصال، سير عمل، محفزات
طريقة المصادقةمفتاح API / OAuth 2.0

الميزات

  • تنسيق متعدد التطبيقات - ربط أكثر من 6,000 تطبيق بـ Brevo عبر سير عمل Zap
  • محفزات Webhook - استقبال أحداث في الوقت الفعلي من أي تطبيق مرتبط بـ Zapier
  • مزامنة جهات الاتصال - دفع وسحب جهات الاتصال بين المنصات المرتبطة بـ Zapier وBrevo
  • إعادة توجيه الأحداث - توجيه أحداث التطبيق عبر Tajo إلى أتمتة Brevo
  • Zaps متعددة الخطوات - بناء سير عمل معقدة بعوامل التصفية والمُنسِّقات والتأخيرات
  • تطبيق Zapier مخصص - استخدام Zapier Platform CLI لبناء تكاملات مُخصَّصة

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

  1. حساب Zapier (الطبقة المجانية أو أعلى)
  2. حساب Brevo مع وصول إلى API
  3. حساب Tajo مع صلاحيات الموصلات
  4. Node.js 18+ مثبّت (لتطوير التكامل القائم على CLI)

المصادقة

مصادقة مفتاح API

Terminal window
# Set your Zapier Platform credentials
export ZAPIER_DEPLOY_KEY=your_deploy_key
export TAJO_API_KEY=your_tajo_api_key
export BREVO_API_KEY=your_brevo_api_key

OAuth 2.0

يدعم Zapier OAuth 2.0 لربط الخدمات الخارجية داخل Zaps:

const authentication = {
type: 'oauth2',
oauth2Config: {
authorizeUrl: {
url: 'https://your-app.com/oauth/authorize',
params: {
client_id: '{{process.env.CLIENT_ID}}',
state: '{{bundle.inputData.state}}',
redirect_uri: '{{bundle.inputData.redirect_uri}}',
response_type: 'code'
}
},
getAccessToken: {
url: 'https://your-app.com/oauth/token',
method: 'POST',
body: {
code: '{{bundle.inputData.code}}',
client_id: '{{process.env.CLIENT_ID}}',
client_secret: '{{process.env.CLIENT_SECRET}}',
grant_type: 'authorization_code',
redirect_uri: '{{bundle.inputData.redirect_uri}}'
}
},
refreshAccessToken: {
url: 'https://your-app.com/oauth/token',
method: 'POST',
body: {
refresh_token: '{{bundle.authData.refresh_token}}',
client_id: '{{process.env.CLIENT_ID}}',
client_secret: '{{process.env.CLIENT_SECRET}}',
grant_type: 'refresh_token'
}
}
}
};

الإعداد

الإعداد الأساسي

connectors:
zapier:
enabled: true
webhook_url: "https://hooks.zapier.com/hooks/catch/YOUR_HOOK_ID"
sync:
contacts: true
events: true
workflows: true
triggers:
- contact_created
- order_placed
- form_submitted
mapping:
email: email
first_name: FIRSTNAME
last_name: LASTNAME

إعداد Webhook

اضبط Tajo لإرسال الأحداث إلى webhooks Zapier:

webhooks:
zapier:
url: "https://hooks.zapier.com/hooks/catch/YOUR_HOOK_ID"
events:
- contact.created
- contact.updated
- order.completed
- cart.abandoned
retry:
max_attempts: 3
backoff: exponential

نقاط نهاية واجهة البرمجة

نقطة النهايةالطريقةالوصف
https://hooks.zapier.com/hooks/catch/{id}POSTنقطة التقاط webhook
https://nla.zapier.com/api/v1/dynamic/exposed/GETسرد الإجراءات المعروضة
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/POSTتنفيذ إجراء
https://zapier.com/api/platform/cli/appsGETسرد التطبيقات المسجلة
https://zapier.com/api/platform/cli/pushPOSTنشر التكامل

أمثلة على الكود

تهيئة الموصل

import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({
apiKey: process.env.TAJO_API_KEY,
brevoApiKey: process.env.BREVO_API_KEY
});
// Connect Zapier via webhook
await tajo.connectors.connect('zapier', {
webhookUrl: process.env.ZAPIER_WEBHOOK_URL,
events: ['contact.created', 'order.completed']
});

بناء تكامل Zapier مخصص باستخدام Platform CLI

const { version: platformVersion } = require('zapier-platform-core');
const App = {
version: require('./package.json').version,
platformVersion,
authentication,
triggers: {
new_contact: {
key: 'new_contact',
noun: 'Contact',
display: {
label: 'New Contact in Tajo',
description: 'Triggers when a new contact is synced.'
},
operation: {
perform: async (z, bundle) => {
const response = await z.request({
url: 'https://api.tajo.io/v1/contacts',
params: { since: bundle.meta.lastPoll }
});
return response.data;
}
}
}
},
creates: {
sync_contact: {
key: 'sync_contact',
noun: 'Contact',
display: {
label: 'Sync Contact to Brevo',
description: 'Syncs a contact to Brevo via Tajo.'
},
operation: {
inputFields: [
{ key: 'email', required: true, type: 'string' },
{ key: 'firstName', type: 'string' },
{ key: 'lastName', type: 'string' }
],
perform: async (z, bundle) => {
const response = await z.request({
method: 'POST',
url: 'https://api.tajo.io/v1/contacts/sync',
body: bundle.inputData
});
return response.data;
}
}
}
}
};
module.exports = App;

التعامل مع webhooks Zapier الواردة

app.post('/webhooks/zapier', async (req, res) => {
const { event, data } = req.body;
await tajo.connectors.handleWebhook('zapier', {
topic: event,
payload: data
});
res.status(200).json({ status: 'received' });
});

حدود المعدل

الخطةالطلباتالمهام/شهرفترة الاستطلاع
مجاني100/يوم10015 دقيقة
Starter1,000/يوم75015 دقيقة
Professional5,000/يوم2,000دقيقتان
Team10,000/يوم50,000دقيقة واحدة

حدود مهام Zapier

تُعتبر كل خطوة Zap مهمة. تستهلك Zaps متعددة الخطوات عدة مهام لكل تنفيذ. راقب استخدام المهام في لوحة Zapier لتجنب التجاوزات.

استكشاف الأخطاء وإصلاحها

المشكلةالسببالحل
Webhook لا يعملZap متوقفتحقق من حالة Zap في لوحة Zapier
البيانات لا تُعيَّنعدم تطابق أسماء الحقولتحقق من مطابقة مفاتيح الحقول بين التطبيقات
جهات اتصال مكررةلم يُضبَط إزالة التكرارفعّل إزالة التكرار القائمة على البريد الإلكتروني في Tajo
أخطاء Zapتم بلوغ حد معدل APIأضف خطوات تأخير أو رقّي خطة Zapier
انتهاء المصادقةالرمز لم يُحدَّثأعد مصادقة الاتصال في Zapier

وضع التصحيح

connectors:
zapier:
debug: true
log_level: verbose
log_webhooks: true

أفضل الممارسات

  1. استخدم webhooks بدلاً من الاستطلاع - توفر webhooks تدفق بيانات آني مقابل تأخيرات الاستطلاع
  2. أضف معالجة الأخطاء - استخدم Zapier Paths للتعامل مع سيناريوهات النجاح/الفشل
  3. إزالة تكرار البيانات - فعّل مفاتيح إزالة التكرار لمنع السجلات المكررة
  4. راقب استخدام المهام - إعداد تنبيهات قبل الوصول إلى حدود المهام
  5. استخدم عوامل التصفية بحكمة - صفِّ مبكرًا في Zaps لتقليل استهلاك المهام غير الضروري
  6. رقِّم تكاملات CLI - استخدم التحكم في الإصدار الدلالي لتطبيقات Platform CLI

الأمان

  • HTTPS فقط - يجب أن تستخدم جميع عناوين webhook URL بروتوكول HTTPS
  • تدوير مفاتيح API - دوّر المفاتيح دوريًا عبر لوحة Zapier
  • OAuth 2.0 - استخدم OAuth لمصادقة الخدمات الخارجية
  • التحقق من Webhook - تحقق من توقيعات webhook الواردة
  • صلاحيات مقيدة - امنح أدنى الوصول المطلوب لكل Zap

موارد ذات صلة

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
مساعد AI

مرحباً! اسألني أي شيء عن الوثائق.