Ana içeriğe atla
Bu sayfa, gerçek bir uygulamayı baştan sona takip eden Örnek uygulama: eksiksiz bir OneSignal entegrasyonu kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan Clean Beans’tir ve Expo (React Native) ile bir Supabase backend’i kullanılarak geliştirilmiştir. Clean Beans, SMS’i push ve e-postanın iyi yapamadığı iki iş için kullanır: bir telefon numarasının onu yazan kişiye ait olduğunu kanıtlamak ve henüz uygulaması olmayan birine ulaşmak. Her ikisi de bir External ID’ye değil, bir telefon numarası veya e-posta adresi olan ham bir iletişim bilgisine gönderilir. Bu kılavuzdaki diğer tüm gönderimlerden temel fark budur.

Tek kullanımlık bir kodla telefon numarasını doğrulayın \

User Profile’da kullanıcı bir cep telefonu numarası ekleyebilir. Uygulama backend’den 6 haneli bir kodu SMS ile göndermesini ister, kullanıcı kodu yazar ve backend kontrol eder. Numara ancak bundan sonra doğrulanmış sayılır.
Üç durumdaki telefon numarası kartı: numara girme, kod girme ve doğrulandı

Telefon numarası ekleme: numarayı girin, kodu girin, doğrulandı.

OneSignal kısa mesajı teslim eder. Kodu oluşturmaz veya kontrol etmez. Geri kalan her şey backend’inizin işidir.
1

Bir kod oluşturun ve karma olarak saklayın

Kod kriptografik bir rastgele kaynaktan gelir. Yalnızca kullanıcıya ve telefon numarasına bağlı, anahtarlı bir karma saklanır, böylece tablo tek başına kodlara geri dönüştürülemez. Anahtar, başka hiçbir şey için kullanılmayan özel bir gizli anahtar olan OTP_HASH_SECRET’tır. Ayarlanmamışsa her iki fonksiyon da çalışmayı reddeder.
supabase/functions/_shared/otp.ts
supabase/functions/send-otp/index.ts
2

Kodu OneSignal üzerinden SMS ile gönderin

include_phone_numbers numarayı doğrudan hedefler. OneSignal numarayı daha önce hiç görmediyse onun için bir SMS aboneliği oluşturur.
supabase/functions/send-otp/index.ts
3

Kodu kontrol edin

Backend kullanıcının yazdığının karmasını alır ve saklanan karmayla karşılaştırır. Her yanlış tahmin sayılır. Beş yanlış denemeden sonra kod geçersiz olur ve yeni bir kod istenmesi gerekir.
supabase/functions/verify-otp/index.ts
4

Numarayı bir SMS aboneliği olarak kaydedin

Backend kodu onayladığında uygulama numarayı oturum açmış kullanıcıya ekler.
src/lib/phone.ts
Uygulama bunu her oturum açmadan sonra tekrarlar, böylece doğrulanmış bir numara kullanıcıyı yeni bir cihaza kadar takip eder.
src/lib/phone.ts
E-postada olduğu gibi addSms() yöntemini login() sonrasında çağırın. Ham bir telefon numarasına yapılan gönderim, kimseye ait olmayan bir abonelik oluşturur. Oturum açılmış bir uygulamadan çağrılan addSms(), bu aboneliği kullanıcıya bağlar. O zamana kadar abonelik kontrol panelinde ayrı bir kullanıcı kaydı olarak görünür.

Uç noktayı koruyun \

İstek üzerine kısa mesaj gönderen bir fonksiyon her çalıştığında para harcar ve kötüye kullanım için bir hedeftir. Clean Beans şu sınırları uygular.
supabase/functions/send-otp/index.ts
Doğrulanmış numara kendi tablosunda saklanır. Bu tabloya yalnızca backend yazabilir, bu yüzden uygulama bir numarayı doğrulanmış olarak işaretleyemez ve hanenin diğer üyeleri onu okuyamaz.
supabase/migrations/028_phone_verification_and_invites.sql
Bir telefon numarası tek başına ona mesaj gönderme izni değildir. Doğrulama kodları için telefon alanının yanında bir açıklama yeterlidir. Bu açıklama kimin gönderdiğini, ne göndereceğini, ücret uygulanabileceğini ve nasıl durdurulacağını belirtmelidir.
src/components/PhoneVerificationCard.tsx

Henüz kullanıcı olmayan birini davet edin \

Household ekranında bir üye, birini SMS veya e-postayla davet edebilir. Davet edilen kişinin hesabı, kayıtlı bir cihazı ve External ID’si yoktur. Backend, uygulamanın katılma ekranını açan bir bağlantıyla ham iletişim bilgisine gönderim yapar.
Davet iletişim kutusu ve gönderdiği davet kısa mesajı

Bir ev arkadaşını SMS veya e-postayla davet etme ve aldığı mesaj.

Aynı uç nokta her iki kanalı da işler. SMS include_phone_numbers kullanır. E-posta, konu ve HTML gövdesi doğrudan isteğe eklenerek email_to kullanır.
supabase/functions/send-invite/index.ts
Bağlantı, Uygulamayı sıradan web bağlantılarından açın bölümünde kurulan bir Universal Link’tir. İki ayrıntı onun çalışmaya devam etmesini sağlar:
  • E-posta tıklama izleme kapalıdır. İzleme, bağlantıları bir izleme alan adından geçecek şekilde yeniden yazar ve yeniden yazılmış bir bağlantı artık uygulamayı açmaz.
  • SMS izlenen bir kısa bağlantı kullanmaz, aynı nedenle.
Davet edilen kişi uygulamayı yükleyip oturum açtığında, uygulamanın login() ile addEmail() veya addSms() çağrıları, davetin oluşturduğu aboneliği yeni kullanıcısına bağlar.
Davet edilen kişi uygulamanızdan mesaj almayı kabul etmemiştir. İstenmeyen SMS ve e-postalara ilişkin kurallar ülkeden ülkeye değişir ve katı olabilir. Clean Beans bu akışı ham bir iletişim bilgisine gönderimin nasıl çalıştığını göstermek için içerir ve her üyeyi günde on davetle sınırlar. Bu kalıbı üretimde kullanmadan önce gönderim yaptığınız yerlerin kurallarını kontrol edin ve mesajın davet eden kişi tarafından kendi telefonundan gönderilmesini değerlendirin.

Bilinmesi gerekenler \

  • Bir gönderici gereklidir. Settings > SMS bölümünde varsayılan bir gönderici seçin veya her istekle sms_from iletin. İkisi de yoksa istek “A valid number is required for ‘From’ field” hatasıyla reddedilir.
  • 200 yanıtı her zaman bir mesajın gönderildiği anlamına gelmez. Yalnızca durum koduna değil, yanıtta bir mesaj id değeri olup olmadığına da bakın.
  • Numaraları E.164 biçiminde saklayın. Bu biçim, artı işaretinin ardından ülke kodu ve numaradan oluşur. API’yi çağırmadan önce başka her şeyi reddedin.
  • OneSignal Verify yönetilen alternatiftir. Kodları sizin için oluşturur ve kontrol eder. Clean Beans tüm akışı göstermek için kendi çözümünü oluşturur.
Kontrol paneli kurulumu. SMS kurulumunu tamamlayın ve kullanıcılarınızın bulunduğu ülkelere ulaşabilen varsayılan bir gönderici seçin.

Tek kullanımlık şifreler

OneSignal Verify ve kendi çözümünüzü oluşturma.

SMS izni ve toplama

İzin ve açıklama gereksinimleri.

SMS API referansı

Tüm SMS parametreleri.