# OptiMonk kampányok integrálása Postscript-tel

Canonical URL: https://support.optimonk.com/hu/articles/integrating-optimonk-campaigns-with-postscript

[Postscript](https://help.postscript.io/hc/en-us/articles/1260804632590-Set-Up-Your-OptiMonk-Integration#Locate-Your-Postscript-Legacy-API-Key) egy SMS-marketing eszköz Shopify áruházak számára. Kapcsold össze egy OptiMonk kampánnyal, és a popupod által összegyűjtött minden telefonszám automatikusan növeli a Postscript feliratkozói listádat.

**Mielőtt elkezdenéd:**

- A Postscript-nek telepítve kell lennie a Shopify áruházadban.

- A kampányod popupának el kell készülnie **és telefonszámot kell gyűjtenie** — a mezőhozzárendelés a popupod beviteli mezőiből olvasódik ki, így telefonmező nélkül nincs mit elküldeni. Ha a felugró ablakodnak még nincs ilyen mezője, kérd meg az ügynököt a design chatben (*„adj hozzá egy telefonszám mezőt”*) és hagyd, hogy a popup újraépüljön.

---

## 1. lépés – Másold ki a Postscript Legacy API kulcsodat

1. Jelentkezz be a Postscript fiókodba.

2. Kattints a weboldalad nevére, majd válaszd ki az **API**.

3. Másold ki a **Legacy API Key (régi API kulcs) melletti karaktereket.**.

Hagyd nyitva a lapot – azt is tudnod kell, melyik **Keyword (kulcsszó)** alá kerüljenek az új feliratkozóid. A kulcsszavaidat a Postscript-ben itt találod: **Acquisition (Beszerzés)**.

---

## 2. lépés – Kapcsold össze a Postscript-et a kampányoddal

1. Nyisd meg a **Kampányok** menüpontot a bal oldali menüben, majd kattints arra a kampányra, amelyet a Postscript-tel szeretnél összekapcsolni.

2. Nyisd meg az **Integrációk** fület a kampányon.

3. Kattints az **Integráció hozzáadása** gombra. Ha ez az első integrációd, ugyanez a lépés *Kösd össze az email vagy SMS eszközöddel* néven jelenik meg.

4. **Szolgáltató** lépésben: válaszd ki a **Postscript**-t. Ha a lista hosszú, írj a *Szolgáltató keresése…* mezőbe. A már összekapcsolt fiókok felül jelennek meg, a *Csatlakoztatott fiókjaid*.

5. **Fiók** lépésben: kattints az **Új fiók csatlakoztatása** gombra, illeszd be a Legacy API kulcsot a hitelesítő adatok mezőjébe, és adj a kapcsolatnak egy **Név (opcionális)** nevet, ha később szeretnéd felismerni. Kattints a **Csatlakoztatás** gombra.

Ha a kulcs hibás, a varázsló mentés helyett ezt jelzi: *Sikertelen kapcsolódás — ellenőrizd a hitelesítő adatokat*.

6. **Lista** lépésben: válaszd ki, hova kerüljenek az új feliratkozók a Postscript-ben, majd kattints a **Folytatás** gombra. Használd a *Lista keresése…* mezőt, ha sok bejegyzésed van.

7. **Mezők összerendelése** lépésben: rendeld hozzá a popup **Telefonszám** mezőjét a Postscript telefon mezőjéhez – a Postscript-ben ez az azonosító általában `phone`. Amit nem szeretnél továbbítani, az a **Ne szinkronizálja** beállításon marad. Kattints az **Integráció mentése** gombra.

Ez az! Ezután mindenki, aki telefonszámot ad meg a felugró ablakodon keresztül, Postscript feliratkozóvá válik.

> **Vázlat vs. élő:** ha a kampány még nincs publikálva, az integráció egy **Vázlat** jelölést és a következő megjegyzést jeleníti meg: *Piszkozatként mentve — a kampány publikálásakor lép élesbe.* Egy publikált kampányon azonnal érvénybe lép, és **Aktív státuszként jelenik meg.**.

---

## Mezők összerendelése

A hozzárendelési táblázatnak két oszlopa van: **Popup mező** balra (minden beviteli mező, amit a popupod összegyűjt), és **Postscript mezője** jobbra. Az OptiMonk előre kitölti a hozzárendelést saját javaslataival, így legtöbbször csak ellenőrizned kell.

- A **telefonszám** sor a legfontosabb – ez teszi valakit feliratkozóvá.

- Válaszd a **Ne szinkronizálja** lehetőséget minden olyan felugróablak-mezőnél, amelyet nem szeretnél elküldeni.

- Ha a Postscript nem ad vissza kiválasztható mezőlistát, a jobb oldal egy szövegmező, és a varázsló megmondja, mit kell tenned: *Írd be a pontos Postscript mező- vagy tulajdonságnevet (pl. first_name). Hagyd üresen, ha ki akarsz hagyni egy mezőt.* Írd be `phone` ott.

---

## Az integráció módosítása vagy eltávolítása

Az Integrations fül felsorolja a kampányon található összes integrációt.

- **Lista módosítása** újra megnyitja a varázslót, így választhatsz másik célt, vagy újra elvégezheted a hozzárendelést.

- **Eltávolítás** eltávolítja az integrációt ebből a kampányból: *Eltávolítod ebből a kampányból? A fiók-kapcsolat megmarad, és később újra hozzáadható.* A Postscript kulcsod nem törlődik, így a kapcsolatot egy másik kampányon is felhasználhatod.

---

## Ellenőrizd, hogy a leadek valóban megérkeznek

Nyisd meg a **Közönség** menüpontot a bal oldali menüben. Minden beküldésnek van egy **Szinkron állapot** oszlopa:

- **Szinkronizálva** – a feliratkozó megérkezett a Postscript-hez.

- **Integrációs hiba** – a továbbítás sikertelen volt. Kattints a sorra, hogy lásd az okot (*Hibás API kulcs*, *Érvénytelen lista*, *Mezőmegfeleltetési hiba*, *Érvénytelen telefonszám*, *Már leiratkozott*…), majd kattints az **Újrapróbálkozás** gombra, miután javítottad a beállításokat.