GiMail GiMail Simple email delivery
Masuk Mulai gratis

Dokumentasi GiMail

Panduan SMTP Relay GiMail untuk Laravel

Gunakan GiMail seperti Brevo SMTP: cukup isi konfigurasi MAIL_* di .env Laravel agar reset password dan verifikasi email berjalan.

Published 29 Jun 2026 API Key Integrasi Email

Panduan SMTP Relay GiMail untuk Laravel

SMTP Relay GiMail membuat aplikasi Laravel lain bisa mengirim email reset password, verifikasi email, OTP, dan notifikasi cukup dengan mengisi konfigurasi MAIL_* di file .env, mirip seperti Brevo.

Gunakan mode SMTP jika aplikasi client memakai fitur email bawaan Laravel seperti reset password dan email verification. Untuk integrasi custom berbasis JSON, gunakan HTTP API GiMail.

1. Buat API Key GiMail

Buka dashboard GiMail, masuk ke menu API Keys, lalu generate key untuk aplikasi client. Key ini akan dipakai sebagai credential SMTP.

2. Konfigurasi .env Laravel Client

Masukkan API key GiMail ke MAIL_USERNAME dan MAIL_PASSWORD. Dengan cara ini, Laravel bisa langsung memakai SMTP relay GiMail.

MAIL_MAILER=smtp
MAIL_HOST=smtp.ses.guruinovatif.id
MAIL_PORT=587
MAIL_USERNAME=gi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MAIL_PASSWORD=gi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=connect@guruinovatif.id
MAIL_FROM_NAME="${APP_NAME}"

Konfigurasi development lokal

Untuk testing di lokal, SMTP relay bisa berjalan di port 2525 tanpa TLS.

MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=gi_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MAIL_PASSWORD=gi_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=connect@guruinovatif.id
MAIL_FROM_NAME="${APP_NAME}"

3. Bersihkan Cache Config Laravel

Setelah mengubah .env, jalankan perintah berikut di aplikasi Laravel client.

php artisan config:clear
php artisan cache:clear

4. Tes Reset Password

  1. Buka halaman lupa password di aplikasi Laravel client.
  2. Masukkan email user yang valid.
  3. Laravel mengirim email lewat SMTP relay GiMail.
  4. GiMail mencatat kontak dan riwayat pengiriman.
  5. Jika email dibuka, status kontak menjadi tervalidasi.

5. Cara Kerja SMTP Relay GiMail

Ketika Laravel client mengirim email melalui SMTP, service SMTP GiMail akan menerima email tersebut, memvalidasi API key, mem-parse subject, recipient, HTML, dan text body, lalu meneruskannya ke sistem GiMail untuk dikirim melalui AWS SES.

  • API key SMTP divalidasi terhadap dashboard GiMail.
  • Kontak otomatis dibuat dari email tujuan.
  • Riwayat pengiriman otomatis tersimpan.
  • Tracking pixel ditambahkan untuk status email dibuka.
  • Pengiriman akhir tetap memakai AWS SES milik client.

6. Catatan Production

  • Gunakan domain smtp.ses.guruinovatif.id.
  • Gunakan port 587 dengan tls.
  • Jangan taruh API key di frontend.
  • Revoke key jika credential bocor.
  • Pastikan domain pengirim sudah verified di AWS SES.