Kirim Email dengan API Sendgrid di PHP untuk Notifikasi dan Contact Form

Notifikasi email adalah fitur yang harus dibuat, apabila kita ingin berkomunikasi dengan user secara otomatis.
Contoh kasus penerapan notifikasi email:

1. Pengiriman notifikasi email ke mahasiswa saat nilai diinputkan admin pada sistem informasi akademik.
2. Pengiriman email ke pemilik web saat ada orang yang submit dari contact form.
3. Pengiriman email saat reset password.
4. Pengiriman email saat ada berita baru.
5. dll.

Nah, pada kesempatan ini. Kita akan belajar cara menggunakan API Sendgrid untuk mengirim email.

Apa itu SendGrid?

Sendgrid adalah layanan yang menyediakan API untuk mengirim email dan email list untuk email marketing. Sendgrid telah digunakan oleh beberapa start-up ternama seperti Uber, Spotify, Airbnb, dll.
Sendgrid menyediakan dua metode untuk mengakses layanan mereka:

1. Melalui API
2. Melalui protokol SMTP

Kita akan menggunakan metode yang pertama, karena direkomendasikan oleh Sendgrid.Silahkan daftar dulu ke SendGrid.
sementara ini kita akan menggunakan paket free trial

Mendapatkan API Key Sendgrid

Setelah sukses mendaftar, silahkan masuk ke bagian integrasi: https://app.sendgrid.com/guide/integrate.

Lalu, pilih Web API, karena kita akan menggunakan API untuk mengirim email.

Berikutnya, pilih PHP. Karena kita akan menggunakan bahasa pemrograman PHP.

Berikutnya, silahkan berikan nama API Key.

Klik Create API key untuk membuat API Key.

Maka kita akan mendapatkan API key seperti ini:

Silahkan simpan API Key tersebut di tempat yang aman. 

Membuat Project Baru dengan Composer

Apabila kamu sudah punya project—yang menggunakan framework seperti Laravel— maka langkah ini boleh tidak dilakukan.

Namun, apabila kamu belum punya project, silahkan buat dulu. Ikuti perintah berikut.

mkdir belajar-sendgrid
cd belajar-sendgrid
echo "vendor" > .gitignore
echo ".env" >> .gitignore

Perintah di atas adalah perintah untuk membuat direktori project dan menambahkan direktori vendor dan .env ke dalam .gitignore agar tidak dicatat oleh Git.


Setelah itu, siapkan project dengan composer:

composer init

Isi keterangan project, sehingga tercipta file composer.json dengan isi seperti ini:

{
    "name": "ronia/sendgrid-example",
    "description": "Belajar menggunakan API sendgrid untuk kirim email",
    "type": "project",
    "license": "MIT",
    "authors": [
        {
            "name": "roniandarsyah",
            "email": "roniandarsyah@poltekpos.ac.id"        }
    ]
}

Menginstall Library SendGrid

Sendgrid sudah menyediakan library untuk mengakses API mereka, sehingga kita tidak peru repot-repot membuat kode dari nol dengan CURL atau semacamnya.


Untuk menginstal library Sendgrid, silahkan ketik perintah ini:

composer require sendgrid/sendgrid -vvv

Berikutnya kita akan menginstall library Dotenv untuk me-load variabel Environtment dari file .env. Karena kita akan menyimpan API Key dari Sendgrid di file .env.

Silahkan ketik perintah berikut:

composer require vlucas/phpdotenv -vvv