Zapier конектор

Свържи Zapier с Brevo през Tajo, за да създадеш мост между хиляди приложения на трети страни и твоите маркетингови автоматизации, позволявайки no-code data потоци и event-driven тригери в целия ти tech stack.

Преглед

СвойствоСтойност
ПлатформаZapier
КатегорияАвтоматизация (персонализирана)
Сложност на настройкаЛесна
Официална интеграцияНе
Синхронизирани данниСъбития, контакти, работни потоци, тригери
Метод на автентикацияAPI Key / OAuth 2.0

Функции

  • Мулти-апликационна оркестрация – Свържи 6 000+ приложения с Brevo чрез Zap работни потоци
  • Уебхук тригери – Получавай събития в реално време от всяко Zapier-свързано приложение
  • Синхронизация на контакти – Push и pull на контакти между Zapier-свързани платформи и Brevo
  • Препращане на събития – Рутирай събития от приложения през Tajo към Brevo автоматизации
  • Multi-step Zaps – Създавай сложни работни потоци с филтри, форматери и забавяния
  • Персонализирано Zapier приложение – Използвай Zapier Platform CLI, за да създаваш персонализирани интеграции

Предварителни условия

Преди да започнеш, увери се, че имаш:

  1. Акаунт в Zapier (Free tier или по-горе)
  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 за свързване на услуги на трети страни в Zap-ове:

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

Конфигурация на уебхуци

Конфигурирай Tajo да изпраща събития към 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

API крайни точки

Крайна точкаМетодОписание
https://hooks.zapier.com/hooks/catch/{id}POSTУебхук catch hook
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/pushPOSTDeploy на интеграция

Примери с код

Инициализация на конектора

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;

Обработка на входящи 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' });
});

Ограничения на заявките

ПланЗаявкиЗадачи/месецИнтервал на polling
Free100/ден10015 мин
Starter1 000/ден75015 мин
Professional5 000/ден2 0002 мин
Team10 000/ден50 0001 мин

Zapier task лимити

Всяка стъпка в Zap се брои като задача. Multi-step Zap-овете консумират множество задачи за изпълнение. Мониторирай използването на задачи в Zapier dashboard, за да избегнеш overages.

Отстраняване на проблеми

ПроблемПричинаРешение
Уебхукът не се задействаZap-ът е изключенПровери статуса на Zap в Zapier dashboard
Данните не се мапватНесъответствие на имена на полетаПровери дали ключовете на полетата съвпадат между приложенията
Дублирани контактиНе е конфигуриран dedupАктивирай дедупликация на базата на имейл в Tajo
Грешки в ZapДостигнат API rate limitДобави стъпки за забавяне или обнови Zapier план
Изтекла автентикацияToken не е refresh-натПовторно автентикирай връзката в Zapier

Режим за дебъг

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

Добри практики

  1. Използвай уебхуци пред polling – Уебхуците осигуряват data поток в реално време срещу закъсненията при polling
  2. Добавяй обработка на грешки – Използвай Zapier Paths за обработка на сценарии за успех/неуспех
  3. Дедуплицирай данните – Активирай dedup ключове, за да предотвратиш дублирани записи
  4. Мониторирай използването на задачи – Настрой alert-и преди достигане на task лимитите
  5. Използвай филтрите разумно – Филтрирай рано в Zap-овете, за да намалиш ненужното task потребление
  6. Versionирай CLI интеграциите си – Използвай семантично версиониране за Platform CLI приложения

Сигурност

  • Само HTTPS – Всички webhook URL-ове трябва да използват HTTPS
  • Ротация на API ключове – Периодично ротирай ключовете чрез Zapier dashboard
  • OAuth 2.0 – Използвай OAuth за автентикация на услуги на трети страни
  • Верификация на уебхуци – Валидирай подписите на входящите уебхуци
  • Scoped разрешения – Предоставяй минимално необходим достъп на Zap

Свързани ресурси

Subscribe to updates

developer-docs

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

auto-detect
AI асистент

Здравейте! Попитайте ме за документацията.