Resend integráció

Mi az a Resend?

A Resend egy e-mail-küldő szolgáltatás fejlesztőknek. Tranzakciós e-maileket küld, vagyis olyan leveleket, amelyeket egy esemény vált ki: kapcsolatfelvételi űrlap beküldése, rendelés-visszaigazolás, foglalási emlékeztető, értesítés. A leveleket a saját, ellenőrzött domainedről küldi, így profin néznek ki és nagyobb eséllyel érkeznek a beérkező mappába, nem a spambe.

Mire használhatod a Suarában?

Ha összekötöd a Resendet, az appod e-mailt tud küldeni, és a chat AI is küldhet levelet a beszélgetés közben. Néhány példa:

• Kapcsolatfelvételi űrlap: a weboldalad űrlapja e-mailben értesít téged, ha valaki üzenetet küld.

• Rendelés- vagy foglalás-visszaigazolás: a vásárló vagy a vendég automatikusan levelet kap a rendelés, illetve a foglalás után.

• Emlékeztető: az app időpont előtt e-mailben emlékeztet az ügyfelekre.

• Belső értesítés: egy hibajelentés vagy új ajánlatkérés levélben érkezik a csapatodhoz.

Az AI az alábbi műveleteket használja:

• E-mail küldése: Levelet küld egy vagy több címzettnek (tárgy, HTML-tartalom, válaszcím)

• Domainek lekérdezése: Megmutatja, mely domaineket ellenőrizte már a Resend a fiókodban

A chat AI a Resend további eszközeit is használhatja, ha kéred.

Biztonság

Az API-kulcs titkosítva, a Suara szerverén marad. A generált app sosem látja, és a böngészőbe sem kerül. Az app a Suara gatewayen keresztül hívja a Resendet, a gateway pedig a háttérben hozzáadja a hitelesítő adatot. A kapcsolatot a láthatóság beállításával korlátozhatod: Csak én, Csak kiválasztott tagok vagy Az egész munkaterület.

Az e-mailt nem lehet visszahívni, ezért ha a chat AI a beszélgetés közben küld levelet, előbb jóváhagyást kér tőled. A kérésben látod a címzettet és a tárgyat.

Beállítás lépésről lépésre

1. Szerezd meg az API-kulcsot a Resendben

1. Jelentkezz be a Resendbe, vagy regisztrálj: https://resend.com

2. Nyisd meg az API-kulcsok oldalt: https://resend.com/api-keys

3. Kattints az Create API Key gombra.

4. Adj a kulcsnak nevet (például „Suara”), és a jogosultságnál válaszd a Full access értéket.

5. Kattints az Add gombra, majd másold ki a kulcsot.

Fontos: a kulcs csak egyszer jelenik meg, ezért másold ki rögtön. Full access jogosultság kell, mert a Suara a kapcsolat ellenőrzésekor lekérdezi a domaineket. Ha a kulcs csak küldési jogosultságot kap, a mentés hibával áll meg.

2. Ellenőrizd a küldő domainedet a Resendben

A levelek feladója csak a Resendben ellenőrzött domainről küldhet.

1. A Resendben nyisd meg a Domains oldalt: https://resend.com/domains

2. Add hozzá a domainedet, és állítsd be a Resend által megadott DNS-rekordokat a domain szolgáltatódnál.

3. Várd meg, amíg a domain státusza Verified lesz.

Amíg nincs ellenőrzött domained, csak az onboarding@resend.dev feladó működik, és csak a Resend-fiókod saját e-mail-címére tud levelet küldeni. Teszteléshez ez elég, éles használathoz ellenőrzött domain kell.

3. Kösd be a Suarában

1. A Suara oldalsávjában nyisd meg az Integrációk oldalt.

2. A Katalógusban keresd meg a Resendet. Az Üzenetküldés kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

3. Kattints a Csatlakoztatás gombra. Megnyílik a „Resend csatlakoztatása” ablak.

4. Illeszd be a másolt kulcsot az API kulcs mezőbe. A beillesztett érték a Kulcs megjelenítése ikonnal ellenőrizhető. A Hol találom? hivatkozás a Resend API-kulcs oldalára visz.

5. Válaszd ki, ki használhatja a kapcsolatot (Csak én vagy Az egész munkaterület). Ha a teljes munkaterületnek engedélyezed, a Suara figyelmeztet, hogy minden tag használhatja a kapcsolatot a saját projektjeiben, és így az ő appjaik is küldhetnek leveleket a te fiókodból.

6. Kattints a Mentés és ellenőrzés gombra. A Suara lekérdezi a domainjeidet, és ha a kulcs érvényes, a kapcsolat Resend néven megjelenik a Kapcsolataid között.

4. Használd a projektedben

Három módon használhatod a kapcsolatot:

• A chatben kérve: írd le az AI-nak, mit szeretnél, például „A kapcsolatfelvételi űrlap beküldésekor küldj e-mailt az info@cegem.hu címre.” Ha még nincs kapcsolat, az AI felkínálja a csatlakoztatást.

• Az Integrációk oldalról: a Kapcsolataid között a Resend mellett a Bekötés az appba gombbal kötheted be a kapcsolatot egy projektbe.

• A projekt Kapcsolatok oldaláról: nyisd meg a projekt Kapcsolatok részét, és kattints a Kapcsolat gombra. Ott a Munkaterület kapcsolatai közül választhatsz egy meglévőt, vagy az Új bekötése gombbal újat hozhatsz létre.

A projektekbe kötéshez be kell kapcsolni a Suara Cloudot. Ha még nincs bekapcsolva, kérd meg az AI-t a chatben. A kapcsolatot ettől függetlenül használhatod csak a chatben is (Csak chat), az appba bekötni később is lehet.

A bekötés után az AI a Resend-hívásokat az app szerveroldali (edge function) részében generálja. A kulcs így nem kerül a kódba, és a kapcsolatot szükség esetén a projekt Kapcsolatok oldaláról bármikor leválaszthatod.

Ha kihagyod a kapcsolatot: az AI ilyenkor sem állítja, hogy az e-mail elmegy. Az űrlapot felépíti, de levél nem megy ki, amíg a Resendet nem kötöd be a Kapcsolatok oldalon.

Saját domain használata

A https://resend.com/domains oldalon add hozzá a már meglévő és a te tulajdonodban lévő domain-t. Példa: azenoldalam.hu nem kell www se https:// előtag sem. Ezt követően megjelenik számodra az instrukciós oldal ami tartalmazza azt, hogy mely rekordokat kell beálíltanod ott ahol a domain-t vásároltad, ez a legtöbb esetben 4-5 beállítás ami 2 perc alatt elvégezhető, a resend oldalán találsz "Tutorial" gombot is amiben segítenek ebben neked. Fontos, hogy ezeket az adatokat ott kell beállítanod ahol a domain-t vásároltad és általában a "DNS rekordok szerkesztése" opciót kell keresni.

A Resend oldalon látható a:

1. "type": ez mondja meg, hogy milyen típúsú rekordot kell létrehozni pl: TXT.

2. Name: A legtöbb esetben ez a Hosztnév néven szerepel, gyakran úgy látjuk hogy egy szöveges mező majd egy pont és a saját domain

3. Content: Ez a legtöbb esetben a IP vagy hosztnév féle megnevezéssel jelenik meg ide kell beilleszteni azt amit a resend mutat felénk

Ha ezeket megfelelően beállítottuk akkor nyomjuk meg a Resend oldalon az "I've added the records" gombot ami ezt követően elkezdi ellenőrizni azt ez általában pár percet vesz igénybe, ha mindent megfelelően állítottunk be akkor minden zöld jelzésű lesz és ezt követően képesek leszünk a saját címűnkről küldeni emaileket pl: info@azenoldalam.hu.

Kapcsolat kezelése

Az Integrációk → Kapcsolataid alatt a Resend kapcsolatra kattintva elérhető:

• Alapadatok: az elnevezés és a láthatóság módosítása.

• Kulcsok frissítése: új API-kulcs mentése, ha lecserélted vagy törölted a régit.

• Kapcsolt projektek: itt látod, mely projektek használják a kapcsolatot.

• Utolsó hívások: itt látod a legutóbbi hívásokat (metódus, útvonal, státusz, időtartam, forrás: alkalmazás vagy chat).

• Leválasztás (Veszélyzóna): megszünteti a kapcsolatot. A hozzá kötött projektek ezután nem tudnak e-mailt küldeni.

A státusz lehet Aktív, Hiba vagy Visszavonva. Ha Újracsatlakozás szükséges üzenetet látsz, mentsd újra a kulcsot.

Hibaelhárítás