Di dunia yang saling terhubung saat ini, komunikasi adalah kunci, dan salah satu bentuk komunikasi yang paling umum tetaplah pesan teks sederhana. Baik itu mengirim notifikasi, peringatan, atau pesan promosi, kemampuan untuk mengirim pesan SMS (Short Message Service) secara terprogram membuka berbagai kemungkinan bagi pengembang. Hadirlah Twilio, platform komunikasi cloud yang memberdayakan pengembang untuk mengintegrasikan fungsionalitas SMS dengan mulus ke dalam aplikasi mereka.
Pendahuluan:
Dalam tutorial ini, kita akan menjelajahi cara memanfaatkan kekuatan Twilio bersama dengan fleksibilitas Node.js untuk mengirim pesan SMS dengan mudah. Node.js, dengan model I/O non-pemblokiran dan ekosistem paket yang kaya, menyediakan lingkungan yang ideal untuk membangun aplikasi yang terukur dan efisien, sementara Twilio menyederhanakan pengiriman dan penerimaan pesan SMS, menangani pengiriman, dan mengelola nomor telepon.
Baik Anda mengembangkan sistem notifikasi, membangun chatbot dukungan pelanggan, atau hanya ingin memasukkan fungsionalitas SMS ke dalam aplikasi Anda, tutorial ini akan memandu Anda melalui proses langkah demi langkah. Pada akhirnya, Anda akan memiliki pemahaman yang kuat tentang cara memanfaatkan API Twilio dengan Node.js untuk mengirim pesan SMS dengan andal dan aman.
Jadi, mari selami dan pelajari cara memperkuat aplikasi Node.js Anda dengan kemampuan SMS Twilio!
Menyiapkan Akun Twilio:
Sebelum mengirim pesan SMS dengan Twilio dan Node.js, langkah pertama adalah menyiapkan akun Twilio.
Twilio menawarkan uji coba gratis yang dapat Anda gunakan untuk menguji semua layanan mereka seperti mengirim SMS dengan nomor gratis yang akan mereka tetapkan untuk Anda.
Namun, untuk memulai, daftarlah untuk akun gratis.
Mendaftar untuk Akun Gratis Twilio:
Buka situs web Twilio (https://www.twilio.com/) dan daftar untuk akun baru jika Anda belum melakukannya. Proses pendaftaran mudah dan hanya membutuhkan informasi dasar seperti alamat email, nama lengkap, dan kata sandi Anda.
Verifikasi Alamat Email Anda:
Menurut Twilio
Verifikasi ini membantu mencegah penyalahgunaan platform Twilio dan memastikan kepatuhan terhadap peraturan telekomunikasi.
Setelah mendaftar, Twilio akan mengirimkan email verifikasi ke alamat yang Anda berikan selama pendaftaran. Klik tautan verifikasi di email untuk mengonfirmasi alamat email Anda dan mengaktifkan akun Twilio Anda.
Verifikasi Nomor Telepon:
Ini membantu Twilio memverifikasi identitas Anda dan juga memungkinkan Anda mengirim pesan uji ke telepon Anda dari akun Twilio Anda saat dalam mode uji coba.
Setelah memverifikasi email Anda, Anda akan diminta untuk memverifikasi nomor telepon Anda. Twilio secara otomatis mendeteksi lokasi Anda menggunakan I.P Anda. Pastikan untuk membuat akun Anda menggunakan nomor yang dapat Anda verifikasi di negara Anda.
Akses Dasbor Twilio Anda:
Setelah akun Anda diverifikasi, masuk ke akun Twilio Anda untuk mengakses Konsol Twilio. Konsol adalah tempat Anda akan mengelola layanan Twilio, nomor telepon, dan kredensial API Anda.
Dapatkan Kredensial API Twilio:
Di Konsol Twilio, navigasikan ke bagian "Dasbor" atau "Pengaturan" untuk menemukan Account SID dan Auth Token Anda. Kredensial ini penting untuk mengautentikasi permintaan Anda saat berinteraksi dengan API Twilio.
- Account SID (Pengidentifikasi Akun): Ini adalah pengidentifikasi unik untuk akun Twilio Anda. Ini bertindak sebagai nama pengguna saat membuat permintaan API.
- Auth Token (Token Otentikasi): Token ini akan berfungsi sebagai kata sandi untuk mengautentikasi permintaan API Anda. Jaga keamanannya dan jangan pernah membagikannya secara publik.
- Twilio phone number: Nomor telepon ini sangat penting, ini yang akan Anda gunakan untuk mengirim SMS dan bukan nomor telepon Anda.
Dengan menyelesaikan langkah-langkah ini, Anda akan berhasil menyiapkan akun Twilio Anda, mendapatkan kredensial API Anda, dan mendapatkan nomor telepon Anda untuk pesan SMS. Sekarang Anda siap untuk mengintegrasikan Twilio dengan aplikasi Node.js Anda dan mulai mengirim pesan SMS secara terprogram.
N.B: Jika akun uji coba gratis Anda kedaluwarsa, Anda harus membeli nomor telepon yang akan Anda gunakan untuk mengirim SMS.
Jika Anda tidak ingin membeli nomor telepon untuk pengujian, pastikan untuk membuat akun Anda hanya saat Anda siap mengirim SMS Anda.
Memasang Dependensi:
Untuk mengintegrasikan fungsionalitas SMS Twilio ke dalam aplikasi Node.js Anda, Anda perlu menyiapkan proyek Node.js baru dan memasang SDK Node.js Twilio.
Sebelum kita melanjutkan dengan pemasangan dependensi, perhatikan bahwa kita tidak akan menggunakan UI apa pun atau membangun aplikasi front-end untuk menguji ini. Namun, untuk menguji ini, kita akan menggunakan Apidog alternatif yang lebih baik untuk Postman.
Apidog adalah platform terintegrasi untuk desain, debugging, pengembangan, mock, dan pengujian API.
Berikut adalah panduan bermanfaat untuk mendapatkan pemahaman penuh tentang apa itu Apidog dan cara menggunakannya sepenuhnya. Buat akun untuk mempersiapkan tahap pengujian API dari artikel ini.
Sekarang, kembali ke pengaturan Node.Js dan Twilio. Ikuti langkah-langkah ini untuk memulai:
Menyiapkan Proyek Node.js Baru:
Jika Anda belum melakukannya, buat direktori baru untuk proyek Node.js Anda dan navigasikan ke dalamnya menggunakan terminal atau command prompt Anda.
mkdir twilio-sms-demo
cd twilio-sms-demo
Menginisialisasi Proyek Node.js:
Gunakan perintah berikut untuk menginisialisasi proyek Node.js baru. Perintah ini akan membuat file package.json yang akan melacak dependensi proyek Anda.
npm init -y
Perintah ini membuat file package.json dengan nilai default. Anda dapat menyesuaikan nilai-nilai ini sesuai kebutuhan.
Memasang SDK Node.js Twilio:
Sekarang, Anda perlu memasang SDK Node.js Twilio, yang menyediakan antarmuka yang nyaman untuk berinteraksi dengan API Twilio dari aplikasi Node.js Anda. Anda dapat menggunakan npm atau yarn untuk memasang SDK.
Menggunakan npm:
Jalankan perintah berikut untuk memasang SDK Node.js Twilio bersama dengan kerangka kerja Express menggunakan npm:
npm install express twilio
Menggunakan yarn:
Jika Anda lebih suka menggunakan yarn, jalankan perintah berikut sebagai gantinya:
yarn add express twilio
Perintah ini akan mengunduh SDK Node.js Twilio bersama dengan kerangka kerja Express dan menambahkannya sebagai dependensi dalam file package.json Anda.
Jika Anda tidak tahu, Express adalah kerangka kerja node.js yang membuat pembuatan API menjadi mudah.
Memverifikasi Pemasangan:
Setelah memasang SDK Twilio, pastikan bahwa SDK tersebut telah ditambahkan ke file package.json Anda. Anda akan melihat "twilio": "^x.x.x" tercantum di bawah bagian dependencies.
Selain itu, Anda dapat memverifikasi bahwa pemasangan berhasil dengan memeriksa keberadaan direktori node_modules di proyek Anda. Direktori ini berisi semua dependensi yang dipasang, termasuk SDK Twilio.
Dengan mengikuti langkah-langkah ini, Anda telah berhasil menyiapkan proyek Node.js baru dan memasang SDK Node.js Twilio, membuka jalan untuk mengintegrasikan fungsionalitas SMS Twilio ke dalam aplikasi Anda. Sekarang, Anda siap untuk mulai menulis kode untuk mengirim pesan SMS dengan Twilio di aplikasi Node.js Anda.
Menulis Kode Node.js:
Sekarang setelah Anda menyiapkan proyek Node.js Anda dan memasang SDK Twilio, mari tulis kode untuk mengirim pesan SMS menggunakan Twilio dalam kombinasi dengan Express.
Membuat File JavaScript Baru:
Di direktori proyek Anda, buat file JavaScript baru bernama index.js (atau nama lain yang Anda sukai) tempat Anda akan menulis kode untuk mengirim pesan SMS.
touch index.js
Setelah selesai, buka direktori/folder proyek di IDE pilihan Anda. Jika Anda adalah salah satu orang yang menyukai kesederhanaan, Anda mungkin telah memasang VsCode. Buka init proyek dan Anda akan melihat sesuatu yang mirip dengan yang saya miliki di bawah ini;
Buka file index.js dan mari mulai menulis beberapa kode. Tempel kode berikut ke dalam file index.js.
const express = require('express');
const accountSid = "your_account_sid;
const authToken = "your_auth_token";
const client = require('twilio')(accountSid, authToken);
Dalam kode di atas, kita mengimpor modul express di awal file. Kita juga membuat dua konstanta (const) yang menyimpan accountSid & authToken kita. Terakhir, kita mendefinisikan konstanta lain tempat kita mengimpor modul Twilio dan meneruskan accountSid & authToken ke dalamnya.
Beberapa orang mungkin berpendapat bahwa yang terbaik adalah jika kita membungkus accountSid dan AuthToken dalam file .env. Anda dapat melakukan itu jika Anda mau, tetapi saya hanya akan membuat semuanya tetap sederhana di sini.
Menulis Kode untuk Mengirim Pesan SMS:
Sekarang, mari tulis kode untuk mengirim pesan SMS menggunakan metode messages.create() Twilio.
Dalam file index.js yang sama, tambahkan kode berikut di bawah apa yang pertama kali kita miliki.
const app = express()
app.post('/send-sms', (req, res) => {
client.messages
.create({
body: 'This is how receving test SMS from Twilio feels like. Init?',
from: '+122345678', // Replace with your Twilio phone number inclding the country code.
to: '+123456789' // the phone number you verified your account with.
})
.then(message => {
console.log('Message sent:', message.sid);
res.send('SMS sent successfully!');
})
.catch(error => {
console.error('Error sending SMS:', error);
res.status(500).send('Failed to send SMS');
});
});
const PORT = 3000;
app.listen(PORT, () => {
console.log(`Server is running on port ${PORT}`);
});
Dalam kode ini:
- Kita membuat aplikasi Express dan mendefinisikan rute POST
/send-smsuntuk menangani pengiriman pesan SMS. - Kita kemudian menginisialisasi klien Twilio dengan kredensial Twilio kita.
- Menggunakan klien Twilio, kita mengirim pesan SMS ke nomor telepon penerima yang ditentukan (
to) dengan isi pesan yang disediakan (body).
Itu saja! Anda sekarang telah menulis kode Node.js untuk mengirim pesan SMS menggunakan Twilio dan Express. Jangan lupa untuk mengganti 'from' & 'to' dengan nomor telepon Twilio Anda dan nomor telepon yang diverifikasi.
Simpan file, buka terminal Anda, dan ketik node index.js dan klik enter. Jika semuanya berjalan dengan baik, Anda akan melihat sesuatu yang mirip dengan;
Menguji API Kita:
Jika Anda ingat, saya menyebutkan bahwa kita akan menggunakan Apidog untuk menguji API kita untuk melihat apakah mereka bekerja seperti yang diharapkan. Jadi, silakan unduh atau gunakan versi web Apidog untuk menguji API yang baru saja kita buat.
Sekali lagi, berikut adalah panduan yang akan menunjukkan kepada Anda cara memulai dengan Apidog.
Sekarang setelah Anda terbiasa dengan Apidog, masuk dan buat proyek pertama Anda - atau gunakan default yang dibuat secara otomatis untuk Anda. Setelah itu, klik "Permintaan Baru"
Setelah itu, Anda akan diperlihatkan halaman untuk mengirim permintaan.
Anda dapat melihat bahwa saya mengirim permintaan POST ke localhost:3000/send-sms dan itu karena rute yang kita definisikan di aplikasi web kita adalah /send-sms dan kita menggunakan mesin lokal kita.
Jika Anda mengetik rute yang benar dan menekan tombol kirim di kanan atas, Anda akan menerima respons. Dalam kasus saya, saya mendapat kesalahan - dan kesalahan itu dicatat kepada saya di terminal saya.
Kesalahannya sederhana, nomor telepon yang saya coba kirimi SMS tidak diverifikasi - karena saya menggunakan akun uji coba, saya perlu memverifikasi nomor saya atau meningkatkan untuk mengirim SMS ke nomor telepon mana pun.
Salah satu fitur keren dari Twilio adalah Anda dapat melihat log dan riwayat Anda. Saya melihat milik saya, dan mendapat respons berikut;
Semua API pengujian saya gagal. Bisakah Anda menebak mengapa?to phone number saya tidak diverifikasi;
Setelah Anda memverifikasi atau meningkatkan akun Anda ke akun berbayar, Anda akan dapat menerima SMS.
Meningkatkan Aplikasi (Opsional):
Setelah Anda berhasil menerapkan pengiriman pesan SMS dengan Twilio dan Node.js, Anda mungkin ingin menjelajahi fitur tambahan dan meningkatkan keandalan aplikasi Anda. Berikut adalah beberapa peningkatan opsional yang dapat Anda pertimbangkan:
Menjelajahi Fitur Twilio Tambahan:
Twilio menawarkan berbagai fitur di luar pesan SMS sederhana. Anda dapat menjelajahi kemampuan seperti:
- Mengirim MMS: Tingkatkan pesan Anda dengan mengirim konten multimedia seperti gambar, video, dan file audio.
- Menjadwalkan Pesan: Jadwalkan pesan SMS untuk dikirim pada tanggal dan waktu tertentu, ideal untuk pengingat dan notifikasi.
Kesimpulan:
Dalam tutorial ini, kita telah menjelajahi cara mengintegrasikan fungsionalitas SMS Twilio dengan Node.js, memungkinkan Anda mengirim pesan SMS secara terprogram dari aplikasi Anda. Mari rekap langkah-langkah utama yang terlibat:
Menyiapkan Akun Twilio: Mendaftar untuk akun Twilio, mendapatkan kredensial API Anda (Account SID dan Auth Token), dan memverifikasi nomor telepon untuk pesan SMS.
Memasang Dependensi: Menyiapkan proyek Node.js baru, memasang SDK Node.js Twilio, dan mengonfigurasi Twilio dengan kredensial Anda.
Menulis Kode Node.js: Membuat file JavaScript baru untuk mengirim pesan SMS, mengimpor Express dan modul Twilio, dan menulis kode untuk mengirim pesan SMS menggunakan metode messages.create() Twilio.
Menguji kode menggunakan Apidog: Kita melihat bagaimana kita dapat menggunakan alat pengembang seperti Apidog untuk menguji API Node.js kita dengan mudah tanpa stres.
Dengan mengikuti langkah-langkah ini, Anda telah mempelajari cara memanfaatkan API Twilio yang kuat bersama dengan fleksibilitas Node.js untuk memasukkan fungsionalitas SMS ke dalam aplikasi Anda. Saat Anda terus mengembangkan proyek Anda, jangan ragu untuk menjelajahi lebih lanjut fitur Twilio dan menyesuaikan aplikasi Anda untuk memenuhi kebutuhan spesifik pengguna Anda.
Selamat membuat kode!
