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
PlatformaZapier
KategóriaAutomatizácia (Vlastná)
Zložitosť nastaveniaĽahké
Oficiálna integráciaNie
Synchronizované dátaUdalosti, Kontakty, Workflowy, Triggery
Metóda autentifikácieAPI 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áš:

  1. Zapier účet (Free tier alebo vyšší)
  2. Brevo účet s API prístupom
  3. Tajo účet s oprávneniami pre konektory
  4. Node.js 18+ nainštalovaný (pre integrácie vyvíjané pomocou CLI)

Autentifikácia

Autentifikácia API kľúčom

Terminal window
# Set your Zapier Platform credentials
export ZAPIER_DEPLOY_KEY=your_deploy_key
export TAJO_API_KEY=your_tajo_api_key
export BREVO_API_KEY=your_brevo_api_key

OAuth 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: LASTNAME

Konfigurá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: exponential

API endpointy

EndpointMetódaPopis
https://hooks.zapier.com/hooks/catch/{id}POSTWebhookový catch hook
https://nla.zapier.com/api/v1/dynamic/exposed/GETZoznam vystavených akcií
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/POSTSpustenie akcie
https://zapier.com/api/platform/cli/appsGETZoznam registrovaných aplikácií
https://zapier.com/api/platform/cli/pushPOSTNasadenie 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 webhook
await 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ánPožiadavkyÚlohy/mesiacInterval pollovania
Free100/deň10015 min
Starter1 000/deň75015 min
Professional5 000/deň2 0002 min
Team10 000/deň50 0001 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émPríčinaRiešenie
Webhook sa nespúšťaZap 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é kontaktyNie je nakonfigurovaná dedupilikáciaPovol dedupilikáciu na základe e-mailu v Tajo
Chyby ZapDosiahnutý limit rýchlosti APIPridaj kroky oneskorenia alebo upgraduj plán Zapier
Vypršaná autentifikáciaToken nie je obnovenýZnovu autentifikuj pripojenie v Zapier

Debug režim

connectors:
zapier:
debug: true
log_level: verbose
log_webhooks: true

Odporúčané postupy

  1. Použi webhooky namiesto pollovania - Webhooky poskytujú tok dát v reálnom čase oproti oneskoreniu pollovania
  2. Pridaj spracovanie chýb - Použi Zapier Paths na spracovanie scenárov úspech/zlyhanie
  3. Deduplikuj dáta - Povol dedupilikačné kľúče na prevenciu duplicitných záznamov
  4. Monitoruj využitie úloh - Nastav upozornenia pred dosiahnutím limitov úloh
  5. Používaj filtre múdro - Filtruj skoro v Zaps na zníženie zbytočnej spotreby úloh
  6. 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

Súvisiace zdroje

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AI asistent

Ahoj! Opýtajte sa ma na dokumentáciu.