# Brevo kapcsolat

> A Gravity SMTP Brevo-integrációjának beállításai, és a küldő domain hitelesítése a Brevóban.

A **Brevo** integrációhoz egy Brevo API-kulcs kell. Előtte a Brevóban hitelesítened kell azt a domaint, amelyről a leveleket küldöd.

## A kapcsolat lépései

1. Hozz létre egy Brevo-fiókot, a tranzakciós levelekhez használt csomaggal.
2. Hitelesíts egy domaint küldői azonosítóként a Brevóban (lásd lent). Ez igazolja, hogy a domain és a küldő cím a tiéd, ezért a Gravity SMTP beállítása előtt kell elvégezned.
3. Hozz létre egy Brevo API-kulcsot (lásd lent).
4. Ellenőrizd a Brevo fiókod engedélyezett IP-címeit (**Authorized IPs**). A funkció alapból be van kapcsolva minden 2024. május 16. után létrehozott fiókban. Ha a webszervered IP-címe nincs az engedélyezettek között, a küldés „Invalid API Key provided” hibával áll le.
5. Az **SMTP → Beállítások → Integrációk** oldalon add hozzá a **Brevo** kártyát, és töltsd ki a beállításokat (lásd lent).
6. Mentsd az integrációt a **Mentés és bekapcsolás** gombbal, majd küldj egy tesztlevelet az [Eszközök](https://hub.hellowp.io/hu/plugins/gravitysmtp/eszkozok/) oldalon.

## Beállítások

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

![A Brevo beállítások panel az API-kulcs mezővel és az általános beállításokkal](./kepek/szolgaltatok-brevo-beallitasok.webp)

*A Brevo beállítások panel az API-kulcs mezővel és az általános beállításokkal* (https://minta-bolt.hu/wp-admin/admin.php?page=gravitysmtp-settings&tab=integrations)

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

### Konfiguráció

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **API-kulcs** | A Brevo által adott kulcs, amellyel a bővítmény hitelesít a Brevo API-nál. A Brevo vezérlőpultjának API-szakaszában hozhatod létre. Ellenőrizd, hogy az **Engedélyezett IP-címek** beállítása megfelelő-e, különben a Brevo elutasíthatja a kéréseket. | üres |

### Á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. A Brevóban hitelesített cím legyen. Csak akkor érvényesül, ha a levél nem ad meg saját feladót. | ü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 |

Az integráció mentése a **Mentés és bekapcsolás** gombbal történik. Utána küldj egy tesztet az [Eszközök](https://hub.hellowp.io/hu/plugins/gravitysmtp/eszkozok/) oldalon.

## Domain hitelesítése a Brevóban

A küldő domain hitelesítésével igazolod, hogy a domain a tiéd. Ezt az integráció beállítása előtt végezd el a Brevo fiókodban.

### Új domain hozzáadása

1. A Brevóban a bal oldali menüben nyisd meg a **Senders → Domains** részt, és kattints az **Add a domain** gombra.
2. Add meg a domaint, amelyről a Brevón át küldeni akarsz.
3. Válaszd ki a domainszolgáltatódat a legördülő listából.
4. Ha a fiókod támogat dedikált IP-címet, kiválaszthatsz egy konkrét IP-t vagy IP-készletet, amelyről a levelek mennek.

### A domain ellenőrzése

A Brevo öt DNS-rekordot vár az új aldomainhez. Menj a domain DNS-szolgáltatójához (ahol a gyökérdomain DNS-e van), és vedd fel mindegyik rekordot a Brevo által megadott értékekkel. A rekordok az aldomainre vonatkoznak, ahogy a hosztnév értéke mutatja. A DKIM-rekordok részleteit a Brevo saját súgója írja le.

1. Miután felvetted az összes DNS-rekordot, kattints az oldal jobb felső sarkában a **Verify DNS Settings** gombra.
2. A DNS-rekordok terjedése időt vehet igénybe. Amint a rekordok ellenőrzése sikerült, a Brevo e-mailt küld.
3. Az ellenőrzés állapotát a **Senders → Domains** oldalon követheted. Ellenőrzés után a rekordok az adott domain **Authenticate** műveletével érhetők el.

Ha minden rekord ellenőrzött, következhet az API-kulcs létrehozása, és az integráció beállítása a Gravity SMTP-ben.

## API-kulcs létrehozása a Brevóban

A Gravity SMTP-nek Brevo API-kulcs kell a küldéshez. Ezt az integráció beállítása előtt kell létrehoznod.

1. A Brevo fiókodban nyisd meg a **Settings → SMTP & API → API Keys** oldalt.
2. Kattints az **Add new key** gombra, írj egy leírást (**Description**) az új kulcshoz, majd kattints a **Create Key** gombra.
3. A kulcs **csak egyszer** jelenik meg, ezért másold ki és mentsd el biztonságos helyre.

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

### Engedélyezett IP-címek

A Brevo az **Authorized IPs** funkcióval korlátozza, mely IP-címekről érhető el az API. Ha a levelek nem mennek ki, ellenőrizd, hogy a weboldalad IP-címe szerepel-e a listán. Az engedélyezőlista használatakor csak a felsorolt IP-címek kapcsolódhatnak az API-hoz.