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

SvojstvoVrijednost
PlatformaZapier
KategorijaAutomatizacija (Prilagođeno)
Složenost postavljanjaJednostavno
Službena integracijaNe
Sinkronizirani podaciDogađaji, Kontakti, Tijekovi rada, Okidači
Metoda autentifikacijeAPI 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:

  1. Zapier račun (besplatni plan ili viši)
  2. Brevo račun s API pristupom
  3. Tajo račun s dozvolama konektora
  4. Node.js 18+ instaliran (za razvoj integracije temeljene na CLI-ju)

Autentifikacija

Autentifikacija API ključem

Terminal window
# Postavite vjerodajnice Zapier platforme
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 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: LASTNAME

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

API krajnje točke

Krajnja točkaMetodaOpis
https://hooks.zapier.com/hooks/catch/{id}POSTWebhook catch hook
https://nla.zapier.com/api/v1/dynamic/exposed/GETPopis izloženih akcija
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/POSTIzvršite akciju
https://zapier.com/api/platform/cli/appsGETPopis registriranih aplikacija
https://zapier.com/api/platform/cli/pushPOSTRasporedite 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 webhookova
await 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

PlanZahtjeviZadaci/MjInterval anketiranja
Besplatno100/dan10015 min
Starter1.000/dan75015 min
Professional5.000/dan2.0002 min
Tim10.000/dan50.0001 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

ProblemUzrokRješenje
Webhook se ne pokrećeZap isključenProvjerite status Zapa u Zapier nadzornoj ploči
Podaci se ne mapirajuNepodudaranje naziva poljaVerificirajte da su ključevi polja usklađeni između aplikacija
Duplikati kontakataNema konfiguriranog deduplikacijeOmogućite deduplikaciju temeljenu na e-mailu u Taju
Greške ZapaPogođen API limit brzineDodajte korake kašnjenja ili nadogradite Zapier plan
Autentifikacija isteklaToken nije osvježenPonovo autentificirajte vezu u Zapieru

Način otklanjanja grešaka

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

Preporučene prakse

  1. Koristite webhookove umjesto anketiranja - Webhookovi pružaju tok podataka u stvarnom vremenu u odnosu na kašnjenja anketiranja
  2. Dodajte upravljanje greškama - Koristite Zapier Paths za upravljanje scenarijima uspjeha/neuspjeha
  3. Deduplicirajte podatke - Omogućite ključeve deduplikacije za sprječavanje duplikata zapisa
  4. Pratite upotrebu zadataka - Postavite upozorenja prije dostizanja ograničenja zadataka
  5. Pametno koristite filtre - Filtrirajte rano u Zapsima za smanjenje nepotrebne potrošnje zadataka
  6. 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

Povezani resursi

Subscribe to updates

developer-docs

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

auto-detect
AI asistent

Bok! Pitajte me o dokumentaciji.