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 |
|---|---|
| Platform | Zapier |
| Kategória | Automatizálás (Egyéni) |
| Telepítés bonyolultsága | Könnyű |
| Hivatalos integráció | Nem |
| Szinkronizált adatok | Események, Kapcsolatok, Munkafolyamatok, Kiváltók |
| Hitelesítési módszer | API 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:
- Egy Zapier fiókkal (Ingyenes szint vagy magasabb)
- Egy Brevo fiókkal API-hozzáféréssel
- Egy Tajo fiókkal konnektor engedélyekkel
- Node.js 18+ telepítve (CLI alapú integrációfejlesztéshez)
Hitelesítés
API kulcs hitelesítés
# Set your Zapier Platform credentialsexport ZAPIER_DEPLOY_KEY=your_deploy_keyexport TAJO_API_KEY=your_tajo_api_keyexport BREVO_API_KEY=your_brevo_api_keyOAuth 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: LASTNAMEWebhook 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: exponentialAPI végpontok
| Végpont | Módszer | Leírás |
|---|---|---|
https://hooks.zapier.com/hooks/catch/{id} | POST | Webhook catch hook |
https://nla.zapier.com/api/v1/dynamic/exposed/ | GET | Közzétett műveletek listázása |
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/ | POST | Művelet végrehajtása |
https://zapier.com/api/platform/cli/apps | GET | Regisztrált alkalmazások listázása |
https://zapier.com/api/platform/cli/push | POST | Integrá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 webhookawait 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
| Terv | Kérések | Feladatok/hó | Lekérdezési időköz |
|---|---|---|---|
| Ingyenes | 100/nap | 100 | 15 perc |
| Starter | 1 000/nap | 750 | 15 perc |
| Professional | 5 000/nap | 2 000 | 2 perc |
| Team | 10 000/nap | 50 000 | 1 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éma | Ok | Megoldás |
|---|---|---|
| Webhook nem indul el | Zap kikapcsolva | Ellenőrizd a Zap státuszát a Zapier dashboardon |
| Adatok nem képeződnek le | Mezőnév eltérés | Ellenőrizd, hogy a mező kulcsok egyeznek-e az alkalmazások között |
| Duplikált kapcsolatok | Nincs dedup konfigurálva | Engedélyezd az e-mail alapú deduplikálást a Tajóban |
| Zap hibák | API ráta-korlát elérve | Adj hozzá késleltetési lépéseket vagy frissíts magasabb Zapier csomagra |
| Auth lejárt | Token nem frissült | Hitelesítsd újra a kapcsolatot a Zapierben |
Hibakeresési mód
connectors: zapier: debug: true log_level: verbose log_webhooks: trueLegjobb gyakorlatok
- Használj webhookokat lekérdezés helyett – A webhookok valós idejű adatfolyamot biztosítanak a lekérdezési késleltetésekkel szemben
- Adj hozzá hibakezelést – Használj Zapier Paths-t a sikeres/sikertelen forgatókönyvek kezeléséhez
- Deduplikálj adatokat – Engedélyezz deduplikálási kulcsokat a duplikált rekordok megelőzéséhez
- Figyeld a feladathasználatot – Állíts be riasztásokat a feladatkorlátok elérése előtt
- Használj szűrőket körültekintően – Szűrj korán a Zap-ekben a felesleges feladatfogyasztás csökkentéséhez
- 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