Integrasikan Email API SendGrid dengan Cloud Code Back4App

10min
Menggunakan API email Sendgrid
Pendahuluan
Bagian ini menjelaskan bagaimana Anda dapat mengintegrasikan SendGrid dengan fungsi Cloud Code. Setelah menyelesaikan panduan ini dengan instruksi langkah demi langkah, Anda akan siap menggunakan fungsi Anda di Aplikasi Anda dan memanggilnya di Aplikasi iOS atau Android Anda.
Prasyarat
Untuk menyelesaikan tutorial ini, Anda akan membutuhkan:


Sebuah aplikasi yang dibuat di Back4App.
Ikuti tutorial Membuat Aplikasi Baru untuk belajar bagaimana cara membuat aplikasi di Back4App.
Back4App Command Line yang dikonfigurasi dengan proyek.
Ikuti tutorial Menyiapkan Cloud Code untuk belajar bagaimana cara menyiapkan cloud code untuk sebuah proyek.
Akun yang dibuat di Twilio.
Mari kita mulai!
Kami akan menulis sebuah fungsi menggunakan SendGrid yang akan memungkinkan Anda untuk bekerja dengan banyak kemungkinan seperti Mengirim pesan kepada pelanggan kami dan mengonfigurasi parameter untuk menggunakan API REST SendGrid v3.
Untuk belajar bagaimana cara membuat atau mengakses Akun di SendGrid, periksa tautan yang diberikan di bawah:
﻿Buat akun baru - Masuk ke akun Anda﻿
1 - Buat Kunci API SendGrid
Langkah terpenting sebelum mulai coding adalah membuat kunci yang benar untuk mengatur lingkungan Anda. Setelah mengakses akun Anda, cari di menu drop-down Pengaturan, opsi Kunci API seperti pada gambar di bawah:
﻿
Setelah itu, di pojok kanan atas cari dan pilih identifikasi untukNama Kunci API, seperti yang ditunjukkan di bawah:
﻿
Seperti yang Anda lihat pada gambar di atas, perlu untuk memilih satu opsi untuk mengizinkan Akses Penuh ke Kunci API.
Setelah mengklik Buat & Lihat untuk melanjutkan pembuatan kunci, Anda akan dapat melihat layar di bawah:
﻿
Petunjuk: Hati-hati untuk mencatatnya, karena tidak ada cara untuk mengambilnya kembali. Klik pada teks untuk menyalinnya.
2 - Tambahkan fungsi ke Cloud Code
Strategi utama untuk cara menggunakan API SendGrid ini adalah dengan membuat fungsi di Cloud Code bernama sendgridEmail dan memanggilnya dari Aplikasi.
2.1 - Instal modul dari Sendgrid
Buat file bernama package.json, dan di dalam file ini, Anda perlu menginstal modul Twilio, seperti:
JSON
1   { 
2	   "dependencies": {
3		   "@sendgrid/mail": "*"
4	   }
5   }
1   { 
2	   "dependencies": {
3		   "@sendgrid/mail": "*"
4	   }
5   }
﻿
2.2 - Implementasikan Cloud Code
Anda harus mencatat bahwa setiap field email harus dikirim oleh Aplikasi – dari subjek hingga konten – sebagai parameter. Kode adalah sebagai berikut:
Parse Server 3.X
Parse Server 2.X
1   Parse.Cloud.define("sendgridEmail", (request, response) => {
2       const sgMail = require('@sendgrid/mail');
3
4       // Import SendGrid module and call with your SendGrid API Key
5       sgMail.setApiKey("your SendGrid API key here");
6    
7       const msg = {
8           to: request.params.toEmail,
9           replyTo: '[email protected]',
10          from: '[email protected]',
11           subject: request.params.subject,
12          text: request.params.body
13      };
14    
15      sgMail.send(msg).then(() => {
16         response.success("The message was sent!");
17      })
18      .catch(error => {    
19          //Log friendly error
20          response.error(error.toString());
21      });
22  });
1   Parse.Cloud.define("sendgridEmail", (request, response) => {
2       const sgMail = require('@sendgrid/mail');
3
4       // Import SendGrid module and call with your SendGrid API Key
5       sgMail.setApiKey("your SendGrid API key here");
6    
7       const msg = {
8           to: request.params.toEmail,
9           replyTo: 'info@youremail.com',
10          from: 'info@youremail.com',
11           subject: request.params.subject,
12          text: request.params.body
13      };
14    
15      sgMail.send(msg).then(() => {
16         response.success("The message was sent!");
17      })
18      .catch(error => {    
19          //Log friendly error
20          response.error(error.toString());
21      });
22  });
﻿
Petunjuk: Ingat untuk mengubah bidang dari dan reply_to ke informasi pribadi Anda.
Kemudian perlu untuk menerapkan panggilan ke fungsi Cloud Code di aplikasi.
3 - Panggil fungsi Cloud Code
Dalam langkah ini, kita dapat bekerja dengan dua kemungkinan untuk memanggil fungsi kita, yaitu: Android dan iOS (Swift dan Objective-C).
Android
iOS(Swift)
iOS(Objective-C)
1   PFCloud.callFunctionInBackground("sendgridEmail", withParameters: [
2       // These fields have to be defined earlier
3       "toEmail": toEmail,
4       "subject": subject,
5       "body": body
6   ]) { (response, error) in
7       if error == nil {
8           // The function executed, but still has to check the response
9       } else {
10          // The function returned an error
11      }
12  }
1   PFCloud.callFunctionInBackground("sendgridEmail", withParameters: [
2       // These fields have to be defined earlier
3       "toEmail": toEmail,
4       "subject": subject,
5       "body": body
6   ]) { (response, error) in
7       if error == nil {
8           // The function executed, but still has to check the response
9       } else {
10          // The function returned an error
11      }
12  }
﻿
4 - Selesai!
Dan itu saja untuk penggunaan SendGrid. Perhatikan bahwa Anda mungkin ingin menggunakan semacam otentikasi sebelum mengizinkan siapa pun menggunakan API SendGrid Anda untuk mengirim email.
Jika Anda memerlukan bantuan atau fungsi/link tidak berfungsi, silakan hubungi tim kami melalui obrolan!
Diperbarui 27 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Integrasi Twilio API ke WhatsApp dengan Cloud Code di Back4App
BERIKUTNYA
Platform Kolaborasi Database Hub di Back4App