Zapier Connector
Poveži Zapier z Brevo prek Tajo za premostitev tisoč aplikacij tretjih oseb z delovnimi tokovi marketinške avtomatizacije, ki omogočajo tokove podatkov brez kode in sprožilce na osnovi dogodkov po celotnem tehničnem skladu.
Pregled
| Lastnost | Vrednost |
|---|---|
| Platforma | Zapier |
| Kategorija | Avtomatizacija (po meri) |
| Zahtevnost nastavitve | Enostavna |
| Uradna integracija | Ne |
| Sinhronizirani podatki | Dogodki, stiki, delovni tokovi, sprožilci |
| Metoda avtentikacije | API Key / OAuth 2.0 |
Funkcionalnosti
- Orkestracija več aplikacij – poveži 6.000+ aplikacij z Brevo prek delovnih tokov Zap
- Sprožilci webhooks – prejemaj dogodke v realnem času iz katere koli aplikacije, povezane z Zapier
- Sinhronizacija stikov – potiskaj in vleči stike med platformami, povezanimi z Zapier, in Brevo
- Posredovanje dogodkov – usmerjaj aplikacijske dogodke prek Tajo v avtomatizacije Brevo
- Večkoračni Zapi – gradi kompleksne delovne tokove s filtri, oblikovalci in zamiki
- Aplikacija Zapier po meri – z Zapier Platform CLI gradi prilagojene integracije
Predpogoji
Preden začneš, se prepričaj, da imaš:
- Račun Zapier (brezplačni plan ali višji)
- Brevo račun z dostopom do API
- Tajo račun z dovoljenji za konektorje
- Node.js 18+ nameščen (za razvoj integracij na osnovi CLI)
Avtentikacija
Avtentikacija z API ključem
# 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 podpira OAuth 2.0 za povezovanje storitev tretjih oseb znotraj Zapov:
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' } } }};Konfiguracija
Osnovna nastavitev
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: LASTNAMEKonfiguracija webhooks
Konfiguriraj Tajo za pošiljanje dogodkov na webhooks 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: exponentialKončne točke API
| Končna točka | Metoda | Opis |
|---|---|---|
https://hooks.zapier.com/hooks/catch/{id} | POST | Kljuka za zajem webhooks |
https://nla.zapier.com/api/v1/dynamic/exposed/ | GET | Seznam izpostavljenih dejanj |
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/ | POST | Izvedba dejanja |
https://zapier.com/api/platform/cli/apps | GET | Seznam registriranih aplikacij |
https://zapier.com/api/platform/cli/push | POST | Namestitev integracije |
Primeri kode
Inicializacija konektorja
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']});Zgradba integracijo Zapier po meri 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;Obravnava dohodnih webhooks 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' });});Omejitve hitrosti
| Plan | Zahtevki | Nalog/mesec | Interval anketiranja |
|---|---|---|---|
| Free | 100/dan | 100 | 15 min |
| Starter | 1.000/dan | 750 | 15 min |
| Professional | 5.000/dan | 2.000 | 2 min |
| Team | 10.000/dan | 50.000 | 1 min |
Omejitve nalog Zapier
Vsak korak Zapa se šteje kot naloga. Večkoračni Zapi porabijo več nalog na izvedbo. Spremljaj porabo nalog na nadzorni plošči Zapier, da se izogneš prekoračitvam.
Odpravljanje težav
| Težava | Vzrok | Rešitev |
|---|---|---|
| Webhook ne deluje | Zap izklopljen | Preveri status Zap na nadzorni plošči Zapier |
| Podatki se ne preslikavajo | Neujemanje imen polj | Preveri, ali se ključi polj ujemajo med aplikacijami |
| Podvojeni stiki | Ni konfigurirane deduplikacije | Omogoči deduplikacijo na osnovi e-maila v Tajo |
| Napake Zap | Dosežena omejitev hitrosti API | Dodaj korake zamika ali nadgradi plan Zapier |
| Potekel dostop | Žeton ni bil obnovljen | Znova preveri avtentikacijo povezave v Zapier |
Način odpravljanja napak
connectors: zapier: debug: true log_level: verbose log_webhooks: trueNajboljše prakse
- Webhooks pred anketiranjem – webhooks zagotavljajo tok podatkov v realnem času v primerjavi z zamiki anketiranja
- Dodaj obravnavo napak – za obravnavo scenarijev uspeha/neuspeha uporabi Zapier Paths
- Dedupliciraj podatke – omogoči ključe deduplikacije za preprečevanje podvojenih zapisov
- Spremljaj porabo nalog – nastavi opozorila pred doseganjem omejitev nalog
- Pametno filtriraj – filtriraj zgodaj v Zapih za zmanjšanje nepotrebne porabe nalog
- Verzioniranje integracij CLI – za aplikacije Platform CLI uporabi semantično verzioniranje
Varnost
- Samo HTTPS – vsi URL-ji webhooks morajo uporabljati HTTPS
- Rotacija API ključev – periodično menjaj ključe prek nadzorne plošče Zapier
- OAuth 2.0 – za avtentikacijo storitev tretjih oseb uporabi OAuth
- Preverjanje webhooks – potrdi podpise dohodnih webhooks
- Obsegasta dovoljenja – za vsak Zap dodeli minimalni zahtevani dostop