# Mailtrap kapcsolat

> A Mailtrap-integráció lépései: API-token, küldő domain ellenőrzése, tesztmód és a bővítmény beállításai.

A **Mailtrap** e-mail-kézbesítési platform: tesztkörnyezetet (sandbox) és éles küldésre használható tranzakciós e-mail-API-t is kínál.

## A kapcsolat lépései

1. Jelentkezz be a Mailtrap-fiókodba.
2. Szerezd meg a Mailtrap API-tokent a fiókbeállításokban. Ez köti össze a weboldalt a Mailtrap-fiókkal.
3. Ellenőriztesd a küldő domaint a Mailtrapben (lásd lent). Ez igazolja, hogy a címhez és a domainhez jogod van, ezért a Gravity SMTP beállítása előtt kell elvégezned.
4. A WordPressben nyisd meg az **SMTP → Beállítások → Integrációk** oldalt, kattints a **+** gombra, keresd meg és válaszd ki a **Mailtrap** kártyát. Töltsd ki a megjelenő beállításokat.
5. Mentsd az integrációt a **Mentés és bekapcsolás** gombbal. A mentés után az új kártya megjelenik az integrációk között.
6. Küldj egy tesztlevelet az [Eszközök](https://hub.hellowp.io/hu/plugins/gravitysmtp/eszkozok/) oldalon.

## API-token létrehozása a Mailtrapben

A Gravity SMTP-nek a tokenre azért van szüksége, hogy a Mailtrap-fiókodon át küldhessen. Az integráció beállítása előtt hozd létre.

1. A Mailtrap vezérlőpultján nyisd meg a **Settings → API Tokens** oldalt.
2. Kattints a jobb felső sarokban az **Add Token** gombra.
3. Adj a tokennek nevet, és jelöld be a megfelelő hozzáférési szinteket. Adminisztrátori jogosultságod kell legyen azon a domainen, amelyről küldeni szeretnél.
4. Kattints a **Save** gombra.
5. Másold ki és mentsd el a tokent. Az ablak bezárása után már nem kérhető le, a Gravity SMTP beállításához pedig szükséged lesz rá.

### Tesztpostafiók-azonosító

A Mailtrap tesztkörnyezete (sandbox) olyan tesztfelület, amely a kimenő leveleket nem kézbesíti a valódi címzetteknek, hanem elfogja, így biztonságosan kipróbálhatod a beállításaidat. Ha használni szeretnéd a **Tesztmód bekapcsolása** kapcsolót, szükséged van a tesztpostafiók azonosítójára. Keresd meg a Mailtrap vezérlőpultján: **Email Testing → Sandboxes**, nyisd meg a tesztpostafiókot, és lépj az **Integration** fülre. A számokból álló azonosító az oldal címében (URL) látszik.

## Küldő domain hozzáadása és ellenőrzése a Mailtrapben

### Új domain hozzáadása

1. A Mailtrap bal oldali menüjében nyisd meg a **Sending Domains** pontot, és kattints az **Add Domain** gombra.
2. Írd be a domaint, amelyről küldeni szeretnél, és kattints az **Add** gombra. A domain tulajdonosának kell lenned, és hozzá kell férned a DNS-rekordjaihoz.
3. A hozzáadás után a **Domain Verification** oldalra jutsz.

### DNS-rekordok felvétele

A tulajdonjog igazolásához a domain DNS-szolgáltatójánál öt rekordot kell felvenned: négy `CNAME` típusút (domain-ellenőrzés, két DKIM-rekord és az egyéni követési domain) és egy `TXT` típusút (DMARC).

1. A **Domain Verification** oldalon keresd meg a Mailtrap rekordjait.
2. Mindegyiknél másold ki a **Name** és a **Value** mezőt, és vedd fel a DNS-szolgáltatódnál. Figyelj a rekord típusára.
3. Egyes DNS-szolgáltatók a DKIM-rekordot meghatározott formában várják. Ilyenkor a `rwmt1._domainkey` helyett `rwmt1._domainkey.sajatdomain.hu`, a `rwmt2._domainkey` helyett `rwmt2._domainkey.sajatdomain.hu` nevet használd.
4. Térj vissza a Mailtrapbe. A rekordok azonnal is ellenőrizhetők lehetnek, de a terjedés időt vehet igénybe. A Mailtrap óránként automatikusan ellenőriz, kézzel a **Re-check DNS Records** gombbal indíthatsz ellenőrzést.

Ha minden rekord rendben van, az állapot **Missing**-ről **Verified**-re vált. A terjedés 15 perctől néhány óráig tart, ritkán akár 24 óráig is.

## Beállítások

Az **SMTP → Beállítások → Integrációk** oldalon kattints a **+** gombra, és válaszd a **Mailtrap** kártyát.

![A Mailtrap-beállítások panel teteje: az API-token, a tesztmód kapcsolója és a tesztpostafiók-azonosító](./kepek/szolgaltatok-mailtrap-beallitasok.webp)

*A Mailtrap-beállítások panel teteje: az API-token, a tesztmód kapcsolója és a tesztpostafiók-azonosító* (https://minta-bolt.hu/wp-admin/admin.php?page=gravitysmtp-settings&tab=integrations)

A képen a **Konfiguráció** alatt az **API-token** mező, a **Tesztmód bekapcsolása** kapcsoló és a **Tesztpostafiók-azonosító (ID)** mező látszik.

![A Mailtrap-beállítások panel alja: a feladó és a válaszcím mezői, a mentés gomb](./kepek/szolgaltatok-mailtrap-altalanos.webp)

*A Mailtrap-beállítások panel alja: a feladó és a válaszcím mezői, a mentés gomb* (https://minta-bolt.hu/wp-admin/admin.php?page=gravitysmtp-settings&tab=integrations)

Az alsó részen az **Általános beállítások** és a **Mentés és bekapcsolás** gomb látszik.

### Konfiguráció

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **API-token** | A Mailtrap-fiók API-tokenje, amellyel a bővítmény hitelesít az API-nál. | üres |
| **Tesztmód bekapcsolása** | Bekapcsolva az e-mailek nem a valódi címzettekhez, hanem a Mailtrap tesztpostafiókjába érkeznek. | kikapcsolva |
| **Tesztpostafiók-azonosító (ID)** | A Mailtrap tesztkörnyezetében található, számokból álló azonosító. Bekapcsolt tesztmódban kötelező. | üres |

A tesztpostafiók azonosítóját a Mailtrap tesztkörnyezetének **Inboxes** oldalán találod. Ez a tesztmód független a Gravity SMTP saját tesztmódjától.

### Általános beállítások

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Alapértelmezett feladói e-mail-cím** | A kimenő levelek feladója. Csak akkor érvényesül, ha a levél nem ad meg saját feladót. A címnek vagy a domainjének ellenőrzöttnek kell lennie a Mailtrapben. | üres |
| **Feladó e-mail-címének kényszerítése** | Bekapcsolva minden levélnél ezt a címet használja, felülírva a bővítmények beállításait. | kikapcsolva |
| **Alapértelmezett feladó neve** | A feladó neve, ugyanazzal a szabállyal. | üres |
| **Feladó nevének kényszerítése** | Minden levélnél ezt a nevet használja. | kikapcsolva |
| **Alapértelmezett válaszcím** | A válaszcím, ha a levél nem ad meg sajátot. | üres |
| **Válaszcím kényszerítése** | Minden levélnél ezt a válaszcímet használja. | kikapcsolva |