# Mailchimp Transactional kapcsolat

> A Mailchimp Transactional integráció lépései: domain hozzáadása és hitelesítése, API-kulcs létrehozása és a bővítmény beállításai.

A **Mailchimp Transactional** (korábbi nevén Mandrill) tranzakciós levelek küldésére való szolgáltatás. Tranzakciós levél az, amelyet egy felhasználói művelet vált ki, például jelszó-visszaállítás vagy rendelés visszaigazolása: egy üzenet egy címzettnek, nem tömeges hírlevél.

## A kapcsolat lépései

1. Hozz létre egy Mailchimp Transactional-fiókot, vagy jelentkezz be a meglévőbe.
2. Add hozzá és hitelesítsd a küldő domaint (lásd lent). Ez igazolja, hogy a domain a tiéd, ezért a Gravity SMTP beállítása előtt kell elvégezned.
3. Hozz létre egy API-kulcsot (lásd lent).
4. A WordPressben nyisd meg az **SMTP → Beállítások → Integrációk** oldalt, kattints a **+** gombra, és válaszd a **Mailchimp** kártyát. Töltsd ki a 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.

## Domain hozzáadása és hitelesítése

### Új domain hozzáadása

1. A Mailchimp Transactional fiókodban nyisd meg a **Settings** menü **Domains** (küldő domainek) oldalát.
2. Írd be az új domaint a mezőbe, és kattints az **Add** gombra.
3. A domain **Not Authenticated** állapottal kerül a listába.

### DKIM-rekordok felvétele

A DKIM (DomainKeys Identified Mail) igazolja, hogy a levél valóban a megadott domainről jön, és az úton nem módosult. Ez védi a domaint a hamisítás ellen, és növeli az esélyét, hogy a jogos levelek a címzett postaládájába kerülnek.

1. A domain sorában, a DKIM-oszlopban kattints a **View details** hivatkozásra. Egy ablak mutatja a DNS-szolgáltatónál elvégzendő lépéseket.
2. A DNS-szolgáltatódnál (tárhely, domain-regisztrátor vagy DNS-szolgáltató) vegyél fel két `CNAME` rekordot. A `CNAME` egy aliasnevet köt egy másik névhez.

| Típus | Hosztnév | Érték | TTL |
|---|---|---|---|
| `CNAME` | `mte1._domainkey.example.com` | `dkim1.mandrillapp.com` | `3600` |
| `CNAME` | `mte2._domainkey.example.com` | `dkim2.mandrillapp.com` | `3600` |

### Domain-tulajdon igazolása TXT-rekorddal

A küldésre használt domaint a tulajdon igazolásával is ellenőrizni kell. Ezt a **Domains** oldalon végezheted el.

1. A **Verified domain** oszlopban kattints a **View details** hivatkozásra. Az ablakban egy egyedi kulcsot látsz, például `mandrill_verify.Yfe0JuqvZBiYIUXmTwQNiA`.
2. Vedd fel a kulcsot a domain TXT-rekordjai közé:

| Típus | Hosztnév | Érték | TTL |
|---|---|---|---|
| `TXT` | üres | a kapott `mandrill_verify.…` kulcs | `3600` |

3. Kattints a **Test DNS Settings** gombra, hogy lásd, megjelent-e a rekord. A DKIM-rekordokhoz hasonlóan ez is eltarthat néhány percig a TTL miatt.

### Domain-tulajdon igazolása e-maillel

Ha nem tudod módosítani a DNS-t, e-mailben is igazolhatod a domaint. Ehhez a szervered legyen beállítva a bejövő levelek fogadására.

1. A **Requires verification** figyelmeztetésnél kattints a **View details** hivatkozásra.
2. Add meg a domainhez tartozó, működő e-mail-címet, és kattints a **Send Verification Email** gombra.
3. A kapott levélben található hivatkozásra kattintva a domain ellenőrzötté válik.

## API-kulcs létrehozása

1. A Mailchimp Transactional fiókod **Settings** oldalán keresd meg az **API Keys** részt.
2. Kattints a **Create API Key** gombra, és adj a kulcsnak leírást.
3. Másold ki a kulcsot. **Csak egyszer jelenik meg**, ezért mentsd el biztonságos helyre.

Egy kulcs több weboldalon is használható. Ha oldalanként szeretnéd visszavonhatóvá tenni, hozz létre oldalanként külön kulcsot.

## Beállítások

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

![A Mailchimp-beállítások panel teteje: az API-kulcs és a visszaküldési útvonal](./kepek/szolgaltatok-mailchimp-beallitasok.webp)

*A Mailchimp-beállítások panel teteje: az API-kulcs és a visszaküldési útvonal* (https://minta-bolt.hu/wp-admin/admin.php?page=gravitysmtp-settings&tab=integrations)

A képen a **Konfiguráció** alatt az **API-kulcs** mező, alatta az **Általános beállítások** kezdete látszik.

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

*A Mailchimp-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 a feladó és a válaszcím mezői, valamint a **Mentés és bekapcsolás** gomb látszik.

### Konfiguráció

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **API-kulcs** | A Mailchimptől kapott kulcs, amellyel a bővítmény hitelesít a Mailchimp Transactional API-nál. | üres |

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

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Visszaküldési útvonal** | Bekapcsolva a levél fejlécébe kerül a visszaküldési útvonal (return path), amely megadja, hová kell küldeni a kézbesíthetetlenségi értesítéseket. Kikapcsolva a visszapattanó üzenetek elveszhetnek. | kikapcsolva |
| **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 a fiókhoz csatlakoztatott címnek kell lennie. | ü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 |