Laravel Expo Push Notification

Yakın zaman da Laravel ve React Native teknolojilerini kullanarak bir uygulama geliştiriyoruz. React Native’in yanında yardımcı olarak Expo kullanıyoruz ve Expo’nun sundukları gerçekten inanılmaz.
Uygulamamıza Push Notification entegre etmek istediğimizden dolayı Expo’nun Push API’nı kullanmaya karar verdik. İnternette yeterli türkçe kaynak göremedim ve hatta hiç göremedim diyebilirim. O yüzden Laravel üzerinde kendi sistemime entegre ettikten sonra paylaşıp tecrübelerimi anlatmaya karar verdim. Laravel kullanmayanlar korkmasın, çünkü aslında dümdüz PHP yazdım ve kendi class’ımı oluşturup kullandım. Anlatacağım şey herhangi bir Laravel paketi değil yani. Expo’nun dökümanında önerdiği PHP kütüphanesini kullanacağız.
Mantık:

Öncelikle Push Notification mantığı çok basit bir şekilde anlatılmış dökümanda. Frontend arkadaş, kullanıcıdan bildirim izni aldıktan sonra kullanıcıya özel, unique olan Expo push token’ını alır. Bu unique token’ı aldıktan sonra oluşturduğunuz message ve data ile Expo’nun sunucusuna gönderirsiniz. Bu oluşturulan token’lar aynı zaman da Expo’da mevcut olacağı için kendi içinde eşleştirip ilgili cihazlara gönderir. Çünkü bu token’lar o cihazlara özel olarak oluşturulur.
Peki nedir bu message ve data? Expo Push API bizden hangi parametreleri ister?
Dökümanından bakabilirsiniz ama ben yine de özet geçmek istiyorum. Aslında PHP de sık sık kullandığımız PHPMailer kütüphanesiyle veya Laravel’in Mail class’ı ile neredeyse hiçbir farkı yok diyebilirim. Parametreler şöyle:
to: Gönderilecek kişinin token’ı. Bir veya birden fazla token alabilir. Array veya string olarak gönderebilirsiniz.
title: Hani şu her gün telefonumuza gelen bildirimlerin üst başlığı. Normal string alır.
body: Yine her gün her gün telefonumuza düşen bildirimlerin açıklama kısmı. Burası da string ister.
data: Tabiki de gönderdiğiniz bildirimlerin yanında data’da gönderebilirsiniz. Örneğin frontend’inizden bildirime tıkladığında gitmesini istediğiniz profilin id’sini data içerisinde gönderebilirsiniz. Böylece expo tarafında frontend bunu yakalayabilir ve buna göre yönlendirme yapabilir. Bu konuda hayal gücü sınırsız.
ttl: Ben kullanmadım, hiçbir uygulamada da kullanıldığını görmedim fakat bu gönderdiğiniz bildirime ömür biçmenize yarıyor kısacası. Tarayıcıda kullandığımız cookie’ler gibi düşünün. Onlara da belli bir zaman verip daha sonra kendi kendine silinmesini sağlayabiliyorduk. Aynı mantık.
sound: Gönderdiğiniz bildirimde ses çaldırmak için. Ben default olarak gönderiyorum. Özel sesleri desteklemiyor Expo’nun dediğine göre. Belki başka yolları vardır.
Daha bir çok parametresi var ama en önemlisi bunlar. Daha ayrıntılı olarak dökümanından bakabilirsiniz.
Paket Kullanımına Geçelim: ctwillie/expo-server-sdk-php
Tabi siz dümdüz Expo’nun dökümanında sunduğu Curl ile de işlemlerinizi yapabilirsiniz fakat daha temiz kod sunan bir kütüphanemiz varken neden curl kullanmak isteyesiniz?
use kullanarak Expo ve ExpoMessage class’larımızı dahil ediyoruz.
use ExpoSDK\Expo;
use ExpoSDK\ExpoMessage;
Mesajımızı gönderirken iki seçeneğimiz var. metot olarak setTitle şeklinde gönderebilirsiniz:
$message = new ExpoMessage();
$message->setTitle('Facebook')
->setBody('Bir yeni yorumunuz var.')
->setData(['id' => 1])
->setChannelId('default')
->playSound();
veya direkt nesnemizin içine “title” olarak array içinde gönderebilirsiniz. Ben array olarak göndermeyi tercih ediyorum:
$messages = [
new ExpoMessage([
'title' => "Instagram",
'body' => "5 Beğeniniz var.",
"to" => $friendToken,
"sound" => "default",
"data" => $data
]),
];
Bence daha düzenli. Bu arada benim yaptığım gibi “to” parametresini direkt Message içinden gönderebilirsiniz. Eğer tek bir kişiye göndermek istiyorsanız bu daha düzenli.
Daha sonrasında mesajımız hazırsa gönderme işlemine geçiyoruz. Bunu da Expo class’ındaki send fonksiyonuna $messages array’imizi göndererek yapıyoruz ve en son push() metodumuzu ekliyoruz:
(new Expo)->send($messages)->push();
Birden fazla kişiye aynı bildirimi göndermek için to kullanabiliriz. Bildiğiniz gibi to array alabiliyordu:
$tokens = ["token1", "token2", "token3"];
(new Expo)->send($messages)->to($tokens)->push();
İşte bu kadar! Sadece bu işlemlerle uygulamanızda Push Token’ı entegre etmiş oldunuz.
Ek Olarak:
Brom iyi güzel de bu channel id muhabbeti nedir? Android neden bunu istiyor?
Öncelikle channel id zorunlu göndermeniz gereken bir parametre değil. Direkt “default” şeklinde gönderebilirsiniz. Peki nedir bu?
Android’de tarafında IOS’tan ziyade bildirim tiplerini Android’in kendi ayarlar kısmındaki uygulama ayarlarına ekleyebiliyorsunuz. Ancak IOS’ta böyle bir seçenek şu anlık yok kullanıcılar ayarlardan sizin uygulamanıza girip sadece genel bildirimleri direkt kapatabilir. Ancak Android tarafında channel id’lerinizi oluşturursanız, kullanıcı bu kısımdan sunduğunuz bildirim tiplerini kapatıp açabilir:

Expo Push Notification ile ilgili anlatacaklarım bu kadardı. Bir hatam olmuşsa affola. Teşekkürler.
Kaynakça
https://docs.expo.dev/push-notifications/sending-notifications