Ugrás a fő tartalomra

Mailjet - RESnWEB integráció

Írta: Dorottya Komendánt-Bors

A RESnWEB összeköthető a Mailjet hírlevélküldő rendszerrel is. Az integrációnak köszönhetően azoknak a vendégeknek az adatai, akik a RESnWEB valamely felületén hozzájárulnak a hírlevélküldéshez, automatikusan átadhatók a Mailjet rendszerébe.

A szolgáltatás 5.000 Ft + ÁFA havidíjért vehető igénybe, az integráció díjazásáról szerződésükből tudnak tájékozódni.

A szolgáltatással kapcsolatban bővebben a https://www.mailjet.com/ oldalon lehet tájékozódni.

RESnWEB – Mailjet kapcsolat kialakítása

A rendszerek összekapcsolását ügyfélszolgálatunk végzi el. A kapcsolat kialakításához szükséges információkat az info@resnweb.com e-mail-címre várjuk.

A kapcsolat kialakításának előfeltétele

A RESnWEB Hoteladatok / Alapadatok menüpontjában, a Hírlevél feliratkoztatás szekcióban a Hírlevél kérés aktiválva van opciót szükséges kiválasztani.

Ennek a beállításnak a hatására jelenik meg a RESnWEB megfelelő felületein a hírlevélre történő feliratkozás lehetősége.

A kapcsolat kialakításához az alábbi információkra van szükségünk:

A szükséges adatok birtokában elvégezzük a két rendszer összekapcsolását.

A kapcsolat teszteléséhez tesztfoglalásokat / tesztfeliratkozásokat is létrehozhatunk, amelyeket később törlünk vagy lemondunk. A sikeres összekapcsolást követően kérjük, ellenőrizzék a Mailjet felületén, hogy a tesztfeliratkozó bekerült-e a megfelelő Contact Listre, illetve a hozzá tartozó adatok a megfelelő mezőkben jelentek-e meg.

API Key és Secret Key kinyerése a Mailjetből

A RESnWEB és a Mailjet közötti kommunikációhoz egy API Key és Secret Key párosra van szükség.

  1. Lépjünk be a Mailjet felületére.

  2. Nyissuk meg az API / API Key Management menüpontot. A Mailjet felületének verziójától függően ez az Account settings / API Key Management útvonalon is elérhető lehet.

  3. A felületen megjelenik a fiókhoz tartozó API Key.

  4. Másoljuk ki az API Key értékét.

  5. A kapcsolathoz a hozzá tartozó Secret Keyre is szükség lesz.

FONTOS! A Mailjet a Secret Key értékét biztonsági okokból csak annak létrehozásakor jeleníti meg. Ha a Secret Key korábban nem került elmentésre, új Secret Key generálása szükséges az API Key mellett található beállításoknál.

Új Secret Key létrehozásakor a korábbi kulcs érvényét veszti, ezért az új kulcsot minden olyan rendszerben frissíteni kell, amely az adott Mailjet-fiókhoz API-n keresztül kapcsolódik.

Hírlevélküldő lista létrehozása

A Mailjet a feliratkozókat Contact Listekbe lehet rendezni.

Amennyiben még nincs létrehozva a RESnWEB feliratkozói számára használni kívánt lista:

  1. Lépjünk be a Mailjet felületére.

  2. Válasszuk a Contacts / Contact Lists menüpontot.

  3. Kattintsunk a Create a contact list gombra.

  4. Adjunk a listának egy egyértelmű nevet, például: RESnWEB Hírlevél

  5. A lista létrehozható üresen is, nem szükséges előzetesen kontaktokat feltölteni rá.

A Mailjetben egy fiókon belül több Contact List is létrehozható. A RESnWEB-integráció beállításakor ezért fontos egyértelműen jelezni, melyik listára szeretnék a RESnWEB feliratkozóit továbbítani.

Contact Properties – mezők létrehozása

Az email címen kívüli vendégadatokat a Mailjet Contact Properties mezőkben tárolja.

Ilyen adat lehet például:

  • keresztnév

  • vezetéknév

  • település

  • érkezés dátuma

  • távozás dátuma

  • foglalás összege

  • nyelv

  • törzsvendégszint

  • szálláshely neve

A szükséges mezőket az integráció kialakítása előtt célszerű létrehozni.

Új Contact Property létrehozása

  1. A Mailjet főmenüjében válasszuk a Contacts / Contact Properties menüpontot.

  2. Kattintsunk az Add a new property gombra.

  3. Adjuk meg a mező nevét.

  4. Válasszuk ki a mező adattípusát.

  5. Mentsük el a mezőt.

A Mailjet Contact Property két fontos tulajdonsága a Name és a Data Type.

Az elérhető adattípusok között szöveges, egész szám, tizedes szám, logikai és dátum típusú mezők is szerepelnek.

A Mailjet a mezőneveknél egyszerű belső elnevezéseket használ; célszerű például firstname, lastname, city, language vagy loyaltycategory jellegű neveket választani.

Tudnivalók a mezők összerendeléséről

Az összerendelést az alábbi formátumban kérjük megküldeni:

RESnWEB paraméter - Mailjet Contact Property neve.

Példa:

itemFirstName - firstname

itemCity - city

itemLoyaltyCategory - loyaltycategory

Egy mezőbe több adat is beküldhető, pl. a teljes névhez: itemFirstName, itemLastName - name.

TIPP! A vendég neve a Mailjet kontaktok beépített Name mezőjébe is átadható, ehhez nem szükséges külön Contact Property-t létrehozni.

A Contact Property típusát az átadott adathoz igazodva érdemes megválasztani; ha bizonytalanok, a szöveges (str) típus a legbiztosabb választás.

Mailjet rendszerébe átadható RESnWEB adatok

Az alábbi táblázat azoknak az adatoknak a listáját tartalmazza, amelyeket át tudunk adni a hírlevélküldő rendszerbe. A listából kiválaszthatják, hogy mely adatokat szeretnék viszontlátni a vendégek profiljában a hírlevélküldő felületen.

A kiválasztott adatokat ügyfélszolgálatunk részére szükséges elküldeni, valamint jelezni, hogy az egyes adatok mely mezőkbe kerüljenek a hírlevélküldő rendszerben.

Paraméter

Megnevezés

Leírás

itemGender

Megszólítás

Vendég megszólítása

itemFirstName

Keresztnév

Vendég keresztneve

itemLastName

Vezetéknév

Vendég vezetékneve

itemEmail

Email cím

A vendég által megadott email cím, melyre a hírleveleket szeretné kapni

itemCity

Település

A vendég által megadott város

itemAdults

Felnőttek száma

A foglalásban szereplő felnőttek száma

itemChildren

Gyerekek száma

A foglalásban szereplő gyerekek száma. Több szobatípus foglalása esetén vesszővel elválasztva pl.: 2,0 első szobában 2 gyerek, másodikban 0 gyerek

itemArrive

Érkezés dátuma

Érkezés dátuma

itemDeparture

Távozás dátuma

Távozás dátuma

itemNights

Éjszakák száma

A lefoglalt éjszakák száma

itemName

Szobatípus neve

Foglalt szobatípus(ok) / Vásárolt utalvány(ok) neve

itemAdditionalName

Ár neve

Foglalt ár megnevezése

itemPrice

Foglalás(ok) ára

A foglalt szobatípusok ára (kiegészítő szolgáltatások nélkül) / Vásárolt utalvány(ok) ára

itemAdditionalPrice

Kiegészítő szolgáltatás(ok) összege

Kiegészítő szolgáltatás(ok) összege

itemFullPrice

Foglalás teljes összege

Foglalás teljes összege (szoba + kieg. szolg.)

itemSumPrice

Eddig elköltött összeg

A megadott email címmel rögzített foglalások / vásárolt utalványok összege

itemSumNumber

Eddigi tranzakciók száma

A megadott email címmel rögzített foglalások / vásárolt utalványok száma

itemSource

Forrás

A vendég hírlevélre való feliratkozásának helye

itemConsent

Dátum

A hírlevélre való feliratkozás dátuma, időpontja

itemLanguage

Nyelv

A vendég nyelve

itemLoyaltyCategory

Törzsvendég szint neve

A törzsvendég programban rögzített kedvezmény kategória szint neve

itemLoyaltyProgramName

Törzsvendég program neve

A törzsvendég program neve

itemHotel

Szálláshely neve

Szálláshely neve

A működéssel kapcsolatos információk

A beállítások elvégzését követően azoknak a vendégeknek / vevőknek az adatai kerülnek továbbításra a Mailjet felé, akik a RESnWEB valamely erre alkalmas felületén feliratkoztak a hírlevelekre.

A feliratkozó e-mail-címe a Mailjetben kontaktként kerül kezelésre, a RESnWEB-ből továbbított további adatok pedig a beállított Contact Properties mezőkbe kerülnek. A Mailjet lehetőséget biztosít meglévő kontaktok Contact Properties adatainak frissítésére is.

Hírlevél-feliratkozásra a RESnWEB-ben az alábbi helyeken lehet lehetőség:

  • Foglalói felület

  • Ajándékutalvány-vásárlói felület

  • Ajánlatkérő űrlap

  • Elégedettségmérő kérdőív

  • Online bejelentőlap

  • „Elküldöm magamnak e-mailen” pop-up

  • Törzsvendég-regisztráció

A kapcsolat élesítése után javasoljuk egy tesztfeliratkozás elvégzését, majd annak ellenőrzését a Mailjet Contacts felületén.

Sikeres integráció esetén ellenőrizhető, hogy:

  • a tesztelő email címe megjelent-e a megfelelő Contact Listen;

  • a kontakt feliratkozott státuszban szerepel-e;

  • a név és egyéb átadott adatok a megfelelő Contact Properties mezőkbe kerültek-e.

Ha az adatok nem a megfelelő mezőben jelennek meg, kérjük, jelezzék ügyfélszolgálatunknak az info@resnweb.com e-mail-címen.

Választ kapott a kérdésére?