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

LastnostVrednost
PlatformaZapier
KategorijaAvtomatizacija (po meri)
Zahtevnost nastavitveEnostavna
Uradna integracijaNe
Sinhronizirani podatkiDogodki, stiki, delovni tokovi, sprožilci
Metoda avtentikacijeAPI 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š:

  1. Račun Zapier (brezplačni plan ali višji)
  2. Brevo račun z dostopom do API
  3. Tajo račun z dovoljenji za konektorje
  4. Node.js 18+ nameščen (za razvoj integracij na osnovi CLI)

Avtentikacija

Avtentikacija z API ključem

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

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

Končne točke API

Končna točkaMetodaOpis
https://hooks.zapier.com/hooks/catch/{id}POSTKljuka za zajem webhooks
https://nla.zapier.com/api/v1/dynamic/exposed/GETSeznam izpostavljenih dejanj
https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/POSTIzvedba dejanja
https://zapier.com/api/platform/cli/appsGETSeznam registriranih aplikacij
https://zapier.com/api/platform/cli/pushPOSTNamestitev 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 webhook
await 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

PlanZahtevkiNalog/mesecInterval anketiranja
Free100/dan10015 min
Starter1.000/dan75015 min
Professional5.000/dan2.0002 min
Team10.000/dan50.0001 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žavaVzrokRešitev
Webhook ne delujeZap izklopljenPreveri status Zap na nadzorni plošči Zapier
Podatki se ne preslikavajoNeujemanje imen poljPreveri, ali se ključi polj ujemajo med aplikacijami
Podvojeni stikiNi konfigurirane deduplikacijeOmogoči deduplikacijo na osnovi e-maila v Tajo
Napake ZapDosežena omejitev hitrosti APIDodaj korake zamika ali nadgradi plan Zapier
Potekel dostopŽeton ni bil obnovljenZnova preveri avtentikacijo povezave v Zapier

Način odpravljanja napak

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

Najboljše prakse

  1. Webhooks pred anketiranjem – webhooks zagotavljajo tok podatkov v realnem času v primerjavi z zamiki anketiranja
  2. Dodaj obravnavo napak – za obravnavo scenarijev uspeha/neuspeha uporabi Zapier Paths
  3. Dedupliciraj podatke – omogoči ključe deduplikacije za preprečevanje podvojenih zapisov
  4. Spremljaj porabo nalog – nastavi opozorila pred doseganjem omejitev nalog
  5. Pametno filtriraj – filtriraj zgodaj v Zapih za zmanjšanje nepotrebne porabe nalog
  6. 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

Povezani viri

Subscribe to updates

developer-docs

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

auto-detect
AI pomočnik

Živjo! Vprašajte me o dokumentaciji.