Günümüzün birbirine bağlı dünyasında iletişim çok önemlidir ve en yaygın iletişim biçimlerinden biri mütevazı kısa mesajdır. Bildirimler, uyarılar veya tanıtım mesajları göndermek olsun, SMS (Kısa Mesaj Servisi) mesajlarını programlı olarak gönderme yeteneği, geliştiriciler için bir dünya dolusu olanak sunar. Geliştiricilerin SMS işlevselliğini uygulamalarına sorunsuz bir şekilde entegre etmelerini sağlayan bir bulut iletişim platformu olan Twilio'ya girin.
Giriş:
Bu eğitimde, SMS mesajlarını zahmetsizce göndermek için Twilio'nun gücünü Node.js'nin esnekliğiyle nasıl birleştireceğimizi inceleyeceğiz. Node.js, engellemeyen G/Ç modeli ve zengin paket ekosistemi ile ölçeklenebilir ve verimli uygulamalar oluşturmak için ideal bir ortam sağlarken, Twilio SMS mesajları göndermeyi ve almayı, teslimatı yönetmeyi ve telefon numaralarını yönetmeyi basitleştirir.
İster bir bildirim sistemi geliştiriyor, ister bir müşteri destek sohbet robotu oluşturuyor veya sadece uygulamanıza SMS işlevselliği eklemek istiyor olun, bu eğitim sizi adım adım süreç boyunca yönlendirecektir. Sonunda, SMS mesajlarını güvenilir ve güvenli bir şekilde göndermek için Twilio'nun API'sini Node.js ile nasıl kullanacağınız konusunda sağlam bir anlayışa sahip olacaksınız.
Öyleyse, dalalım ve Twilio'nun SMS yetenekleriyle Node.js uygulamalarınızı nasıl güçlendireceğinizi öğrenelim!
Bir Twilio Hesabı Kurma:
Twilio ve Node.js ile SMS mesajları göndermeden önce, ilk adım bir Twilio hesabı oluşturmaktır.
Twilio, size atayacakları ücretsiz bir numara ile SMS göndermek gibi tüm hizmetlerini test etmek için kullanabileceğiniz ücretsiz bir deneme sürümü sunar.
Ancak başlamak için ücretsiz bir hesap açın.
Bir Twilio Ücretsiz Hesabına Kaydolun:
Twilio web sitesine (https://www.twilio.com/) gidin ve henüz yapmadıysanız yeni bir hesaba kaydolun. Kayıt işlemi basittir ve yalnızca e-posta adresiniz, tam adınız ve şifreniz gibi temel bilgileri gerektirir.
E-posta Adresinizi Doğrulayın:
Twilio'ya göre
Bu doğrulama, Twilio platformunun kötüye kullanılmasını önlemeye yardımcı olur ve telekomünikasyon düzenlemelerine uyumu sağlar.
Kaydolduktan sonra, Twilio kayıt sırasında sağladığınız adrese bir doğrulama e-postası gönderecektir. E-postanızdaki doğrulama bağlantısına tıklayarak e-posta adresinizi onaylayın ve Twilio hesabınızı etkinleştirin.
Telefon Numarası Doğrulaması:
Bu, Twilio'nun kimliğinizi doğrulamasına yardımcı olur ve ayrıca deneme modundayken Twilio hesabınızdan telefonunuza test mesajları göndermenize olanak tanır.
E-postanızı doğruladıktan sonra, telefon numaranızı doğrulamanız istenir. Twilio, konumunuzu I.P.'nizi kullanarak otomatik olarak algılar. Hesabınızı ülkeniz içinde doğrulayabileceğiniz bir numara kullanarak oluşturduğunuzdan emin olun.
Twilio Kontrol Panelinize Erişin:
Hesabınız doğrulandıktan sonra, Twilio Konsolu'na erişmek için Twilio hesabınıza giriş yapın. Konsol, Twilio hizmetlerinizi, telefon numaralarınızı ve API kimlik bilgilerinizi yöneteceğiniz yerdir.
Twilio API Kimlik Bilgilerini Edinin:
Twilio Konsolu'nda, Hesap SID'nizi ve Kimlik Doğrulama Jetonunuzu bulmak için "Kontrol Paneli" veya "Ayarlar" bölümüne gidin. Bu kimlik bilgileri, Twilio API'si ile etkileşimde bulunurken isteklerinizi doğrulamak için gereklidir.
- Hesap SID'si (Hesap Tanımlayıcı): Bu, Twilio hesabınız için benzersiz bir tanımlayıcıdır. API istekleri yaparken bir kullanıcı adı görevi görür.
- Kimlik Doğrulama Jetonu (Kimlik Doğrulama Jetonu): Bu jeton, API isteklerinizi doğrulamak için bir şifre görevi görecektir. Güvende tutun ve asla kamuya açık olarak paylaşmayın.
- Twilio telefon numarası: Bu telefon çok önemlidir, SMS göndermek için kullanacağınız şey budur, telefon numaranız değil.
Bu adımları tamamlayarak, Twilio hesabınızı başarıyla kurmuş, API kimlik bilgilerinizi almış ve SMS mesajlaşması için telefon numaranızı/numaralarınızı almış olacaksınız. Artık Twilio'yu Node.js uygulamanızla entegre etmeye ve programlı olarak SMS mesajları göndermeye hazırsınız.
N.B: Ücretsiz deneme hesabınızın süresi dolarsa, SMS göndermek için kullanacağınız bir telefon numarası satın almanız gerekir.
Testler için bir telefon numarası satın almak istemiyorsanız, hesabınızı yalnızca SMS'lerinizi göndermeye hazır olduğunuzda oluşturduğunuzdan emin olun.
Bağımlılıkları Yükleme:
Twilio'nun SMS işlevselliğini Node.js uygulamanıza entegre etmek için, yeni bir Node.js projesi kurmanız ve Twilio Node.js SDK'sını yüklemeniz gerekir.
Bağımlılık yüklemelerine devam etmeden önce, bunu test etmek için herhangi bir kullanıcı arayüzü kullanmayacağımızı veya bir ön uç uygulaması oluşturmayacağımızı unutmayın. Ancak, bunu test etmek için, Apidog'u Postman'e daha iyi bir alternatif olarak kullanacağız.
Apidog, API tasarımı, hata ayıklama, geliştirme, sahte ve test için entegre bir platformdur.
Apidog'un ne olduğu ve onu en iyi şekilde nasıl kullanacağınız hakkında tam bir anlayış kazanmak için faydalı bir rehber. Bu makalenin API test aşamasına hazırlanmak için bir hesap oluşturun.
Şimdi, Node.Js ve Twilio'yu kurmaya geri dönelim. Başlamak için şu adımları izleyin:
Yeni Bir Node.js Projesi Kurma:
Henüz yapmadıysanız, Node.js projeniz için yeni bir dizin oluşturun ve terminalinizi veya komut isteminizi kullanarak içine gidin.
mkdir twilio-sms-demo
cd twilio-sms-demo
Bir Node.js Projesi Başlatma:
Yeni bir Node.js projesi başlatmak için aşağıdaki komutu kullanın. Bu komut, projenizin bağımlılıklarını izleyecek bir package.json dosyası oluşturacaktır.
npm init -y
Bu komut, varsayılan değerlere sahip bir package.json dosyası oluşturur. Bu değerleri gerektiği gibi özelleştirebilirsiniz.
Twilio Node.js SDK'sını Yükleme:
Şimdi, Node.js uygulamalarınızdan Twilio'nun API'si ile etkileşim kurmak için uygun bir arayüz sağlayan Twilio Node.js SDK'sını yüklemeniz gerekir. SDK'yı yüklemek için npm veya yarn kullanabilirsiniz.
npm Kullanımı:
Twilio Node.js SDK'sını Express çerçevesiyle birlikte npm kullanarak yüklemek için aşağıdaki komutu çalıştırın:
npm install express twilio
Yarn Kullanımı:
Yarn kullanmayı tercih ediyorsanız, bunun yerine aşağıdaki komutu çalıştırın:
yarn add express twilio
Bu komut, Twilio Node.js SDK'sını Express çerçevesiyle birlikte indirecek ve package.json dosyanızda bir bağımlılık olarak ekleyecektir.
Bilmiyorsanız, Express, API'ler oluşturmayı kolaylaştıran bir node.js çerçevesidir.
Yüklemeyi Doğrulama:
Twilio SDK'sını yükledikten sonra, package.json dosyanıza eklendiğinden emin olun. dependencies bölümünün altında "twilio": "^x.x.x" listelendiğini görmelisiniz.
Ek olarak, projenizde node_modules dizininin varlığını kontrol ederek yüklemenin başarılı olup olmadığını doğrulayabilirsiniz. Bu dizin, Twilio SDK'sı dahil olmak üzere tüm yüklü bağımlılıkları içerir.
Bu adımları izleyerek, yeni bir Node.js projesi başarıyla kurdunuz ve Twilio Node.js SDK'sını yüklediniz, Twilio'nun SMS işlevselliğini uygulamanıza entegre etmenin yolunu açtınız. Artık Node.js uygulamanızda Twilio ile SMS mesajları göndermek için kodu yazmaya hazırsınız.
Node.js Kodunu Yazma:
Artık Node.js projenizi kurup Twilio SDK'sını yüklediğinize göre, Twilio'yu Express ile birlikte kullanarak bir SMS mesajı göndermek için kodu yazalım.
Yeni Bir JavaScript Dosyası Oluşturma:
Proje dizininizde, SMS mesajları göndermek için kodu yazacağınız index.js (veya tercih ettiğiniz başka bir ad) adlı yeni bir JavaScript dosyası oluşturun.
touch index.js
İşiniz bittiğinde, proje dizinini/klasörünü seçtiğiniz herhangi bir IDE'de açın. Basitliği seven insanlardan biriyseniz, muhtemelen VsCode yüklü olacaktır. Proje başlatmayı açın ve aşağıdakine benzer bir şey görmelisiniz;
index.js dosyasını açın ve biraz kod yazmaya başlayalım. Aşağıdaki kodu index.js dosyasına yapıştırın.
const express = require('express');
const accountSid = "your_account_sid;
const authToken = "your_auth_token";
const client = require('twilio')(accountSid, authToken);
Yukarıdaki kodda, dosyanın başında express modülünü içe aktarıyoruz. Ayrıca, accountSid ve authToken'imizi tutan iki sabit ( const) oluşturduk. Son olarak, Twilio modülünü içe aktardığımız ve accountSid ve authToken'i ona geçirdiğimiz başka bir sabit tanımladık.
Bazı insanlar, accountSid ve AuthToken'i bir .env dosyasına sarmalamanın en iyisi olduğunu iddia edebilir. İsterseniz bunu yapabilirsiniz, ancak burada işleri basit tutacağım.
Bir SMS Mesajı Göndermek İçin Kodu Yazma:
Şimdi, Twilio'nun messages.create() yöntemini kullanarak bir SMS mesajı göndermek için kodu yazalım.
Aynı index.js dosyasında, önce sahip olduklarımızın altına aşağıdaki kodları ekleyin.
const app = express()
app.post('/send-sms', (req, res) => {
client.messages
.create({
body: 'Twilio'dan test SMS'i almanın nasıl bir his olduğunu işte böyle. Başlangıç?',
from: '+122345678', // Ülke kodu dahil olmak üzere Twilio telefon numaranızla değiştirin.
to: '+123456789' // hesabınızı doğruladığınız telefon numarası.
})
.then(message => {
console.log('Mesaj gönderildi:', message.sid);
res.send('SMS başarıyla gönderildi!');
})
.catch(error => {
console.error('SMS gönderilirken hata oluştu:', error);
res.status(500).send('SMS gönderilemedi');
});
});
const PORT = 3000;
app.listen(PORT, () => {
console.log(`Sunucu ${PORT} numaralı portta çalışıyor`);
});
Bu kodda:
- Bir Express uygulaması oluşturur ve SMS mesajları göndermeyi işlemek için bir POST rotası
/send-smstanımlarız. - Daha sonra Twilio kimlik bilgilerimizle bir Twilio istemcisi başlatırız.
- Twilio istemcisini kullanarak, belirtilen alıcı telefon numarasına (
to) sağlanan mesaj gövdesi (body) ile bir SMS mesajı göndeririz.
Bu kadar! Artık Twilio ve Express'i kullanarak SMS mesajları göndermek için Node.js kodunu yazdınız. 'from' ve 'to' değerlerini Twilio telefon numaranız ve doğrulanmış telefon numaranızla değiştirmeyi unutmayın.
Dosyayı kaydedin, terminalinizi açın ve node index.js yazıp enter'a tıklayın. Her şey yolunda giderse, şuna benzer bir şey görmelisiniz;
API'mizi Test Etme:
Hatırlıyorsanız, API'lerimizin beklendiği gibi çalışıp çalışmadığını görmek için API'lerimizi test etmek için Apidog kullanacağımızdan bahsetmiştim. Bu nedenle, oluşturduğumuz API'yi test etmek için lütfen Apidog'un web sürümünü indirin veya kullanın.
Bir kez daha, Apidog'a nasıl başlayacağınızı gösteren bir rehber burada.
Artık Apidog'a aşina olduğunuza göre, giriş yapın ve ilk projenizi oluşturun - veya sizin için otomatik olarak oluşturulan varsayılanı kullanın. Bundan sonra, "Yeni İstek"e tıklayın
Bundan sonra, bir istek göndermek için bir sayfa gösterilecektir.
localhost:3000/send-sms'ye bir POST isteği gönderdiğimi görebilirsiniz ve bunun nedeni, web uygulamamızda tanımladığımız rotanın /send-sms olması ve yerel makinemizi kullanmamızdır.
Doğru rotayı yazıp sağ üstteki gönder düğmesine tıklarsanız, bir yanıt alırsınız. Benim durumumda, bir hata aldım - ve hata terminal'imde bana kaydedildi.
Hata basitti, SMS'i göndermeye çalıştığım telefon numarası doğrulanmadı - deneme hesabı kullandığım için, numaramı doğrulamam veya herhangi bir telefon numarasına SMS göndermek için yükseltmem gerekiyor.
Twilio'nun harika özelliklerinden biri, günlüklerinizi ve geçmişinizi görüntüleyebilmenizdir. Benimkini görüntüledim ve aşağıdaki yanıtı aldım;
Tüm test API'lerim başarısız oldu. Nedenini tahmin edebilir misiniz?to telefon numarası doğrulanmadı;
Hesabınızı doğruladıktan veya ücretli bir hesaba yükselttikten sonra, bir SMS alabileceksiniz.
Uygulamayı Geliştirme (İsteğe Bağlı):
Twilio ve Node.js ile SMS mesajları göndermeyi başarıyla uyguladıktan sonra, ek özellikleri keşfetmek ve uygulamanızın güvenilirliğini artırmak isteyebilirsiniz. İşte düşünebileceğiniz bazı isteğe bağlı geliştirmeler:
Ek Twilio Özelliklerini Keşfetme:
Twilio, basit SMS mesajlaşmasının ötesinde çok çeşitli özellikler sunar. Aşağıdaki gibi yetenekleri keşfedebilirsiniz:
- MMS Gönderme: Egörüntüler, videolar ve ses dosyaları gibi multimedya içeriği göndererek mesajlarınızı geliştirin.
- Mesajları Zamanlama: Hatırlatıcılar ve bildirimler için ideal olan, SMS mesajlarının belirli bir tarih ve saatte gönderilmesini planlayın.
Sonuç:
Bu eğitimde, Twilio'nun SMS işlevselliğini Node.js ile nasıl entegre edeceğimizi inceledik ve uygulamalarınızdan programlı olarak SMS mesajları göndermenize olanak sağladık. İlgili temel adımları özetleyelim:
Twilio Hesabı Kurma: Bir Twilio hesabına kaydolun, API kimlik bilgilerinizi (Hesap SID'si ve Kimlik Doğrulama Jetonu) alın ve SMS mesajlaşması için telefon numaralarını doğrulayın.
Bağımlılıkları Yükleme: Yeni bir Node.js projesi kurun, Twilio Node.js SDK'sını yükleyin ve Twilio'yu kimlik bilgilerinizle yapılandırın.
Node.js Kodunu Yazma: SMS mesajları göndermek için yeni bir JavaScript dosyası oluşturun, Express ve Twilio modülünü içe aktarın ve Twilio'nun messages.create() yöntemini kullanarak SMS mesajları göndermek için kod yazın.
Apidog kullanarak kodu test etme: Node.js API'lerimizi stres yaşamadan kolayca test etmek için Apidog gibi bir geliştirme aracını nasıl kullanabileceğimizi gördük.
Bu adımları izleyerek, SMS işlevselliğini uygulamalarınıza dahil etmek için Twilio'nun güçlü API'sini Node.js'nin esnekliğiyle birlikte nasıl kullanacağınızı öğrendiniz. Projelerinizi geliştirmeye devam ettikçe, daha fazla Twilio özelliğini keşfetmekten ve uygulamalarınızı kullanıcılarınızın özel ihtiyaçlarını karşılayacak şekilde özelleştirmekten çekinmeyin.
İyi kodlamalar!
