Konektor Zapier
Propojte Zapier s Brevo přes Tajo pro propojení tisíců aplikací třetích stran s vašimi pracovními toky marketingové automatizace, umožňující datové toky bez kódu a spouštěče řízené událostmi napříč celým technologickým stackem.
Přehled
| Vlastnost | Hodnota |
|---|---|
| Platforma | Zapier |
| Kategorie | Automatizace (Vlastní) |
| Složitost nastavení | Snadná |
| Oficiální integrace | Ne |
| Synchronizovaná data | Události, Kontakty, Pracovní toky, Spouštěče |
| Metoda ověření | API klíč / OAuth 2.0 |
Funkce
- Orchestrace více aplikací – Propojte 6 000+ aplikací s Brevo přes pracovní toky Zap
- Webhookové spouštěče – Přijímejte události v reálném čase z libovolné aplikace připojené přes Zapier
- Synchronizace kontaktů – Odesílejte a přijímejte kontakty mezi platformami připojenými přes Zapier a Brevo
- Přeposílání událostí – Směrujte události aplikací přes Tajo do automatizací Brevo
- Víceúrovňové Zapy – Sestavujte složité pracovní toky s filtry, formátovači a zpožděními
- Vlastní aplikace Zapier – Používejte Zapier Platform CLI pro vytváření přizpůsobených integrací
Předpoklady
Než začnete, ujistěte se, že máte:
- Účet Zapier (plán Free nebo vyšší)
- Účet Brevo s přístupem k API
- Účet Tajo s oprávněními ke konektoru
- Node.js 18+ nainstalovaný (pro vývoj integrace na bázi CLI)
Ověření
Ověření API klíčem
# Nastavte přihlašovací údaje platformy Zapierexport 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 pro propojení služeb třetích stran v rámci 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' } } }};Konfigurace
Základní nastavení
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: LASTNAMEKonfigurace webhooků
Nakonfigurujte Tajo pro odesílání událostí do webhooků 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: exponentialKoncové body API
| Koncový bod | Metoda | Popis |
|---|---|---|
https://hooks.zapier.com/hooks/catch/{id} | POST | Zachytávací webhook |
https://nla.zapier.com/api/v1/dynamic/exposed/ | GET | Výpis exponovaných akcí |
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/ | POST | Provedení akce |
https://zapier.com/api/platform/cli/apps | GET | Výpis registrovaných aplikací |
https://zapier.com/api/platform/cli/push | POST | Nasazení integrace |
Příklady kódu
Inicializace konektoru
import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY});
// Připojení Zapier přes webhookawait tajo.connectors.connect('zapier', { webhookUrl: process.env.ZAPIER_WEBHOOK_URL, events: ['contact.created', 'order.completed']});Sestavení vlastní integrace Zapier pomocí 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;Zpracování příchozích webhooků 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' });});Omezení rychlosti
| Plán | Požadavky | Úkoly/měsíc | Interval pollování |
|---|---|---|---|
| Free | 100/den | 100 | 15 min |
| Starter | 1 000/den | 750 | 15 min |
| Professional | 5 000/den | 2 000 | 2 min |
| Team | 10 000/den | 50 000 | 1 min |
Limity úkolů Zapier
Každý krok Zapu se počítá jako úkol. Víceúrovňové Zapy spotřebovávají více úkolů na každé provedení. Sledujte využití úkolů v řídicím panelu Zapier, abyste se vyhnuli překročení limitů.
Řešení problémů
| Problém | Příčina | Řešení |
|---|---|---|
| Webhook se nespouští | Zap je vypnutý | Zkontrolujte stav Zapu v řídicím panelu Zapier |
| Data se nemapují | Nesoulad názvů polí | Ověřte, zda klíče polí odpovídají mezi aplikacemi |
| Duplicitní kontakty | Není nakonfigurována deduplikace | Povolte deduplikaci na základě e-mailu v Tajo |
| Chyby Zapu | Dosažen limit rychlosti API | Přidejte kroky zpoždění nebo upgradujte plán Zapier |
| Vypršelé ověření | Token nebyl obnoven | Znovu ověřte připojení v Zapier |
Režim ladění
connectors: zapier: debug: true log_level: verbose log_webhooks: trueOsvědčené postupy
- Používejte webhooky místo pollování – Webhooky poskytují datový tok v reálném čase oproti zpožděním při pollování
- Přidejte zpracování chyb – Používejte Zapier Paths pro zpracování scénářů úspěchu/selhání
- Deduplikujte data – Povolte klíče deduplikace pro prevenci duplicitních záznamů
- Monitorujte využití úkolů – Nastavte upozornění před dosažením limitů úkolů
- Používejte filtry rozumně – Filtrujte brzy v Zapech pro snížení zbytečné spotřeby úkolů
- Verzujte své CLI integrace – Používejte sémantické verzování pro aplikace Platform CLI
Zabezpečení
- Pouze HTTPS – Všechny URL webhooků musí používat HTTPS
- Rotace API klíčů – Pravidelně rotujte klíče přes řídicí panel Zapier
- OAuth 2.0 – Používejte OAuth pro ověřování služeb třetích stran
- Ověření webhooků – Ověřujte podpisy příchozích webhooků
- Omezená oprávnění – Udělujte minimální požadovaný přístup na každý Zap