---
title: "Zapier Connector"
description: "Popoln vodnik za integracijo Zapier za povezovanje tisoč aplikacij z Brevo prek Tajo z Zapi, webhooks in Zapier Platform CLI."
url: https://tajo.io/sl/docs/connectors/custom/zapier/
markdown: https://tajo.io/sl/docs/connectors/custom/zapier.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Zapier Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | Zapier |
| **Kategorija** | Avtomatizacija (po meri) |
| **Zahtevnost nastavitve** | Enostavna |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Dogodki, stiki, delovni tokovi, sprožilci |
| **Metoda avtentikacije** | API 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

```bash
# 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:

```javascript
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

```yaml
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:

```yaml
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čka | Metoda | Opis |
| --- | --- | --- |
| `https://hooks.zapier.com/hooks/catch/{id}` | POST | Kljuka za zajem webhooks |
| `https://nla.zapier.com/api/v1/dynamic/exposed/` | GET | Seznam izpostavljenih dejanj |
| `https://nla.zapier.com/api/v1/dynamic/exposed/{action_id}/execute/` | POST | Izvedba dejanja |
| `https://zapier.com/api/platform/cli/apps` | GET | Seznam registriranih aplikacij |
| `https://zapier.com/api/platform/cli/push` | POST | Namestitev integracije |

## Primeri kode

### Inicializacija konektorja

```javascript
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

```javascript
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.example.com/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.example.com/v1/contacts/sync',
            body: bundle.inputData
          });
          return response.data;
        }
      }
    }
  }
};

module.exports = App;
```

Caution

Naslov `example.com` zgoraj je le nadomestni naslov, dokler končna točka Tajo ne bo na voljo.

### Obravnava dohodnih webhooks Zapier

```javascript
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

| Plan | Zahtevki | Nalog/mesec | Interval anketiranja |
| --- | --- | --- | --- |
| Free | 100/dan | 100 | 15 min |
| Starter | 1.000/dan | 750 | 15 min |
| Professional | 5.000/dan | 2.000 | 2 min |
| Team | 10.000/dan | 50.000 | 1 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žava | Vzrok | Rešitev |
| --- | --- | --- |
| Webhook ne deluje | Zap izklopljen | Preveri status Zap na nadzorni plošči Zapier |
| Podatki se ne preslikavajo | Neujemanje imen polj | Preveri, ali se ključi polj ujemajo med aplikacijami |
| Podvojeni stiki | Ni konfigurirane deduplikacije | Omogoči deduplikacijo na osnovi e-maila v Tajo |
| Napake Zap | Dosežena omejitev hitrosti API | Dodaj korake zamika ali nadgradi plan Zapier |
| Potekel dostop | Žeton ni bil obnovljen | Znova preveri avtentikacijo povezave v Zapier |

### Način odpravljanja napak

```yaml
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

- [Segment Connector](https://tajo.io/sl/docs/connectors/custom/segment)
- [Brevo Connector](https://tajo.io/sl/docs/connectors/marketing/brevo)
- [Customer Sync Skill](https://tajo.io/sl/docs/skills/data-sync/customer-sync)
- [Zapier Platform CLI dokumentacija](https://platform.zapier.com/reference/cli-docs)