Zapier Konektor
Povežite Zapier s Brevom putem Taja kako biste premostili tisuće aplikacija trećih strana s vašim tijekovima rada marketinške automatizacije, omogućujući tokove podataka bez koda i okidače vođene događajima kroz cijeli vaš tehnološki stog.
Pregled
| Svojstvo | Vrijednost |
|---|---|
| Platforma | Zapier |
| Kategorija | Automatizacija (Prilagođeno) |
| Složenost postavljanja | Jednostavno |
| Službena integracija | Ne |
| Sinkronizirani podaci | Događaji, Kontakti, Tijekovi rada, Okidači |
| Metoda autentifikacije | API ključ / OAuth 2.0 |
Značajke
- Orkestracija više aplikacija - Povežite 6.000+ aplikacija s Brevom putem Zap tijekova rada
- Webhook okidači - Primajte događaje u stvarnom vremenu iz bilo koje Zapier-povezane aplikacije
- Sinkronizacija kontakata - Guranje i povlačenje kontakata između Zapier-povezanih platforma i Breva
- Prosljeđivanje događaja - Usmjeravajte aplikacijske događaje kroz Tajo u Brevo automatizacije
- Zaps s više koraka - Gradite složene tijekove rada s filterima, formaterima i kašnjenjima
- Prilagođena Zapier aplikacija - Koristite Zapier Platform CLI za izgradnju prilagođenih integracija
Preduvjeti
Prije nego što počnete, osigurajte da imate:
- Zapier račun (besplatni plan ili viši)
- Brevo račun s API pristupom
- Tajo račun s dozvolama konektora
- Node.js 18+ instaliran (za razvoj integracije temeljene na CLI-ju)
Autentifikacija
Autentifikacija API ključem
# Postavite vjerodajnice Zapier platformeexport ZAPIER_DEPLOY_KEY=your_deploy_keyexport TAJO_API_KEY=your_tajo_api_keyexport BREVO_API_KEY=your_brevo_api_keyOAuth 2.0
Zapier podržava OAuth 2.0 za povezivanje usluga trećih strana unutar Zapsa:
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 konfiguracija
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 webhookova
Konfigurirajte Tajo za slanje događaja na Zapier webhookove:
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 krajnje točke
| Krajnja točka | Metoda | Opis |
|---|---|---|
https://hooks.zapier.com/hooks/catch/{id} | POST | Webhook catch hook |
https://nla.zapier.com/api/v1/dynamic/exposed/ | GET | Popis izloženih akcija |
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/ | POST | Izvršite akciju |
https://zapier.com/api/platform/cli/apps | GET | Popis registriranih aplikacija |
https://zapier.com/api/platform/cli/push | POST | Rasporedite integraciju |
Primjeri koda
Inicijalizacija konektora
import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY});
// Povežite Zapier putem webhookovaawait tajo.connectors.connect('zapier', { webhookUrl: process.env.ZAPIER_WEBHOOK_URL, events: ['contact.created', 'order.completed']});Izgradnja prilagođene Zapier integracije 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: 'Novi kontakt u Taju', description: 'Pokreće se kada je sinkroniziran novi kontakt.' }, 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: 'Sinkronizacija kontakta u Brevo', description: 'Sinkronizira kontakt u Brevo putem Taja.' }, 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;Rukovanje dolaznim Zapier webhookovima
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' });});Ograničenja brzine
| Plan | Zahtjevi | Zadaci/Mj | Interval anketiranja |
|---|---|---|---|
| Besplatno | 100/dan | 100 | 15 min |
| Starter | 1.000/dan | 750 | 15 min |
| Professional | 5.000/dan | 2.000 | 2 min |
| Tim | 10.000/dan | 50.000 | 1 min |
Ograničenja Zapier zadataka
Svaki korak Zapa broji se kao zadatak. Zapsi s više koraka troše više zadataka po izvršavanju. Pratite upotrebu zadataka u Zapier nadzornoj ploči kako biste izbjegli prekoračenja.
Rješavanje problema
| Problem | Uzrok | Rješenje |
|---|---|---|
| Webhook se ne pokreće | Zap isključen | Provjerite status Zapa u Zapier nadzornoj ploči |
| Podaci se ne mapiraju | Nepodudaranje naziva polja | Verificirajte da su ključevi polja usklađeni između aplikacija |
| Duplikati kontakata | Nema konfiguriranog deduplikacije | Omogućite deduplikaciju temeljenu na e-mailu u Taju |
| Greške Zapa | Pogođen API limit brzine | Dodajte korake kašnjenja ili nadogradite Zapier plan |
| Autentifikacija istekla | Token nije osvježen | Ponovo autentificirajte vezu u Zapieru |
Način otklanjanja grešaka
connectors: zapier: debug: true log_level: verbose log_webhooks: truePreporučene prakse
- Koristite webhookove umjesto anketiranja - Webhookovi pružaju tok podataka u stvarnom vremenu u odnosu na kašnjenja anketiranja
- Dodajte upravljanje greškama - Koristite Zapier Paths za upravljanje scenarijima uspjeha/neuspjeha
- Deduplicirajte podatke - Omogućite ključeve deduplikacije za sprječavanje duplikata zapisa
- Pratite upotrebu zadataka - Postavite upozorenja prije dostizanja ograničenja zadataka
- Pametno koristite filtre - Filtrirajte rano u Zapsima za smanjenje nepotrebne potrošnje zadataka
- Verzijonirajte CLI integracije - Koristite semantičko verzioniranje za Platform CLI aplikacije
Sigurnost
- Samo HTTPS - Svi URL-ovi webhookova moraju koristiti HTTPS
- Rotacija API ključeva - Periodično rotirajte ključeve putem Zapier nadzorne ploče
- OAuth 2.0 - Koristite OAuth za autentifikaciju usluga trećih strana
- Verifikacija webhookova - Validirajte potpise dolaznih webhookova
- Opsežene dozvole - Odobrite minimalni potrebni pristup po Zapu