Uygulamanız için push bildirim: tek API, tek platform
Uygulama kullanıcılarınıza SMS, WhatsApp ve RCS için kullandığınız REST API üzerinden push bildirim gönderin; uygulamayı açmamış herkese başka bir kanaldan ulaşın.
curl -X POST https://api.broadnet.me/push/message/send \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userRefs": ["user-10293"],
"title": "Your order has shipped",
"body": "Tap to track your parcel.",
"deepLink": "https://example.com/orders/8842",
"category": "UTILITY",
"priority": "HIGH",
"ttl": 3600
}'OmniChannels.ai API'sine gönderilen bir push bildirim isteği. Değerler örnek veridir.
Kısa yanıt
Güncelleme
OmniChannels.ai, mobil uygulamalar için bir push bildirim servisi ve API'sidir. POST /push/message/send uç noktasını başlık, metin ve hedef kitleyle çağırırsınız: kullanıcı kimlikleri, cihaz tokenları, konular veya bir segment. Bildirimler görsel, derin bağlantı ve işlem düğmeleri taşıyabilir, kayıtlı şablonları kullanabilir, zamanlanabilir ve önce deneme çalıştırmasıyla doğrulanabilir. Ekibimiz devreye alma sırasında Firebase Cloud Messaging projenizi ve iOS için APNs bilgilerinizi bağlar.
Push bildirim API'si neler yapar?
Kullanıcı, token, konu veya segmente göre hedefleyin
Kendi kullanıcı kimliklerinizi (userRefs), açık FCM cihaz tokenlarını, FCM konularını veya ülke, şehir, dil ve etiketlerle tanımlı bir segmenti hedefleyin.
Zengin bildirimler
HTTPS görseli, dokunulunca açılan bir derin bağlantı ve Onayla ya da Yeniden planla gibi işlem düğmeleri ekleyin.
Kayıtlı şablonlar
Şablonları sürüm geçmişiyle oluşturun, önizleyin, deneme olarak gönderin ve yayımlayın; ardından templateId ve kendi değişkenlerinizle gönderin.
Öncelik, geçerlilik süresi ve zamanlama
Zamana duyarlı mesajları yüksek öncelikli işaretleyin, geçerlilik süresi (TTL) belirleyin, eski bildirimleri collapse key ile değiştirin veya gönderimi zamanlayın.
Göndermeden önce deneme çalıştırması
dryRun değerini true yapın; hiçbir gerçek kullanıcıya iletmeden isteği baştan sona doğrulayın.
Toplu gönderim kontrolü
Batch uç noktalarıyla gönderim gruplarını listeleyin, ayrıntılarını okuyun, duraklatın, sürdürün veya iptal edin.
Konuma göre tetiklenen bildirimler
Coğrafi çitler (geofence) bildirimleri konuma göre tetikleyebilir. Ekibimiz uygulamanız için geofencing'i talep üzerine etkinleştirir.
İletim durumları webhook ile
İletim durumlarını, diğer kanallarda olduğu gibi hesabınızda tanımlı webhook URL'sinden izleyin.
Push, SMS veya WhatsApp: hangisini kullanmalısınız?
Push, uygulamanızı yüklemiş kişilere ulaşır. SMS ve WhatsApp ise bir telefon numarasına ulaşır. Çoğu işletme üçünü de kullanır; her mesaj için tercih sırası aşağıdaki gibidir.
| Kanal | Ulaştığı kişiler | En uygun kullanım | Not |
|---|---|---|---|
| Push bildirim | Uygulamanızı yükleyip bir cihaz kaydetmiş kullanıcılar | Uygulama içi hareketler: sipariş durumu, hatırlatmalar, uygulama içi teklifler, yeniden etkileşim | Kullanıcı uygulamanızdayken ilk adım olarak kullanın. |
| Telefon numarasıyla ulaşılan, izin vermiş müşteriler | Zengin konuşmalar, şablonlar, destek ve makbuzlar | Konuşma veya medya gerektiğinde kullanın. | |
| SMS | Her cep telefonu numarası | OTP kodları, acil uyarılar ve uygulaması ya da WhatsApp'ı olmayan müşteriler | Evrensel yedek kanal olarak kullanın. |
Push bildirim göndermeye nasıl başlanır?
Push, Firebase Cloud Messaging ve iOS için Apple'ın APNs altyapısı üzerinde çalışır; bu yüzden önce kısa bir devreye alma adımı vardır.
- 1
Uygulamanızı bağlayın
Ekibimiz Firebase Cloud Messaging projenizi ve iOS için APNs bilgilerinizi bağlar, size uygulama kimliğinizi (app ID) verir.
- 2
Cihazları kullanıcı kimliklerinizle kaydedin
Uygulamanız her cihazı kendi tanımlayıcınız olan userRef ile kaydeder; böylece tokenlara değil kişilere gönderirsiniz.
- 3
Yükü deneme çalıştırmasıyla kontrol edin
POST /push/message/send uç noktasını dryRun true ile çağırın ve gerçek kullanıcılar bir şey görmeden isteğin geçerli olduğunu doğrulayın.
- 4
Gönderin veya zamanlayın
userRefs, tokenlar, konular ya da bir segmente gönderin veya gönderimi zamanlayın. Tekrarlayan mesajları şablon olarak kaydedin.
- 5
Yedek kanal ekleyin
Hangi mesajların ikinci bir kanala ihtiyacı olduğuna karar verin; örneğin OTP veya teslimat uyarısı için SMS. Sırayı kullanım senaryosu bazında belirleyin.
Push ne zaman doğru kanaldır?
Şu durumlarda iyi bir seçim
- Mobil uygulamanız var ve telefon numaralarına ihtiyaç duymadan yüklü kullanıcılara ulaşmak istiyorsunuz.
- Mesajlar sipariş durumu, randevu hatırlatması veya hesap uyarısı gibi uygulama hareketlerine bağlı.
- Push, SMS, WhatsApp ve diğer kanallar için tek API ve tek webhook biçimi istiyorsunuz.
- Cihaz tokenlarını yönetmek yerine kendi kullanıcı kimliğinizle göndermek istiyorsunuz.
Başlamadan önce bilmeniz gerekenler
- Push yalnızca uygulamanızı yükleyen ve bildirimlere izin veren kişilere ulaşır.
- Dokümante edilen API, FCM ve APNs üzerinden mobil uygulama push'unu kapsar. Bunun ötesindeki her şey için plan yapmadan önce ekibimize danışın.
- OTP kodları veya kritik uyarılar için yalnızca push'a güvenmeyin: yedek olarak SMS veya sesli arama ekleyin.
- Geofencing, uygulamanız için talep üzerine etkinleştirilir.
Push bildirim servisi soruları
Push bildirim servisi nedir?
Push bildirim servisi, sunucularınızdan kullanıcıların cihazlarına, uygulama kapalıyken bile kısa mesajlar iletir. Android'de iletim Firebase Cloud Messaging, iOS'ta Apple'ın APNs'i üzerinden yapılır. OmniChannels.ai gibi bir servis ikisinin önünde durur ve size çağıracağınız tek bir API sunar.
Push bildirim API'si nasıl çalışır?
Uygulamanız her cihazı bir token ile kaydeder. Ardından arka ucunuz hedef kitle ve içerikle API'yi çağırır; servis bildirimi iletim için FCM veya APNs'e devreder. OmniChannels.ai'de POST /push/message/send uç noktasını çağırır ve kullanıcıları kendi kullanıcı kimliklerinizle hedefleyebilirsiniz.
Push bildirim ile SMS arasındaki fark nedir?
Push, uygulamanızı yükleyip bildirimlere izin vermiş kişilere ulaşır ve veri bağlantısı gerektirir. SMS ise uygulama olmadan her cep telefonu numarasına ulaşır. Push uygulama içi güncellemelere ve etkileşime uygundur. SMS ise OTP kodları, acil uyarılar ve uygulamanız olmayan müşteriler için uygundur.
Kullanıcı segmentine push bildirim gönderebilir miyim?
Evet. Kullanıcı kimliklerine, cihaz tokenlarına ve konulara ek olarak API, ülke, şehir, dil ve etiket gibi ölçütler içeren bir segment nesnesini uygulama kimliğinizle birlikte kabul eder. Gönderimi zamanlayabilir ve bir kampanya adıyla etiketleyebilirsiniz.
Push bildirimi göndermeden önce test edebilir miyim?
Evet. dryRun değerini true yapın; hiçbir şey iletilmeden istek doğrulanır. Şablonlarda bir sürümü yayımlamadan önce örnek verilerle önizleme yapabilir ve kendi cihazınıza deneme gönderebilirsiniz.
Görsel, bağlantı ve düğme ekleyebilir miyim?
Evet. Bildirimler HTTPS görseli, dokunulunca açılan derin bağlantı, uygulamanız için özel veri ve her biri kimlik, başlık ve eylem içeren işlem düğmeleri taşıyabilir. Yalnızca veri içeren ve sessiz mesajlar da gönderebilirsiniz.
Kullanıcı uygulamayı açmadıysa veya bildirimleri kapattıysa ne olur?
Push o kişilere ulaşamaz. Önemli mesajlar için SMS veya WhatsApp gibi başka bir kanala yedek tanımlayın. Yedek sırası kullanım senaryosu bazında belirlenir ve iletim durumları tek bir webhook biçiminde gelir.
Nasıl başlarım?
Demo talep edin. Ekibimiz devreye alma sırasında Firebase projenizi ve APNs bilgilerinizi bağlar, size uygulama kimliğinizi verir; ardından token'ınızla API'yi çağırabilirsiniz. Geliştirici dokümantasyonu tüm push uç noktalarını listeler.
Bu konudaki rehberler
- OmnichannelKanal Yedekleme Stratejisi: WhatsApp, RCS ve SMS12 dk okuma
- SMS ve OTPWhatsApp, SMS ve RCS: OTP ve Pazarlama İçin Hangi Kanal?8 dk okuma
- EntegrasyonMesajlaşma API Entegrasyonu: REST, SMPP ve Webhook9 dk okuma
- UyumlulukWhatsApp, SMS ve E-posta Kampanyalarında Opt-in ve İzin8 dk okuma
- OmnichannelOmnichannel Mesajlaşma Nedir? Mimari, Örnekler, Faydalar10 dk okuma
Platformun diğer özelliklerini keşfedin
Mesajlaşma altyapınıza push ekleyin
Uygulamanızı bize anlatın. FCM ve APNs'i bağlayalım, push'u SMS ve WhatsApp'ın yanında gösterelim.
Yazılım yığınınızı ve neyi bağlamak istediğinizi paylaşın. Bir çözüm mühendisi sizinle iletişime geçecek.