Zapier konnektor

Csatlakoztasd a Zapiert a Brevóhoz a Tajo segítségével, hogy áthidald a több ezer harmadik féltől származó alkalmazást a marketingautomatizálási munkafolyamatokkal, lehetővé téve a kód nélküli adatfolyamokat és eseményvezérelt kiváltókat a teljes technológiai kötegen át.

Áttekintés

TulajdonságÉrték
PlatformZapier
KategóriaAutomatizálás (Egyéni)
Telepítés bonyolultságaKönnyű
Hivatalos integrációNem
Szinkronizált adatokEsemények, Kapcsolatok, Munkafolyamatok, Kiváltók
Hitelesítési módszerAPI kulcs / OAuth 2.0

Funkciók

  • Több-alkalmazás orchestráció – 6 000+ alkalmazás csatlakoztatása a Brevóhoz Zap munkafolyamatokon keresztül
  • Webhook kiváltók – Valós idejű események fogadása bármely Zapierre csatlakoztatott alkalmazásból
  • Kapcsolat-szinkronizáció – Kapcsolatok küldése és fogadása Zapierre csatlakoztatott platformok és a Brevo között
  • Esemény-továbbítás – Alkalmazáseseményeketk irányítsa a Tajón keresztül a Brevo automatizálásokba
  • Több-lépéses Zap-ek – Összetett munkafolyamatok építése szűrőkkel, formázókkal és késleltetésekkel
  • Egyéni Zapier alkalmazás – Testreszabott integrációk építése a Zapier Platform CLI-vel

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

  1. Egy Zapier fiókkal (Ingyenes szint vagy magasabb)
  2. Egy Brevo fiókkal API-hozzáféréssel
  3. Egy Tajo fiókkal konnektor engedélyekkel
  4. Node.js 18+ telepítve (CLI alapú integrációfejlesztéshez)

Hitelesítés

API kulcs hitelesítés

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

A Zapier OAuth 2.0-t támogat harmadik féltől származó szolgáltatások csatlakoztatásához Zap-eken belül:

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'
}
}
}
};

Konfiguráció

Alapbeállítás

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 konfiguráció

Konfiguráld a Tajót, hogy eseményeket küldjön a Zapier webhookokhoz:

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 végpontok

VégpontMódszerLeírás
https://hooks.zapier.com/hooks/catch/{id}POSTWebhook catch hook
https://nla.zapier.com/api/v1/dynamic/exposed/GETKözzétett műveletek listázása
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/POSTMűvelet végrehajtása
https://zapier.com/api/platform/cli/appsGETRegisztrált alkalmazások listázása
https://zapier.com/api/platform/cli/pushPOSTIntegráció telepítése

Kódpéldák

A konnektor inicializálása

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']
});

Egyéni Zapier integráció építése a Platform CLI-vel

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;

Bejövő Zapier webhookok kezelése

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' });
});

Ráta-korlátok

TervKérésekFeladatok/hóLekérdezési időköz
Ingyenes100/nap10015 perc
Starter1 000/nap75015 perc
Professional5 000/nap2 0002 perc
Team10 000/nap50 0001 perc

Zapier feladatkorlátok

Minden Zap-lépés egy feladatnak számít. A több-lépéses Zap-ek végrehajtásonként több feladatot fogyasztanak. Figyeld a feladathasználatodat a Zapier dashboardon a túllépések elkerüléséhez.

Hibaelhárítás

ProblémaOkMegoldás
Webhook nem indul elZap kikapcsolvaEllenőrizd a Zap státuszát a Zapier dashboardon
Adatok nem képeződnek leMezőnév eltérésEllenőrizd, hogy a mező kulcsok egyeznek-e az alkalmazások között
Duplikált kapcsolatokNincs dedup konfigurálvaEngedélyezd az e-mail alapú deduplikálást a Tajóban
Zap hibákAPI ráta-korlát elérveAdj hozzá késleltetési lépéseket vagy frissíts magasabb Zapier csomagra
Auth lejártToken nem frissültHitelesítsd újra a kapcsolatot a Zapierben

Hibakeresési mód

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

Legjobb gyakorlatok

  1. Használj webhookokat lekérdezés helyett – A webhookok valós idejű adatfolyamot biztosítanak a lekérdezési késleltetésekkel szemben
  2. Adj hozzá hibakezelést – Használj Zapier Paths-t a sikeres/sikertelen forgatókönyvek kezeléséhez
  3. Deduplikálj adatokat – Engedélyezz deduplikálási kulcsokat a duplikált rekordok megelőzéséhez
  4. Figyeld a feladathasználatot – Állíts be riasztásokat a feladatkorlátok elérése előtt
  5. Használj szűrőket körültekintően – Szűrj korán a Zap-ekben a felesleges feladatfogyasztás csökkentéséhez
  6. Verziókövetést alkalmazz a CLI integrációkhoz – Használj szemantikus verziószámozást a Platform CLI alkalmazásokhoz

Biztonság

  • Csak HTTPS – Minden webhook URL-nek HTTPS-t kell használnia
  • API kulcs rotáció – Forgasd rendszeresen a kulcsokat a Zapier dashboardon
  • OAuth 2.0 – Használd az OAuth-ot harmadik féltől származó szolgáltatások hitelesítéséhez
  • Webhook-ellenőrzés – Validáld a bejövő webhook aláírásokat
  • Hatókörhöz korlátozott jogosultságok – Adj minimálisan szükséges hozzáférést Zap-enként

Kapcsolódó források

Subscribe to updates

developer-docs

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

auto-detect
AI asszisztens

Szia! Kérdezz bármit a dokumentációról.