Bed om tidlig adgang til Tajo

Indtast dit fornavn og en e-mailadresse eller et telefonnummer. Vi kontakter dig med oplysninger om adgang til Tajo.

Zapier Connector

Forbind Zapier til Brevo via Tajo for at bygge bro mellem tusindvis af tredjepartsapplikationer og dine marketingautomatiseringsworkflows, hvilket muliggør no-code-dataflows og hændelsesdrevne triggere på tværs af hele din tech-stack.

Oversigt

Egenskab	Værdi
Platform	Zapier
Kategori	Automatisering (brugerdefineret)
Opsætningskompleksitet	Let
Officiel integration	Nej
Synkroniserede data	Hændelser, kontakter, workflows, triggere
Autentifikationsmetode	API Key / OAuth 2.0

Funktioner

Multi-app-orkestrering - Forbind over 6.000 apps til Brevo via Zap-workflows
Webhook-triggere - Modtag realtidshændelser fra enhver Zapier-forbundet app
Kontaktsynkronisering - Skub og træk kontakter mellem Zapier-forbundne platforme og Brevo
Hændelsesvideresendelse - Rut applikationshændelser via Tajo ind i Brevo-automatiseringer
Multi-step Zaps - Byg komplekse workflows med filtre, formattere og forsinkelser
Brugerdefineret Zapier-app - Brug Zapier Platform CLI til at bygge skræddersyede integrationer

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

En Zapier-konto (Free-niveau eller højere)
En Brevo-konto med API-adgang
En Tajo-konto med konnektorrettigheder
Node.js 18+ installeret (til CLI-baseret integrationsudvikling)

Autentifikation

API Key-autentifikation

# 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 understøtter OAuth 2.0 til at forbinde tredjepartstjenester i 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'
      }
    }
  }
};

Konfiguration

Grundlæggende opsætning

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

Webhook-konfiguration

Konfigurér Tajo til at sende hændelser til Zapier-webhooks:

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-endpoints

Endpoint	Metode	Beskrivelse
`https://hooks.zapier.com/hooks/catch/{id}`	POST	Webhook catch hook
`https://nla.zapier.com/api/v1/dynamic/exposed/`	GET	Vis eksponerede handlinger
`https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/`	POST	Udfør en handling
`https://zapier.com/api/platform/cli/apps`	GET	Vis registrerede apps
`https://zapier.com/api/platform/cli/push`	POST	Deploy integration

Kodeeksempler

Initialisér konnektor

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']
});

Byg en brugerdefineret Zapier-integration med 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;

Håndtér indgående Zapier-webhooks

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' });
});

Ratebegrænsninger

Plan	Forespørgsler	Opgaver/måned	Polling-interval
Free	100/dag	100	15 min
Starter	1.000/dag	750	15 min
Professional	5.000/dag	2.000	2 min
Team	10.000/dag	50.000	1 min

Zapier-opgavegrænser

Hvert Zap-trin tæller som en opgave. Multi-step Zaps forbruger flere opgaver per kørsel. Overvåg dit opgaveforbrug i Zapier-dashboardet for at undgå overskridelser.

Fejlfinding

Problem	Årsag	Løsning
Webhook aktiveres ikke	Zap slukket	Tjek Zap-status i Zapier-dashboardet
Data mapper ikke	Feltnavn matcher ikke	Verificér, at feltnøgler matcher mellem apps
Duplikerede kontakter	Ingen dedup konfigureret	Aktivér e-mailbaseret deduplikering i Tajo
Zap-fejl	API-ratebegrænsning ramt	Tilføj forsinkelsestrin eller opgradér Zapier-plan
Auth udløbet	Token ikke opdateret	Genautentificér forbindelsen i Zapier

Fejlfindingstilstand

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

Best practices

Brug webhooks frem for polling - Webhooks giver realtidsdataflow vs. polling-forsinkelser
Tilføj fejlhåndtering - Brug Zapier Paths til at håndtere succes-/fejlscenarier
Deduplikér data - Aktivér deduplikeringsnøgler for at forhindre duplikerede poster
Overvåg opgaveforbrug - Opsæt advarsler, før du når opgavegrænser
Brug filtre klogt - Filtrér tidligt i Zaps for at reducere unødvendigt opgaveforbrug
Versionér dine CLI-integrationer - Brug semantisk versionering til Platform CLI-apps

Sikkerhed

Kun HTTPS - Alle webhook-URL’er skal bruge HTTPS
API-nøglerotation - Rotér nøgler regelmæssigt via Zapier-dashboardet
OAuth 2.0 - Brug OAuth til autentifikation af tredjepartstjenester
Webhook-verifikation - Validér indgående webhook-signaturer
Scoped rettigheder - Giv minimumskrævet adgang per Zap