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

VlastnostHodnota
PlatformaZapier
KategorieAutomatizace (Vlastní)
Složitost nastaveníSnadná
Oficiální integraceNe
Synchronizovaná dataUdá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:

  1. Účet Zapier (plán Free nebo vyšší)
  2. Účet Brevo s přístupem k API
  3. Účet Tajo s oprávněními ke konektoru
  4. Node.js 18+ nainstalovaný (pro vývoj integrace na bázi CLI)

Ověření

Ověření API klíčem

Terminal window
# Nastavte přihlašovací údaje platformy Zapier
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 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: LASTNAME

Konfigurace 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: exponential

Koncové body API

Koncový bodMetodaPopis
https://hooks.zapier.com/hooks/catch/{id}POSTZachytávací webhook
https://nla.zapier.com/api/v1/dynamic/exposed/GETVýpis exponovaných akcí
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/POSTProvedení akce
https://zapier.com/api/platform/cli/appsGETVýpis registrovaných aplikací
https://zapier.com/api/platform/cli/pushPOSTNasazení 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 webhook
await 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ánPožadavkyÚkoly/měsícInterval pollování
Free100/den10015 min
Starter1 000/den75015 min
Professional5 000/den2 0002 min
Team10 000/den50 0001 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émPříč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í kontaktyNení nakonfigurována deduplikacePovolte deduplikaci na základě e-mailu v Tajo
Chyby ZapuDosažen limit rychlosti APIPřidejte kroky zpoždění nebo upgradujte plán Zapier
Vypršelé ověřeníToken nebyl obnovenZnovu ověřte připojení v Zapier

Režim ladění

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

Osvědčené postupy

  1. 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í
  2. Přidejte zpracování chyb – Používejte Zapier Paths pro zpracování scénářů úspěchu/selhání
  3. Deduplikujte data – Povolte klíče deduplikace pro prevenci duplicitních záznamů
  4. Monitorujte využití úkolů – Nastavte upozornění před dosažením limitů úkolů
  5. Používejte filtry rozumně – Filtrujte brzy v Zapech pro snížení zbytečné spotřeby úkolů
  6. 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

Související zdroje

Subscribe to updates

developer-docs

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

auto-detect
AI asistent

Ahoj! Zeptejte se mě na dokumentaci.