---
title: "Zoom konnektor"
description: "Teljes Zoom integrációs útmutató értekezlet-résztvevők, webinar-látogatók és elköteleződési adatok Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/custom/zoom/
markdown: https://tajo.io/hu/docs/connectors/custom/zoom.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Zoom konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Zoomot a Brevóhoz a Tajo segítségével, hogy automatikusan szinkronizáld az értekezlet-résztvevőket és webinar-látogatókat kapcsolatokként, értekezlet utáni utánkövetési sorozatokat indíts, és elköteleződési mutatókat kövess a marketingautomatizálásaidhoz.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Zoom |
| **Kategória** | Videókonferencia (Egyéni) |
| **Telepítés bonyolultsága** | Közepes |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Résztvevők, Események, Webinarok, Kapcsolatok |
| **Hitelesítési módszer** | OAuth 2.0 / Szerver-szerver OAuth |

## Funkciók

- **Résztvevő-szinkronizáció** – Automatikusan hozz létre Brevo kapcsolatokat az értekezlet-résztvevőkből
- **Webinar látogató-rögzítés** – Webinar regisztrálók és látogatók szinkronizálása
- **Értekezlet-esemény kiváltók** – Automatizálások indítása értekezlet kezdetén, végén és felvételi eseményeknél
- **Elköteleződés-követés** – Részvételi időtartam és részvételi mutatók követése
- **Webinar utánkövetés** – Célzott e-mail sorozatok indítása webinar látogatottság alapján
- **Felvétel értesítések** – Felvételi linkek küldése Brevo e-mail kampányokon keresztül

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Zoom fiókkal (Pro csomag vagy magasabb)
2. Egy Zoom szerver-szerver OAuth alkalmazással vagy OAuth alkalmazással a [Zoom App Marketplace](https://marketplace.zoom.us/) oldalon keresztül
3. Egy Brevo fiókkal API-hozzáféréssel
4. Egy Tajo fiókkal konnektor engedélyekkel

## Hitelesítés

### Szerver-szerver OAuth (Ajánlott)

```bash
# Create a Server-to-Server OAuth app at marketplace.zoom.us
export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret
```

```javascript
// Get access token via Server-to-Server OAuth
const tokenResponse = await fetch('https://zoom.us/oauth/token', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${Buffer.from(
      `${process.env.ZOOM_CLIENT_ID}:${process.env.ZOOM_CLIENT_SECRET}`
    ).toString('base64')}`,
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    grant_type: 'account_credentials',
    account_id: process.env.ZOOM_ACCOUNT_ID
  })
});

const { access_token } = await tokenResponse.json();
```

### OAuth 2.0 (Felhasználói szint)

```javascript
// Authorization URL for user-level OAuth
const authUrl = 'https://zoom.us/oauth/authorize?' +
  new URLSearchParams({
    client_id: process.env.ZOOM_CLIENT_ID,
    redirect_uri: 'https://your-app.com/callback',
    response_type: 'code'
  });

// Exchange code for tokens
const tokenResponse = await fetch('https://zoom.us/oauth/token', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${Buffer.from(
      `${process.env.ZOOM_CLIENT_ID}:${process.env.ZOOM_CLIENT_SECRET}`
    ).toString('base64')}`,
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    grant_type: 'authorization_code',
    code: authorizationCode,
    redirect_uri: 'https://your-app.com/callback'
  })
});
```

## Konfiguráció

### Alapbeállítás

```yaml
connectors:
  zoom:
    enabled: true
    account_id: "${ZOOM_ACCOUNT_ID}"
    client_id: "${ZOOM_CLIENT_ID}"
    client_secret: "${ZOOM_CLIENT_SECRET}"

    sync:
      participants: true
      webinars: true
      recordings: true

    webhook:
      secret_token: "${ZOOM_WEBHOOK_SECRET}"
      verification_token: "${ZOOM_VERIFICATION_TOKEN}"

    lists:
      meeting_participants: 15
      webinar_attendees: 16
      webinar_registrants: 17
```

### Mezőleképezés

```yaml
field_mapping:
  email: email
  name: FIRSTNAME
  join_time: MEETING_JOIN_DATE
  duration: MEETING_DURATION
  webinar_title: WEBINAR_NAME
  attendance_status: ATTENDANCE_STATUS
  registration_source: UTM_SOURCE
```

## API végpontok

| Végpont | Módszer | Leírás |
| --- | --- | --- |
| `https://api.zoom.us/v2/users` | GET | Felhasználók listázása |
| `https://api.zoom.us/v2/users/{userId}/meetings` | GET | Értekezletek listázása |
| `https://api.zoom.us/v2/meetings/{meetingId}` | GET | Értekezlet részleteinek lekérése |
| `https://api.zoom.us/v2/past_meetings/{meetingId}/participants` | GET | Múltbeli értekezlet résztvevőinek listázása |
| `https://api.zoom.us/v2/users/{userId}/webinars` | GET | Webinarok listázása |
| `https://api.zoom.us/v2/webinars/{webinarId}/registrants` | GET | Webinar regisztrálók listázása |
| `https://api.zoom.us/v2/webinars/{webinarId}/participants` | GET | Webinar résztvevők listázása |
| `https://api.zoom.us/v2/meetings/{meetingId}/recordings` | GET | Értekezlet felvételek lekérése |
| `https://api.zoom.us/v2/webhooks` | POST | Feliratkozás webhookokra |

## Kódpéldák

### A konnektor inicializálása

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.connectors.connect('zoom', {
  accountId: process.env.ZOOM_ACCOUNT_ID,
  clientId: process.env.ZOOM_CLIENT_ID,
  clientSecret: process.env.ZOOM_CLIENT_SECRET
});
```

### Értekezlet-résztvevők szinkronizálása

```javascript
// Retrieve past meeting participants
const response = await fetch(
  `https://api.zoom.us/v2/past_meetings/${meetingId}/participants`,
  {
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'application/json'
    }
  }
);

const { participants } = await response.json();

for (const participant of participants) {
  if (participant.user_email) {
    await tajo.contacts.sync({
      email: participant.user_email,
      attributes: {
        FIRSTNAME: participant.name,
        MEETING_DURATION: participant.duration,
        MEETING_JOIN_DATE: participant.join_time,
        ATTENDANCE_STATUS: 'attended'
      },
      listIds: [15]
    });
  }
}
```

### Webinar látogatók szinkronizálása

```javascript
// Get webinar attendees and sync to Brevo
const attendeesResponse = await fetch(
  `https://api.zoom.us/v2/past_webinars/${webinarId}/participants`,
  {
    headers: { 'Authorization': `Bearer ${accessToken}` }
  }
);

const { participants: attendees } = await attendeesResponse.json();

for (const attendee of attendees) {
  await tajo.contacts.sync({
    email: attendee.user_email,
    attributes: {
      FIRSTNAME: attendee.name,
      WEBINAR_NAME: webinarTitle,
      ATTENDANCE_STATUS: 'attended',
      MEETING_DURATION: attendee.duration
    },
    listIds: [16]
  });
}
```

### Zoom webhookok kezelése

```javascript
app.post('/webhooks/zoom', async (req, res) => {
  // Handle Zoom URL validation challenge
  if (req.body.event === 'endpoint.url_validation') {
    const hashForValidation = crypto
      .createHmac('sha256', process.env.ZOOM_WEBHOOK_SECRET)
      .update(req.body.payload.plainToken)
      .digest('hex');

    return res.json({
      plainToken: req.body.payload.plainToken,
      encryptedToken: hashForValidation
    });
  }

  // Verify webhook signature
  const message = `v0:${req.headers['x-zm-request-timestamp']}:${JSON.stringify(req.body)}`;
  const hash = crypto
    .createHmac('sha256', process.env.ZOOM_WEBHOOK_SECRET)
    .update(message)
    .digest('hex');
  const signature = `v0=${hash}`;

  if (req.headers['x-zm-signature'] !== signature) {
    return res.status(401).send('Unauthorized');
  }

  const { event, payload } = req.body;

  await tajo.connectors.handleWebhook('zoom', {
    topic: event,
    payload: payload
  });

  res.status(200).send('OK');
});
```

## Ráta-korlátok

| Kategória | Korlát | Megjegyzések |
| --- | --- | --- |
| Könnyű API hívások | 30 kérés/mp | GET felhasználó, értekezlet-infó |
| Közepes API hívások | 20 kérés/mp | Résztvevők, webinarok listázása |
| Nehéz API hívások | 10 kérés/mp | Riportok, felvételek |
| Napi korlát | 5 000+ | Csomag szintjétől függ |

Ráta-korlát fejlécek

A Zoom `X-RateLimit-Limit`, `X-RateLimit-Remaining` és `Retry-After` fejléceket ad vissza. Implementálj visszalépési logikát ezek alapján a 429 hibák elkerüléséhez.

## Hibaelhárítás

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| 401 Unauthorized | Token lejárt | Frissítsd a szerver-szerver OAuth tokent |
| Hiányzó résztvevők | Értekezlet még nem ért véget | Várj, amíg az értekezlet véget ér a teljes adatokhoz |
| Webhook-ellenőrzés sikertelen | Rossz titok | Ellenőrizd a webhook titkot a Zoom Marketplace-en |
| Nincs e-mail adat | Vendég résztvevők | Engedélyezd a regisztrációt az e-mailek rögzítéséhez |
| Ráta-korlát 429 | Túl sok kérés | Implementálj exponenciális visszalépést |

### Hibakeresési mód

```yaml
connectors:
  zoom:
    debug: true
    log_level: verbose
    log_webhooks: true
```

## Legjobb gyakorlatok

1. **Használj szerver-szerver OAuth-ot** – Egyszerűbb hitelesítés felhasználói interakció nélkül
2. **Engedélyezd a webinar regisztrációt** – Szükséges a látogató e-mail-címek rögzítéséhez
3. **Dolgozz fel az értekezlet vége után** – A résztvevői adatok csak az értekezletek befejezése után teljesek
4. **Szegmentálj eseménytípus szerint** – Különböző Brevo listákat rendelj értekezletekhez és webinarokhoz
5. **Kövesd az elköteleződési mutatókat** – Használj időtartamot és csatlakozási időt az érdeklődő-pontozáshoz
6. **Küldj felvétel-utánkövetéseket** – Automatizáld a felvételi link kézbesítését Brevón keresztül

## Biztonság

- **OAuth 2.0** – Szerver-szerver vagy felhasználói szintű OAuth hitelesítés
- **Webhook-ellenőrzés** – HMAC-SHA256 aláírás-ellenőrzés
- **URL-ellenőrzés** – Kihívás-válasz ellenőrzés webhook végpontokhoz
- **Hatókörhöz korlátozott jogosultságok** – Kérj minimálisan szükséges OAuth hatóköröket
- **Token rotáció** – A szerver-szerver tokenek automatikusan lejárnak (1 óra)
- **Titkosított átvitel** – TLS 1.2+ minden API kommunikációhoz

## Kapcsolódó források

- [Calendly konnektor](https://tajo.io/hu/docs/connectors/custom/calendly)
- [Zapier konnektor](https://tajo.io/hu/docs/connectors/custom/zapier)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Zoom API dokumentáció](https://developers.zoom.us/docs/api/)