> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatizálások

> Ismétlődő feladatok ütemezése, és függvények automatikus indítása adatbázis-események vagy összekötő-webhookesemények alapján

Ön a fejlesztői dokumentációt nézi

Ez a dokumentáció a Base44 fejlesztői platformmal dolgozó fejlesztőknek szól. Az alkalmazásszerkesztőben használható munkafolyamatokról a [Munkafolyamatok létrehozása](https://docs.base44.com/hu/Building-your-app/Creating-workflows.md) oldalon olvashat.

> [!WARNING]
>
> **Az alkalmazás automatizálásának új módja a munkafolyamatok.** Új automatizálásokat már nem hozhat létre. A meglévő automatizálások tovább futnak, és továbbra is módosíthatja vagy törölheti őket. Új ütemezéshez vagy eseményindítóhoz hozzon létre inkább egy [munkafolyamatot](https://docs.base44.com/hu/Building-your-app/Creating-workflows.md). Ha olyan `function.jsonc` fájlt telepít, amely új automatizálást ad hozzá, a függvény települ, de az automatizálás nem jön létre.

Az automatizálásokkal a [backend-függvények](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md) automatikusan futhatnak ütemezés szerint, adatbázis-eseményekre reagálva, vagy amikor egy csatlakoztatott integráció webhookeseményt küld. Az automatizálásokkal rendszeres időközönként dolgozhat fel adatokat, kezelheti az entitásváltozásokat, reagálhat külső szolgáltatások eseményeire, vagy egyszeri feladatokat futtathat meghatározott időpontokban.

Minden backend-függvényhez több automatizálás is tartozhat, amelyeket a függvény `function.jsonc` fájljában konfigurál. Ha csak `entry.ts` vagy `entry.js` fájlja van, az automatizálások használatához hozzá kell adnia ezt a konfigurációs fájlt. Az automatizálások [a függvény kódjával együtt, atomikusan települnek](#deploy-automations), amikor a [`deploy`](https://docs.base44.com/developers/references/cli/commands/deploy) vagy a [`functions deploy`](https://docs.base44.com/developers/references/cli/commands/functions-deploy) parancsot futtatja.

> [!WARNING]
>
> A munkafolyamatokat használó alkalmazások nem telepíthetik ezeket az automatizálásokat. Ha az alkalmazásban engedélyezve vannak a munkafolyamatok, az automatizálásokat tartalmazó `function.jsonc` telepítése HTTP 409 hibával meghiúsul. Hozza létre inkább ugyanazt az ütemezést vagy eseményindítót [munkafolyamatokkal](https://docs.base44.com/hu/Building-your-app/Creating-workflows.md), és a függvényt `automations` blokk nélkül telepítse.

## Automatizálástípusok

A Base44 4 automatizálástípust támogat:

* **[Ütemezett automatizálások crontal](#cron)**: Cron-kifejezésekkel pontosan szabályozhatja az ütemezést.
* **[Ütemezett automatizálások egyszerű ütemezéssel](#simple-schedule)**: Ismétlődő feladatok konfigurálása időköz szerint, cron-kifejezések nélkül.
* **[Entitásesemény-automatizálások](#entity-events)**: Függvények indítása adatbázisrekordok létrehozásakor, frissítésekor vagy törlésekor.
* **[Összekötő-automatizálások](#connector-automations)**: Valós idejű reagálás a csatlakoztatott szolgáltatások eseményeire, például egy új Gmail-üzenetre vagy egy Google Drive-fájl módosítására.

## Közös mezők

### Minden automatizálás közös mezői

Minden automatizálástípus a következő mezőket használja:

| Mező | Típus | Kötelező | Leírás |
| - | - | - | - |
| `type` | `string` | Igen | Az automatizálás típusa. Lehetséges értékek: `"scheduled"`, `"entity"` vagy `"connector"`. |
| `name` | `string` | Igen | Az automatizálás egyedi azonosítója. |
| `description` | `string` | Nem | Ember által olvasható leírás. |
| `function_args` | `object` | Nem | Az indításkor a függvénynek átadott argumentumok. Lásd: [Függvényargumentumok](#function-arguments). |
| `is_active` | `boolean` | Nem | Engedélyezve van-e az automatizálás. Alapértelmezett érték: `true`. |

### Az ütemezett automatizálások közös mezői

A cron és az egyszerű ütemezésű automatizálások a következő további mezőket is használják:

| Mező | Típus | Kötelező | Leírás |
| - | - | - | - |
| `schedule_mode` | `string` | Igen | Ismétlődik-e az ütemezés. Lehetséges értékek: `"recurring"` vagy `"one-time"`. |
| `schedule_type` | `string` | Igen | A használt ütemezési módszer. Lehetséges értékek: `"cron"` vagy `"simple"`. |
| `ends_type` | `string` | Nem | Mikor álljon le az ismétlődő ütemezés. Lehetséges értékek: `"never"`, `"on"` vagy `"after"`. Alapértelmezett érték: `"never"`. |
| `ends_on_date` | `string` | Feltételes | Az ismétlődő ütemezés befejezésének dátuma (bezárólag), UTC szerint. Kötelező, ha az `ends_type` értéke `"on"`. Formátum: `YYYY-MM-DDTHH:MM:SSZ`. Például: `"2026-12-31T23:59:59Z"`. |
| `ends_after_count` | `number` | Feltételes | A futtatások száma, amely után az ismétlődő ütemezés leáll. Kötelező, ha az `ends_type` értéke `"after"`. |

## Az automatizálás konfigurálása

Az automatizálásokat a `function.jsonc` fájlban konfigurálja az alábbi megközelítések egyikével. Minden automatizálás a fent felsorolt [közös mezőket](#common-fields-for-all-automations) használja, valamint az adott típusra jellemző mezőket.

### Cron

Használja a [minden automatizálás közös mezőit](#common-fields-for-all-automations) és az [ütemezett automatizálások közös mezőit](#common-fields-for-scheduled-automations), valamint az itt felsorolt cron-specifikus mezőket.

A `type` értékét állítsa `"scheduled"`, a `schedule_type` értékét pedig `"cron"` értékre, hogy cron-kifejezésekkel pontosan szabályozhassa az ütemezést.

A cron-automatizálások a szabványos 5 mezős szintaxist használják: `minute hour day-of-month month day-of-week`. Interaktív cron-kifejezés-szerkesztőt és szintaxisreferenciát a [crontab.guru](https://crontab.guru/) oldalon talál.

| Mező | Típus | Kötelező | Leírás |
| - | - | - | - |
| `cron_expression` | `string` | Igen | 5 mezős cron-kifejezés. |

#### Cron-példa

Ez a példa minden nap éjfélkor (UTC) futtat egy függvényt:

```jsonc theme={null}
{
  "name": "sendDailyReport",
  "entry": "entry.ts",
  "automations": [
    {
      "type": "scheduled",
      "name": "daily_midnight_report",
      "description": "Runs every day at midnight UTC",
      "function_args": { "mode": "full_sync" },
      "is_active": true,

      "schedule_mode": "recurring",
      "schedule_type": "cron",
      "cron_expression": "0 0 * * *"
    }
  ]
}
```

### Egyszerű ütemezés

Használja a [minden automatizálás közös mezőit](#common-fields-for-all-automations) és az [ütemezett automatizálások közös mezőit](#common-fields-for-scheduled-automations), valamint az itt felsorolt egyszerű ütemezési mezőket.

Egyszerű ütemezési igényekhez a `type` értékét állítsa `"scheduled"`, a `schedule_type` értékét pedig `"simple"` értékre.

Ismétlődő feladatokat időköz, például percek, órák, napok, hetek vagy hónapok szerint konfigurálhat, cron-kifejezések írása nélkül.

| Mező | Típus | Kötelező | Leírás |
| - | - | - | - |
| `one_time_date` | `string` | Feltételes | Az egyszeri futtatás dátuma és időpontja, UTC szerint. Kötelező, ha a `schedule_mode` értéke `"one-time"`. Formátum: `YYYY-MM-DDTHH:MM:SSZ`. Például: `"2026-02-15T10:00:00Z"`. |
| `repeat_unit` | `string` | Feltételes | Az ismétlődő automatizálások időegysége. Kötelező, ha a `schedule_mode` értéke `"recurring"`. Lehetséges értékek: `"minutes"`, `"hours"`, `"days"`, `"weeks"` vagy `"months"`. |
| `repeat_interval` | `number` | Feltételes | A futtatások közötti időköz. Kötelező, ha a `repeat_unit` értéke `"minutes"`, `"hours"` vagy `"days"`. |
| `start_time` | `string` | Feltételes | Az automatizálás futásának napi időpontja, UTC szerint. Kötelező, ha a `repeat_unit` értéke `"days"`, `"weeks"` vagy `"months"`. Formátum: `HH:MM`. |
| `repeat_on_days` | `number[]` | Feltételes | A hét napjai, amelyeken az automatizálás fut. Kötelező, ha a `repeat_unit` értéke `"weeks"`. A hét napjainak számaiból álló tömb, ahol a `0` a vasárnap, a `6` a szombat. |
| `repeat_on_day_of_month` | `number` | Feltételes | A hónap napja, amelyen az automatizálás fut. Kötelező, ha a `repeat_unit` értéke `"months"`. Érvényes értékek: `1`-`31`. |

#### Példák egyszerű ütemezésre

Az alábbi példák az automatizálások egyszerű ütemezésének különböző módjait mutatják be:

```jsonc Every 30 minutes theme={null}
{
  "type": "scheduled",
  "name": "every_30_minutes",
  "description": "Runs every 30 minutes.",
  "is_active": true,

  "schedule_mode": "recurring",
  "schedule_type": "simple",
  "repeat_unit": "minutes",
  "repeat_interval": 30
}
```

```jsonc Weekdays at 9am theme={null}
{
  "type": "scheduled",
  "name": "weekday_morning_report",
  "description": "Runs at 9 AM Monday through Friday.",
  "is_active": true,

  "schedule_mode": "recurring",
  "schedule_type": "simple",
  "repeat_unit": "weeks",
  "repeat_interval": 1,
  "start_time": "09:00",
  "repeat_on_days": [1, 2, 3, 4, 5],

  "ends_type": "after",
  "ends_after_count": 52
}
```

```jsonc One-time execution theme={null}
{
  "type": "scheduled",
  "name": "one_time_cleanup",
  "description": "Runs once at a specific date and time.",
  "function_args": { "cleanup": true },
  "is_active": true,

  "schedule_mode": "one-time",
  "schedule_type": "simple",
  "one_time_date": "2026-02-15T10:00:00Z"
}
```

### Entitásesemények

Használja a [minden automatizálás közös mezőit](#common-fields-for-all-automations), valamint az itt felsorolt entitásesemény-mezőket.

A `type` értékét állítsa `"entity"` értékre, hogy a függvények automatikusan elinduljanak adatbázisrekordok létrehozásakor, frissítésekor vagy törlésekor.

Az entitásautomatizálások egy adott entitás 1 vagy több eseménytípusát figyelhetik.

> [!WARNING]
>
> Az entitásautomatizálások csak az [entities API-n](https://docs.base44.com/developers/references/sdk/docs/type-aliases/entities.md) keresztül végzett egyrekordos létrehozási, frissítési és törlési hívásoknál indulnak el. A tömeges műveletek, például a [`bulkUpdate()`](https://docs.base44.com/developers/references/sdk/docs/type-aliases/entities#bulkupdate), és a lekérdezés alapú műveletek, például az [`updateMany()`](https://docs.base44.com/developers/references/sdk/docs/type-aliases/entities#updatemany), nem indítanak entitásautomatizálást, akkor sem, ha az entitás nevének megfelelő rekordokat érintenek. Egy helyreállítható módon törölt rekord visszaállítása vagy végleges törlése sem indít automatizálást. Ha az automatizálásnak minden változásra reagálnia kell, kerülje a tömeges vagy lekérdezés alapú írást az adott entitáson, vagy indítsa el kézzel az automatizálás logikáját.

| Mező | Típus | Kötelező | Leírás |
| - | - | - | - |
| `entity_name` | `string` | Igen | A figyelt entitás neve. |
| `event_types` | `string[]` | Igen | A figyelt adatbázis-események. Lehetséges értékek: `"create"`, `"update"`, `"delete"`. Legalább 1 kötelező. |

#### Példák entitáseseményekre

Az alábbi példák bemutatják, hogyan indíthat függvényeket entitásesemények alapján:

```jsonc All order events theme={null}
{
  "name": "processOrders",
  "entry": "entry.ts",
  "automations": [
    {
      "type": "entity",
      "name": "on_order_changes",
      "description": "Triggered on order create, update, or delete.",
      "function_args": { "notify_slack": true },
      "is_active": true,

      "entity_name": "orders",
      "event_types": ["create", "update", "delete"]
    }
  ]
}
```

```jsonc New records only theme={null}
{
  "type": "entity",
  "name": "on_customer_create",
  "description": "Triggered when a new customer is created.",
  "is_active": true,

  "entity_name": "customers",
  "event_types": ["create"]
}
```

### Összekötő-automatizálások

Használja a [minden automatizálás közös mezőit](#common-fields-for-all-automations), valamint az itt felsorolt összekötő-specifikus mezőket.

A `type` értékét állítsa `"connector"` értékre, hogy a függvények elinduljanak, amikor egy csatlakoztatott integráció webhookeseményt küld. Ezekkel valós időben reagálhat a külső szolgáltatások tevékenységére. Feldolgozhat például egy új e-mailt, szinkronizálhat egy naptárváltozást, vagy reagálhat egy Google Drive-fájl frissítésére.

Opcionálisan [eseményindítási feltételeket](#trigger-conditions) is megadhat az események szűréséhez, így a függvény csak akkor fut, ha a hasznos adat megfelel az Ön által meghatározott szabályoknak.

Amikor egy összekötő-automatizálás elindul, a függvény strukturált [webhook-hasznos adatot](#webhook-payload) kap, amely tartalmazza az eseménytípust, az integráció adatait és a külső szolgáltatástól érkező nyers adatokat.

> [!NOTE]
>
> Az összekötőt a telepítés előtt konfigurálni kell a projektben, és engedélyezni kell. A beállítási útmutatót a [Megosztott összekötők](https://docs.base44.com/hu/developers/backend/resources/connectors/shared-connectors.md) oldalon találja.

| Mező | Típus | Kötelező | Leírás |
| - | - | - | - |
| `integration_type` | `string` | Igen | A figyelt összekötőtípus azonosítója. Az elfogadott értékeket a [támogatott integrációknál](#supported-integrations-and-events) találja. |
| `events` | `string[]` | Igen | Egy vagy több webhookeseménynév, amelyre feliratkozik. Az összekötőnként elérhető eseményeket a [támogatott integrációknál](#supported-integrations-and-events) találja. |
| `resource_id` | `string` | Feltételes | Az automatizálást egy adott erőforrásra szűkíti. A várt formátum az összekötőtől függ. Lásd alább: [Erőforrás-azonosító formátumok](#resource-id-formats). A Google Drive fájlszintű eseményeinél kötelező. Más összekötőknél nem kötelező. |
| `trigger_conditions` | `object` | Nem | Szabályok, amelyeknek a beérkező eseménynek meg kell felelnie, mielőtt a függvény elindul. Ha az esemény nem felel meg, a futtatás kimarad. A teljes referenciát az [Eseményindítási feltételek](#trigger-conditions) részben találja. |

#### Támogatott integrációk és események

| Összekötő | `integration_type` | `events` érték | Leírás |
| - | - | - | - |
| Gmail | `gmail` | `mailbox` | Bármely postafiókváltozás, beleértve az új üzeneteket, a címkefrissítéseket és az olvasottsági állapot változását. |
| Google Calendar | `googlecalendar` | `events` | Bármely naptáresemény-változás, beleértve a létrehozást, a frissítést és a törlést. |
| Google Drive | `googledrive` | `changes` | Bármely változás a meghajtón, beleértve a fájlok hozzáadását, módosítását és törlését. |
| Google Drive | `googledrive` | `file` | Bármely változás egy adott fájlban (`resource_id` szükséges). |
| Google Drive | `googledrive` | `file.update` | A fájl tartalma vagy tulajdonságai megváltoztak (`resource_id` szükséges). |
| Google Drive | `googledrive` | `file.trash` | A fájl a kukába került (`resource_id` szükséges). |
| Google Drive | `googledrive` | `file.untrash` | A fájl visszaállításra került a kukából (`resource_id` szükséges). |
| Google Drive | `googledrive` | `file.delete` | A fájl véglegesen törlődött (`resource_id` szükséges). |
| Microsoft OneDrive | `one_drive` | `updated` | Bármely fájl- vagy mappaváltozás, beleértve a létrehozást, a módosítást és a törlést. |
| Microsoft Outlook | `outlook` | `created` | Új e-mail, naptáresemény vagy névjegy jön létre. |
| Microsoft Outlook | `outlook` | `updated` | Egy e-mail, naptáresemény vagy névjegy frissül. |
| Microsoft Outlook | `outlook` | `deleted` | Egy e-mail, naptáresemény vagy névjegy törlődik. |
| Microsoft SharePoint | `share_point` | `updated` | Egy listaelem vagy dokumentum létrehozásakor, módosításakor vagy törlésekor. |
| Microsoft Teams | `microsoft_teams` | `created` | Új csevegőüzenet közzétételekor. |
| Microsoft Teams | `microsoft_teams` | `updated` | Egy csevegőüzenet frissítésekor. |
| Microsoft Teams | `microsoft_teams` | `deleted` | Egy csevegőüzenet törlésekor. |
| Slack | `slack` | `message` | Amikor üzenet érkezik egy csatornára. |
| Slack | `slack` | `message.im` | Amikor közvetlen üzenet érkezik. |
| Slack | `slack` | `message.groups` | Amikor üzenet érkezik egy privát csatornára. |
| Slack | `slack` | `message.channels` | Amikor üzenet érkezik egy nyilvános csatornára. |
| Slack | `slack` | `message.mpim` | Amikor üzenet érkezik egy többrésztvevős közvetlen beszélgetésbe. |
| Slack | `slack` | `reaction_added` | Amikor reakciót adnak egy üzenethez. |
| Slack | `slack` | `reaction_removed` | Amikor eltávolítanak egy reakciót egy üzenetről. |
| Slack | `slack` | `member_joined_channel` | Amikor egy felhasználó csatlakozik egy csatornához. |
| Slack | `slack` | `member_left_channel` | Amikor egy felhasználó elhagy egy csatornát. |
| Slack | `slack` | `file_shared` | Amikor egy fájlt megosztanak. |
| Slack Bot | `slackbot` | `app_mention` | Amikor a botot @-említéssel megjelölik. |
| Slack Bot | `slackbot` | `message.im` | Amikor közvetlen üzenetet küldenek a botnak. |
| Slack Bot | `slackbot` | `message.mpim` | Amikor üzenetet küldenek egy csoportos közvetlen beszélgetésben, amelyben a bot is részt vesz. |
| Slack Bot | `slackbot` | `message.channels` | Amikor üzenet érkezik egy nyilvános csatornára, amelyben a bot is benne van. |
| Slack Bot | `slackbot` | `message.groups` | Amikor üzenet érkezik egy privát csatornára, amelyben a bot is benne van. |
| Wix | `wix` | `wix.forms.v4.submission_created` | Űrlapbeküldés jött létre egy Wix-webhelyen. |
| Wix | `wix` | `wix.contacts.v4.contact_created` | Névjegy jött létre a Wix CRM-ben. |
| Wix | `wix` | `wix.contacts.v4.contact_updated` | Egy Wix CRM-névjegy frissült. |
| Wix | `wix` | `wix.contacts.v4.contact_deleted` | Egy Wix CRM-névjegy törlődött. |
| Wix | `wix` | `wix.ecom.v1.order_created` | Egy Wix eCommerce-rendelés jött létre. |
| Wix | `wix` | `wix.ecom.v1.order_updated` | Egy Wix eCommerce-rendelés frissült. |
| Wix | `wix` | `wix.ecom.v1.order_canceled` | Egy Wix eCommerce-rendelést töröltek. |
| Wix | `wix` | `wix.ecom.v1.checkout_created` | Egy Wix eCommerce-fizetési folyamat jött létre. |
| Wix | `wix` | `wix.data.v2.data_item_created` | Egy Wix CMS-adatelem jött létre. |
| Wix | `wix` | `wix.data.v2.data_item_updated` | Egy Wix CMS-adatelem frissült. |
| Wix | `wix` | `wix.data.v2.data_item_deleted` | Egy Wix CMS-adatelem törlődött. |

> [!TIP]
>
> A Gmail `mailbox` eseménye bármely postafiókváltozáskor elindul, nem csak új üzeneteknél. Ha csak új e-mailek érkezésekor szeretné futtatni a függvényt, adjon hozzá egy eseményindítási feltételt: `{ "field": "has_new_messages", "operator": "equals", "value": true }`.

> [!NOTE]
>
> A Slack (`slack`) és a Slack Bot (`slackbot`) összekötő-automatizálásokhoz eseményindítási feltételek szükségesek. Ha ezeknél az összekötő-automatizálásoknál nincsenek feltételek megadva, a telepítés meghiúsul.

#### Erőforrás-azonosító formátumok

A `resource_id` várt értéke összekötőnként eltér:

* **Google Drive:** A fájlazonosító. A fájlszintű eseményekhez (`file`, `file.update`, `file.trash`, `file.untrash`, `file.delete`) kötelező.
* **Gmail:** A figyelt címkeazonosítók vesszővel elválasztott listája. Ha elhagyja, alapértelmezés szerint `"INBOX"`.
* **Microsoft Teams:** `{chatId}` egy adott csevegés figyeléséhez.
* **SharePoint:** `{siteId}/{listId}` egy adott lista figyeléséhez.

#### Eseményindítási feltételek

A `trigger_conditions` segítségével szűrheti a webhookeseményeket, így a függvény csak akkor fut, ha a hasznos adat megfelel az Ön által meghatározott szabályoknak. Ha nincsenek feltételek megadva, a függvény minden beérkező eseményre lefut. Teljes konfigurációkat az [Összekötő-automatizálási példák](#connector-automation-examples) részben talál.

**logic** `string`

A feltételek összekapcsolásának módja. Lehetséges értékek: `"and"` (mindegyiknek teljesülnie kell), `"or"` (bármelyiknek teljesülnie kell). Alapértelmezett érték: `"and"`.

**conditions** `array` *required*

Egy vagy több feltételobjektum vagy beágyazott feltételcsoport. Legfeljebb 20 levélfeltétel és 5 beágyazási szint.

**A feltételobjektum mezői**

**field** `string` *required*

Pontokkal elválasztott útvonal a webhook-hasznos adaton belül. A `"status"` például a `payload.data.status`, a `"sender.email"` pedig a `payload.data.sender.email` értéket olvassa.

**operator** `string` *required*

A mezőérték összehasonlításának módja.

**Támogatott operátorok**

| Operátor | Leírás |
| - | - |
| `equals` | A mező értéke pontosan megegyezik a `value` értékkel. |
| `not_equals` | A mező értéke nem egyezik a `value` értékkel. |
| `contains` | A mező értéke részkarakterláncként tartalmazza a `value` értéket. |
| `not_contains` | A mező értéke nem tartalmazza részkarakterláncként a `value` értéket. |
| `starts_with` | A mező értéke a `value` értékkel kezdődik. |
| `ends_with` | A mező értéke a `value` értékkel végződik. |
| `gt` | A mező értéke nagyobb a `value` értéknél. |
| `gte` | A mező értéke nagyobb a `value` értéknél, vagy egyenlő vele. |
| `lt` | A mező értéke kisebb a `value` értéknél. |
| `lte` | A mező értéke kisebb a `value` értéknél, vagy egyenlő vele. |
| `in_list` | A mező értéke a `value` (tömb) egyik eleme. |
| `not_in_list` | A mező értéke nem eleme a `value` (tömb) értéknek. |
| `exists` | A mező létezik, és nem null. Nincs szükség `value` értékre. |
| `not_exists` | A mező null vagy hiányzik. Nincs szükség `value` értékre. |
| `is_empty` | A mező null, üres karakterlánc, üres tömb vagy üres objektum. Nincs szükség `value` értékre. |
| `is_not_empty` | A mező nem null, nem üres karakterlánc, nem üres tömb és nem üres objektum. Nincs szükség `value` értékre. |

**value** `any`

Az összehasonlítás alapjául szolgáló érték. Az `exists`, a `not_exists`, az `is_empty` és az `is_not_empty` operátornál nem szükséges.

#### Webhook-hasznos adat

Amikor egy összekötő-automatizálás elindítja a függvényt, a kérés törzse egy `payload` objektumot tartalmaz a következő szerkezettel. A hasznos adatot olvasó függvényt az [Összekötő-automatizálási példák](#connector-automation-examples) részben talál.

| Mező | Típus | Leírás |
| - | - | - |
| `payload.automation.id` | `string` | A futtatást elindító automatizálás azonosítója. |
| `payload.automation.name` | `string` | Az automatizálás neve. |
| `payload.automation.type` | `string` | Mindig `"connector"`. |
| `payload.event.type` | `string` | A webhookesemény neve. Például: `"mailbox"`, `"events"` vagy `"changes"`. |
| `payload.event.integration_type` | `string` | Az összekötő típusa. Például: `"gmail"` vagy `"googlecalendar"`. |
| `payload.event.provider_identifier` | `string` | Az útválasztáshoz használt szolgáltatói fiókazonosító. |
| `payload.data` | `object` | A külső szolgáltatástól érkező nyers webhook-hasznos adat. `null` értékű, ha a `payload_too_large` értéke `true`. |
| `payload.payload_too_large` | `boolean` | `true`, ha a webhook-hasznos adat meghaladta a \~200 KB-ot, és a `data` értéke `null`. |

#### Összekötő-automatizálási példák

```jsonc Basic connector automation theme={null}
// Triggers the function whenever a new email arrives in Gmail.

{
  "name": "processInboundEmails",
  "entry": "entry.ts",
  "automations": [
    {
      "type": "connector",
      "name": "on_new_gmail",
      "description": "Runs when a new email arrives in Gmail.",
      "is_active": true,

      "integration_type": "gmail",
      "events": ["mailbox"]
    }
  ]
}
```

```jsonc Single trigger condition theme={null}
// Triggers only when a Google Calendar event has status "cancelled".

{
  "type": "connector",
  "name": "on_event_cancelled",
  "description": "Runs only when a Google Calendar event is cancelled.",
  "is_active": true,

  "integration_type": "googlecalendar",
  "events": ["events"],
  "trigger_conditions": {
    "logic": "and",
    "conditions": [
      { "field": "status", "operator": "equals", "value": "cancelled" }
    ]
  }
}
```

```jsonc Nested trigger conditions theme={null}
// Triggers only for Gmail messages that are both in the inbox and unread.

{
  "type": "connector",
  "name": "on_unread_inbox_email",
  "description": "Runs only for unread emails in the inbox.",
  "is_active": true,

  "integration_type": "gmail",
  "events": ["mailbox"],
  "trigger_conditions": {
    "logic": "and",
    "conditions": [
      { "field": "labelIds", "operator": "contains", "value": "INBOX" },
      { "field": "labelIds", "operator": "contains", "value": "UNREAD" }
    ]
  }
}
```

```typescript Reading the payload theme={null}
// Reads the structured payload from the request body.

Deno.serve(async (req) => {
  const body = await req.json();
  const { payload } = body;

  const eventType = payload.event.type;            
  const integration = payload.event.integration_type; 

  if (payload.payload_too_large) {
    console.warn("Webhook payload was too large and was not included.");
    return Response.json({ ok: false, reason: "payload_too_large" });
  }

  const data = payload.data; 
  
  // Your function logic
  console.log(`Received ${eventType} event from ${integration}`, data);

  return Response.json({ ok: true });
});
```

### Függvényargumentumok

Az automatizálás konfigurációjában a `function_args` mező megadásával adatokat adhat át a függvénynek az indításkor. Ez akkor hasznos, ha egy függvény több, eltérően viselkedő automatizálást kezel, például egy szinkronizáló függvény, amely 15 percenként növekményesen, naponta pedig teljes szinkronizálással fut.

Ezeket az argumentumokat a függvény kódjában a kérés törzsén keresztül érheti el.

#### Példa függvényargumentumokra

Ez a példa egy olyan függvényt mutat be, amely az automatizálás konfigurációja alapján növekményes és teljes szinkronizálási módot is kezel:

```typescript Function code theme={null}
Deno.serve(async (req) => {
  const body = await req.json();
  const args = body.args ?? {};

  // Use the arguments from automation config
  const mode = args.mode ?? "incremental";

  // Your function logic
});
```

```jsonc Automation config theme={null}
{
  "name": "syncData",
  "entry": "entry.ts",
  "automations": [
    {
      "type": "scheduled",
      "name": "incremental_sync",
      "description": "Runs every 15 minutes with incremental mode.",
      "function_args": { "mode": "incremental" },
      "is_active": true,
      "schedule_mode": "recurring",
      "schedule_type": "simple",
      "repeat_unit": "minutes",
      "repeat_interval": 15
    },
    {
      "type": "scheduled",
      "name": "full_sync",
      "description": "Runs daily at midnight with full sync mode.",
      "function_args": { "mode": "full" },
      "is_active": true,
      "schedule_mode": "recurring",
      "schedule_type": "cron",
      "cron_expression": "0 0 * * *"
    }
  ]
}
```

## Automatizálások telepítése

A backend-függvényeket automatizálásaikkal együtt a CLI [`functions deploy`](https://docs.base44.com/developers/references/cli/commands/functions-deploy) parancsával vagy az egységes [`deploy`](https://docs.base44.com/developers/references/cli/commands/deploy) paranccsal telepítheti. A `functions deploy <names...>` paranccsal név szerint telepíthet konkrét függvényeket.

A telepítés függvényenként atomikus. Egy függvény csak akkor számít telepítettnek, ha a Deno-telepítés és az összes automatizálása is sikeres. Ha bármelyik automatizálás telepítése meghiúsul, a teljes függvénytelepítés visszagörgetésre kerül.

A telepítés után a CLI függvényenként mutatja az állapotot: deployed, unchanged vagy error.

## Automatizálások kezelése az irányítópulton

> [!WARNING]
>
> Az irányítópulton végzett módosításokat a [`functions deploy`](https://docs.base44.com/developers/references/cli/commands/functions-deploy) következő futtatása felülírja. Az irányítópult és a helyi fájlok között nincs kétirányú szinkronizálás. A helyi `function.jsonc` fájlokban definiált automatizálások az irányadók.
>
> Ha módosítani szeretné az automatizálásokat, frissítse a helyi `function.jsonc` fájlokat, és telepítse újra őket. Az irányítópultot a futtatási naplók figyelésére és az automatizálások szükség szerinti kézi indítására használja.

Az automatizálásokat a Base44 irányítópultján, az **Automations** lapon tekintheti meg és kezelheti. Az irányítópulton a következőket teheti:

* Megtekintheti a futtatási naplókat és előzményeket
* Tesztelés céljából kézzel futtathatja az automatizálásokat
* Figyelheti az automatizálások állapotát

## Lásd még

* [Backend-függvények](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md): Ismerje meg a backend-függvényeket
* [`functions deploy`](https://docs.base44.com/developers/references/cli/commands/functions-deploy): Függvények telepítése automatizálásokkal
* [`deploy`](https://docs.base44.com/developers/references/cli/commands/deploy): Az összes erőforrás egyszerre történő telepítése
* [`logs`](https://docs.base44.com/developers/references/cli/commands/logs): Függvénynaplók megtekintése

> [!NOTE]
>
> Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az [angol nyelvű változatot](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.