Zapier konektor
Prepoj Zapier s Brevo cez Tajo na prepojenie tisícov aplikácií tretích strán s tvojimi marketingovými automatizačnými workflowmi, umožňujúc no-code dátové toky a triggery riadené udalosťami naprieč celým technologickým stackom.
Prehľad
| Vlastnosť | Hodnota |
|---|---|
| Platforma | Zapier |
| Kategória | Automatizácia (Vlastná) |
| Zložitosť nastavenia | Ľahké |
| Oficiálna integrácia | Nie |
| Synchronizované dáta | Udalosti, Kontakty, Workflowy, Triggery |
| Metóda autentifikácie | API Key / OAuth 2.0 |
Funkcie
- Orchestrácia viacerých aplikácií - Prepoj 6 000+ aplikácií s Brevo cez Zap workflowy
- Webhookové triggery - Prijímaj udalosti v reálnom čase z akejkoľvek aplikácie pripojenej cez Zapier
- Synchronizácia kontaktov - Prenášaj a sťahuj kontakty medzi platformami pripojenými cez Zapier a Brevo
- Preposielanie udalostí - Smeruj udalosti aplikácií cez Tajo do automatizácií Brevo
- Viacstupňové Zaps - Buduj komplexné workflowy s filtrami, formátovačmi a oneskoreniami
- Vlastná Zapier aplikácia - Použi Zapier Platform CLI na budovanie prispôsobených integrácií
Predpoklady
Predtým, než začneš, uisti sa, že máš:
- Zapier účet (Free tier alebo vyšší)
- Brevo účet s API prístupom
- Tajo účet s oprávneniami pre konektory
- Node.js 18+ nainštalovaný (pre integrácie vyvíjané pomocou CLI)
Autentifikácia
Autentifikácia API kľúčom
# 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
Zapier podporuje OAuth 2.0 pre pripájanie služieb tretích strán v rámci 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' } } }};Konfigurácia
Základné nastavenie
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: LASTNAMEKonfigurácia webhooku
Nakonfiguruj Tajo na odosielanie udalostí do Zapier webhookov:
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 endpointy
| Endpoint | Metóda | Popis |
|---|---|---|
https://hooks.zapier.com/hooks/catch/{id} | POST | Webhookový catch hook |
https://nla.zapier.com/api/v1/dynamic/exposed/ | GET | Zoznam vystavených akcií |
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/ | POST | Spustenie akcie |
https://zapier.com/api/platform/cli/apps | GET | Zoznam registrovaných aplikácií |
https://zapier.com/api/platform/cli/push | POST | Nasadenie integrácie |
Ukážky kódu
Inicializácia konektora
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']});Budovanie vlastnej Zapier integrácie s 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;Spracovanie prichádzajúcich Zapier webhookov
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' });});Obmedzenia rýchlosti
| Plán | Požiadavky | Úlohy/mesiac | Interval pollovania |
|---|---|---|---|
| Free | 100/deň | 100 | 15 min |
| Starter | 1 000/deň | 750 | 15 min |
| Professional | 5 000/deň | 2 000 | 2 min |
| Team | 10 000/deň | 50 000 | 1 min |
Limity úloh Zapier
Každý krok Zap sa počíta ako úloha. Viacstupňové Zaps spotrebúvajú viacero úloh na spustenie. Monitoruj využitie úloh v dashboarde Zapier na vyhnutie sa presiahnutiu.
Riešenie problémov
| Problém | Príčina | Riešenie |
|---|---|---|
| Webhook sa nespúšťa | Zap je vypnutý | Skontroluj stav Zap v dashboarde Zapier |
| Dáta sa nemapujú | Nezhoda názvov polí | Overte, že kľúče polí sa zhodujú medzi aplikáciami |
| Duplicitné kontakty | Nie je nakonfigurovaná dedupilikácia | Povol dedupilikáciu na základe e-mailu v Tajo |
| Chyby Zap | Dosiahnutý limit rýchlosti API | Pridaj kroky oneskorenia alebo upgraduj plán Zapier |
| Vypršaná autentifikácia | Token nie je obnovený | Znovu autentifikuj pripojenie v Zapier |
Debug režim
connectors: zapier: debug: true log_level: verbose log_webhooks: trueOdporúčané postupy
- Použi webhooky namiesto pollovania - Webhooky poskytujú tok dát v reálnom čase oproti oneskoreniu pollovania
- Pridaj spracovanie chýb - Použi Zapier Paths na spracovanie scenárov úspech/zlyhanie
- Deduplikuj dáta - Povol dedupilikačné kľúče na prevenciu duplicitných záznamov
- Monitoruj využitie úloh - Nastav upozornenia pred dosiahnutím limitov úloh
- Používaj filtre múdro - Filtruj skoro v Zaps na zníženie zbytočnej spotreby úloh
- Verzuj CLI integrácie - Použi sémantické verzovanie pre Platform CLI aplikácie
Bezpečnosť
- Iba HTTPS - Všetky URL webhookov musia používať HTTPS
- Rotácia API kľúčov - Rotuj kľúče pravidelne cez dashboard Zapier
- OAuth 2.0 - Použi OAuth pre autentifikáciu služieb tretích strán
- Overenie webhookov - Validuj prichádzajúce podpisy webhookov
- Scoped oprávnenia - Udeľuj minimálny potrebný prístup na každý Zap