# Integrációk

> Az Integrációk menüben kötöd össze az Echót a saját rendszereiddel.

Az **Integrációk** menüben kötöd össze az Echót a saját rendszereiddel: egy API-tokennel a webshopod vagy a CRM-ed felveheti és frissítheti a feliratkozókat, a webhookok pedig azonnal szólnak a rendszereidnek, ha valami történik az Echóban.

## Az Integrációk oldal

Nyisd meg a bal oldali menüben az **Integrációk** pontot. Az oldalon két kártya van: **API** és **Webhookok**. A kártyán a **Használat** gombra kattintva nyílik meg.

![Az Integrációk oldal az API és a Webhookok kártyával](https://docs.uptools.io/_astro/07-integrations-overview.PFLByT7X_Z1X6XTy.webp)

> **Jó tudni**
>
> - Tokent és webhookot az Adminisztrátor és a Menedzser szerepkörű felhasználók hozhatnak létre. A többi szerepkör legfeljebb a listákat látja, vagy az oldal jelzi, hogy nincs hozzá jogosultsága.
> - A technikai részleteket (kérések, válaszok, az aláírás ellenőrzése) a [fejlesztői útmutató](https://docs.uptools.io/hu/echo/developer-guide/) írja le. Ez a fejezet arról szól, mit csinálsz a felületen.

## Hogyan hozz létre API-tokent?

Az API-token egy kulcs, amellyel a saját rendszered eléri az Echo-fiókodat. Minden rendszernek külön tokent adj, így egyet visszavonhatsz anélkül, hogy a többihez hozzányúlnál.

1. Nyisd meg az **Integrációk** menüt, és az **API** kártyán kattints a **Használat** gombra.
2. Kattints az **Új token létrehozása** gombra.

   ![Az API oldal az Új token létrehozása gombbal](https://docs.uptools.io/_astro/07-integrations-api.C_LI5pe1_Z1I5rUw.webp)

3. A **Token neve** mezőbe írd be, mire használod, például a webshopod nevét.
4. A **Hozzáférés** résznél válaszd a **Csak olvasás** vagy a **Teljes hozzáférés** lehetőséget.
5. Ha az Echót hívó rendszer mindig ugyanarról az IP-címről érkezik, írd be az **Engedélyezett IP-címek** mezőbe, soronként egy címet vagy tartományt. Üresen hagyva bármely címről használható.
6. Kattints a **Token létrehozása** gombra.

   ![Az Új token létrehozása ablak kitöltve](https://docs.uptools.io/_astro/07-integrations-token-new.DzgmkHb5_ZOCnJv.webp)

7. A **Másolás** gombbal másold ki a tokent, és illeszd be a rendszered beállításaiba, majd kattints a **Kész** gombra.

   ![Az új API-token, amelyet csak egyszer látsz](https://docs.uptools.io/_astro/07-integrations-token-created.CESLwY-g_15mRmn.webp)

| Hozzáférés | Mit tud a token |
|---|---|
| **Csak olvasás** | Olvassa a feliratkozókat, csoportokat, szegmenseket, mezőket, kampányokat, automatizálásokat és webhookokat. |
| **Teljes hozzáférés** | Ezeket fel is veszi, módosítja és törli. |

> **Jó tudni**
>
> - A tokent az Echo csak egyszer mutatja meg. Ha elveszett, hozz létre újat, a régit pedig vond vissza.
> - A token a létrehozója mindenkori szerepkörével dolgozik: nem tud többet, mint aki létrehozta. Ha a létrehozó kikerül a munkaterületről, a token nem működik tovább, és a lista **Inaktív** jelzéssel mutatja.
> - Egy munkaterületnek legfeljebb 50 aktív tokenje lehet, egy tokenhez legfeljebb 20 IP-cím vagy tartomány tartozhat.
> - Egy token percenként 120 kérést és percenként 5 importot küldhet.

## Hogyan szerkeszd vagy vond vissza az API-tokent?

1. Nyisd meg az **Integrációk** menüben az **API** oldalt.
2. Keresd meg a tokent az **API-tokenek** listában. A lista mutatja a token elejét, a **Hozzáférés** szintjét, az engedélyezett **IP-címek** listáját, hogy mikor használták utoljára (**Utoljára használva**), és ki hozta létre.
3. A név vagy az IP-címek módosításához kattints a **Szerkesztés** gombra, írd át őket, majd kattints a **Változások mentése** gombra. A hozzáférés nem módosítható: más hozzáféréshez hozz létre új tokent.
4. Visszavonáshoz kattints a **Visszavonás** gombra, majd a megerősítő ablakban ismét a **Visszavonás** gombra.

![A visszavonás megerősítő ablaka](https://docs.uptools.io/_astro/07-integrations-token-revoke.BO9CeSc-_Z1XVm85.webp)

A visszavont tokennel küldött kérések azonnal leállnak. A visszavonás nem vonható vissza.

## Hogyan találd meg, amire a fejlesztődnek szüksége van?

Az **API** oldal **Dokumentáció** doboza mindent tartalmaz, amivel egy fejlesztő elindulhat:

- **Base URL**: erre a címre mennek a kérések. A **Másolás** gombbal kimásolhatod.
- **Fejlécek**: a fejlécek, amelyek minden kéréshez kellenek.
- **Sebességkorlát**: hány kérést küldhet egy token percenként.
- **OpenAPI-dokumentum**: a teljes technikai leírás letölthető fájlként.

A tokenlista alatt a **Csoportazonosítók** doboz minden csoport azonosítóját mutatja. Az API ezeket kéri, amikor egy feliratkozót csoportba kell tenni. A **Csoportok keresése** mezővel megtalálod a csoportot, az azonosítóját pedig a **Másolás** gombbal viheted át.

![A Csoportazonosítók doboz](https://docs.uptools.io/_astro/07-integrations-group-ids.COMyTB4X_nPRuG.webp)

## Hogyan állíts be webhookot?

A webhook egy üzenetet (HTTP POST-kérést) küld az általad megadott címre, valahányszor a kiválasztott események történnek, például amikor valaki feliratkozik vagy leiratkozik.

1. Nyisd meg az **Integrációk** menüt, és a **Webhookok** kártyán kattints a **Használat** gombra.
2. Kattints a **Webhook létrehozása** gombra.

   ![A Webhookok oldal](https://docs.uptools.io/_astro/07-integrations-webhooks.B_wklBW__Z1zE8dD.webp)

3. A **Név** mezőbe írd be, mire szolgál a webhook.
4. A **Végpont URL-je** mezőbe írd be annak a rendszernek a címét, amely az üzeneteket fogadja. Ezt a fejlesztődtől kapod meg.
5. Az **Események** résznél jelöld be, mely eseményekről kérsz üzenetet. A **Feliratkozó**, az **Automatizálás** és a **Kampány** csoportban találod őket.
6. Ha a rendszered egy üzenetben több eseményt is fel tud dolgozni, jelöld be az **Események kötegelése** lehetőséget. Ilyenkor egy üzenetben legfeljebb 100 esemény érkezik.
7. Kattints a **Webhook létrehozása** gombra.

   ![A Webhook létrehozása ablak három bejelölt eseménnyel](https://docs.uptools.io/_astro/07-integrations-webhook-new.BHHgv8xT_18wroM.webp)

8. Az Echo megmutatja a webhook **Aláírókulcs** értékét. A **Másolás** gombbal másold ki, add át a fejlesztődnek, majd kattints a **Kész** gombra.

Az aláírókulccsal a rendszered ellenőrizni tudja, hogy minden üzenet valóban az Echótól jön. Az API-tokenhez hasonlóan ezt is csak egyszer látod.

> **Jó tudni**
>
> - A cím http:// vagy https:// kezdetű legyen, és a 80-as, a 443-as vagy egy 1024 fölötti portot használja. Üzenet csak nyilvános internetes címre megy, átirányítást az Echo nem követ.
> - Egy munkaterületnek legfeljebb 20 webhookja lehet.
> - A **Feliratkozó törölve**, a **Kampány megnyitva** és a **Kampány linkjére kattintottak** esemény csak kötegelve küldhető. Ha valamelyiket bejelölöd, az **Események kötegelése** bekapcsol, és bekapcsolva marad.

## A webhookesemények

| Esemény | Mikor megy üzenet |
|---|---|
| **Feliratkozó létrehozva** | Új feliratkozó kerül a listádra bármilyen módon: kézzel, importtal, API-val vagy feliratkozással. |
| **Feliratkozó módosítva** | Megváltozik a feliratkozó e-mail-címe vagy valamelyik mezőjének értéke. |
| **Feliratkozó aktív lett** | A feliratkozó állapota aktívra vált, például miután megerősítette a feliratkozást. |
| **Feliratkozó leiratkozott** | A feliratkozó leiratkozik, vagy leiratkoztatják. |
| **Feliratkozó visszapattant** | A feliratkozó állapota visszapattantra vált. |
| **Feliratkozó spamnek jelölte** | A feliratkozó spamnek jelöli a leveledet. |
| **Feliratkozó törölve** | A feliratkozót törlik vagy elfelejtik. GDPR szerinti törlés után az üzenetben csak a feliratkozó azonosítója szerepel. |
| **Feliratkozó csoporthoz adva** | A feliratkozó bekerül egy csoportba. |
| **Feliratkozó csoportból eltávolítva** | A feliratkozót kiveszik egy csoportból. A csoport vagy a feliratkozó törlése nem küld ilyet. |
| **Automatizálás elindult** | A feliratkozó belép egy automatizálásba. |
| **Automatizálás befejeződött** | A feliratkozó végigér egy automatizáláson. |
| **Kampány kiküldve** | Egy kampány kiküldése befejeződik. |
| **Kampány megnyitva** | Egy címzett megnyitja a kampánylevelet. Minden megnyitásról megy üzenet, és benne van, hogy ez volt-e az első. |
| **Kampány linkjére kattintottak** | Egy címzett a kampánylevél egyik linkjére kattint. |

A kampányesemények csak a kampányokra vonatkoznak. Az automatizálások leveleiről nem megy **Kampány kiküldve**, **Kampány megnyitva** vagy **Kampány linkjére kattintottak** üzenet.

## Hogyan ellenőrizd a webhook kézbesítéseit?

1. A **Webhookok** oldalon kattints a webhook nevére.
2. Az **Adatok** doboz mutatja a címet, az eseményeket, a kötegelést és azt, hogy a webhook be van-e kapcsolva.
3. Alatta a **Kézbesítések** lista a legújabb üzenetekkel kezdődik: látod az állapotukat, a bennük lévő eseményeket, a kísérletek számát és a HTTP-kódot, amellyel a rendszered válaszolt. Az **Állapot** listával szűrhetsz, a **Frissítés** gombbal betöltheted a legújabbakat.

![Egy webhook oldala az Adatok dobozzal és a Kézbesítések listával](https://docs.uptools.io/_astro/07-integrations-webhook-detail.C6OqBX6n_1QxPDh.webp)

| Állapot | Mit jelent |
|---|---|
| **Folyamatban** | Az üzenet úton van, vagy az Echo hamarosan újra megpróbálja. |
| **Kézbesítve** | A rendszered 10 másodpercen belül 2xx kóddal válaszolt. |
| **Sikertelen** | Minden kísérlet sikertelen volt, vagy a cím nem érhető el (például nem nyilvános cím). |

**Egy kézbesítés megnyitása**

Kattints a sorban a **Megtekintés** gombra. Az ablakban látod a kézbesítés-azonosítót, a kísérleteket, a HTTP-kódot, az üzenet tartalmát (**Payload**) és a rendszered válaszának elejét (**Válasz**). Ha a hiba nálatok volt, és már kijavítottátok, az **Újraküldés** gombbal újra elküldheted az üzenetet. Az újraküldés új kézbesítésként, saját kézbesítés-azonosítóval kerül a listába, így az a rendszer is feldolgozza, amelyik az azonosító alapján szűri ki az ismétlődést. Az eredeti kézbesítés változatlanul megmarad.

![A Kézbesítés ablak](https://docs.uptools.io/_astro/07-integrations-delivery.D92UZDGz_Z1SynMc.webp)

> **Jó tudni**
>
> - Ha egy üzenet nem ér célba, az Echo 10, 100 és 1000 másodperc múlva újra megpróbálja. A negyedik sikertelen kísérlet után a kézbesítés **Sikertelen** lesz.
> - A webhook oldalán a **Teszt küldése** gomb mintaüzenetet küld a webhook első eseményével. A listában **Teszt** jelzést kap. Kikapcsolt webhooknál a gomb nem kattintható, alatta a **Kapcsold be a webhookot, hogy tesztet küldhess.** üzenet áll.
> - A lista 30 napig őrzi a kézbesítéseket.
> - A **Megtekintés** gomb feliratkozói adatokat mutat, ezért csak azoknak jelenik meg, akik a feliratkozókat is láthatják.

## Hogyan kapcsold ki, módosítsd vagy töröld a webhookot?

- **Ki- és bekapcsolás:** a **Webhookok** oldalon a **Bekapcsolva** oszlop kapcsolójával. Amíg a webhook ki van kapcsolva, az Echo nem gyűjt neki eseményt, és ezeket később sem küldi el. Kikapcsoláskor a még várakozó üzenetek is sikertelenek lesznek.
- **Módosítás:** a webhook oldalán kattints a **Szerkesztés** gombra, írd át a nevet, a címet, az eseményeket vagy a kötegelést, majd kattints a **Változások mentése** gombra.
- **Új aláírókulcs:** kattints a **Kulcs forgatása** gombra, és erősítsd meg. A régi kulcs azonnal érvényét veszti, ezért az újat rögtön add át a fejlesztődnek.
- **Törlés:** kattints a **Törlés** gombra, és erősítsd meg. A webhook és a kézbesítési listája törlődik, ez nem vonható vissza.

## A workflow-kulcs

Az automatizálások is hívhatják a rendszeredet egy webhook-lépéssel. Ezeket a kéréseket a munkaterület egy közös kulcsa írja alá, a **Workflow-kulcs**, amelyet a **Webhookok** oldal alján találsz.

1. Kattints a **Kulcs megjelenítése** gombra.
2. A **Másolás** gombbal másold ki a kulcsot, és add át a fejlesztődnek.
3. Ha a kulcs illetéktelen kézbe került, kattints a **Kulcs forgatása** gombra, és erősítsd meg. A régi kulcs minden workflow webhook-lépésnél azonnal érvényét veszti.

A kulcsot csak a beállításokat kezelő felhasználók láthatják és forgathatják. Az automatizálások lépéseiről az [Automatizálás](https://docs.uptools.io/hu/echo/user-guide/automations/) fejezet szól.

## Hogyan importálj feliratkozókat API-val?

1. Nyisd meg a **Feliratkozók** menüt, és kattints a **Feliratkozók hozzáadása** gombra.
2. Válaszd az **Importálás API-val** fület.
3. Kattints a **Dokumentáció megnyitása** gombra. Ez az **Integrációk** menü **API** oldalára visz.

![Az Importálás API-val fül](https://docs.uptools.io/_astro/07-integrations-import-api.Cy3nnGQ2_4H5zV.webp)

Egy API-tokennel a rendszered egyesével is felvehet feliratkozókat (például a webshop pénztáránál), vagy egy kéréssel egész listát importálhat egy csoportba. Az API-n át importált lista ugyanúgy fut, mint a fájlimport, és az eredményszámokkal együtt megjelenik a **Feliratkozók** menü **Előzmények** fülén.

> **Jó tudni**
>
> - Egy API-s importban legfeljebb 50 000 feliratkozó lehet.
> - Az egyesével felvett feliratkozók megerősítetlenként indulnak, és megkapják a megerősítő levelet, ha az API-s feliratkozásokra be van kapcsolva a dupla megerősítés. A beállításról a [Beállítások](https://docs.uptools.io/hu/echo/user-guide/settings/) fejezet szól.

## Gyakori kérdések

**A fejlesztőnk elment a cégtől. Mi lesz az általa létrehozott tokenekkel?**
Amint a felhasználóját eltávolítjátok a munkaterületről, a tokenjei leállnak, és a lista **Inaktív** jelzéssel mutatja őket. Hozz létre új tokeneket a saját felhasználóddal, és cseréld le őket a rendszereitekben.

**A rendszerünk szerint nem működik az API-token. Mit nézzek meg?**
Az **Integrációk** menü **API** oldalán nézd meg, hogy a token szerepel-e még a listában, és nem **Inaktív**-e. Ha megadtál **Engedélyezett IP-címek** listát, a kérésnek ezek valamelyikéről kell érkeznie. Ha a token így sem működik, hozz létre újat.

**Nem érkezett meg hozzánk egy webhooküzenet. Hol látom, miért?**
Nyisd meg a webhookot a **Webhookok** oldalon, és nézd meg a **Kézbesítések** listát. A HTTP-kód és a **Megtekintés** ablakban a **Válasz** megmutatja, mit felelt a rendszeretek. Ellenőrizd azt is, hogy a webhook be van-e kapcsolva: kikapcsolt állapotban az Echo nem gyűjt eseményt.

**Hogyan kerülnek az Echóba a weboldalam űrlapján feliratkozók?**
A weboldalad űrlapja az API-n át küldheti be a feliratkozókat. A fejlesztődnek egy **Teljes hozzáférés** szintű API-token és az **API** oldal adatai kellenek hozzá.

**Látom, ki módosított egy tokent vagy webhookot, vagy mit csinált egy token?**
Igen, a **Fiókbeállítások** felhasználói oldalán, a **Tevékenységnapló** fülön. A **Típus** listában válaszd az **Integrációk** lehetőséget a tokenek és webhookok változásaihoz. Az API-n át végzett műveleteknél a **Ki** oszlopban a token neve áll. A naplóról az [Első lépések](https://docs.uptools.io/hu/echo/user-guide/getting-started/#a-tevékenységnapló) fejezet szól.