Kaynaklar · Geliştirici Merkezi

Uygulama Bildirimi

Yerel uygulamanızı bir SocialHub gönderim kanalına dönüştürün. Üyeler, uygulama içi üye merkezinden bir cihaz belirteci kaydeder; ardından push bildirimi, e-postalarınızı gönderen aynı otomasyon ve kampanya motoruna katılır - açık kalma özelliği olan bir kanal şelalesi ve paylaşılan bir sıklık sınırı ile.

Token kaydı ve gönderim yığını bağlantısı bugün kodda canlı olarak çalışıyor. Gerçek push dağıtımı, her ekip için kontrollü bir etkinleştirme bayrağı arkasında devreye alınır — FCM/APN kimlik bilgileriniz yapılandırıldıktan sonra SocialHub ekibinizden bunu açmalarını isteyin.

Nasıl çalışır

Bir cihaz jetonunu kaydetmeCanlı

Oturum açmış bir üyenin uygulaması FCM/APNs token'ını POST eder. Tekrarlanabilir UPSERT — her başlatmada ve işletim sistemi token rotasyonunda çağrılması güvenlidir.

Push, gönderme yığınına katılırCanlı

Push, e-postayla aynı otomasyon/kampanya motorunda yer alan bir kanaldır; ayrı bir API değil. Tek yolculuk, üye başına seçilen kanal.

Kanal şelalesi + bir kapakCanlı

Tek bir paylaşılan frekans sınırı ile başarısız açılma şelalesi (push → e-posta → …), böylece bir üye asla kanallar arasında çift mesaj almaz.

Teslimat etkinleştirmeYaygınlaştırma

Kayıt ve gönderme dikişi bugün kodlanmıştır; Gerçek itme dağıtımı, takım başına kontrollü bir bayrağın arkasında gerçekleştirilir. SocialHub ekibinizden bunu etkinleştirmesini isteyin.

Bir cihaz jetonunu kaydetme Canlı

Bunu oturum açmış üye WebView'ından çağırın (tüketici oturum çerezi kimliği taşır). Bu oturumu oluşturan WebView SSO akışı için Üye Portalı Gömme kılavuzuna bakın.

// The member must be signed in (consumer session cookie, set by the WebView SSO
// flow). teamId + memberId are taken from the SESSION — never the request body —
// so there is no member-enumeration surface here.
POST https://flash.socialhub.ai/api/consumer/push/register
Content-Type: application/json

{
  "platform": "ios",             // "ios" | "android"
  "provider": "fcm",             // "fcm" (default) | "apns"  — optional
  "token": "<device push token>",
  "appBundleId": "com.yourbrand.app"   // optional
}
// → 200  { "ok": true }
//   Idempotent UPSERT keyed on (team, token): re-registering the same device
//   simply re-points it at the current member. Call it on every app launch and
//   whenever the OS rotates the token.

Gönderme: push bir kanaldır, API çağrısı değildir

// You do NOT call a "send push" endpoint. Push is a CHANNEL inside the existing
// automation + campaign send stack — the same engine that sends email. When a
// journey or campaign targets a member:
//
//   1. SocialHub resolves the member's channels in a waterfall (fail-open):
//        push (if a token + consent exist)  →  email  →  …
//   2. One SHARED frequency cap applies across channels, so a member is never
//      double-messaged on push AND email for the same step.
//   3. No token / no consent / push disabled  →  silently falls back to email.
//
// Net: you author one journey; SocialHub picks the best channel per member.

Pazarlamacılar, kod yazmadan push bildirimini oluştururlar: görsel kampanya tuvalinde (E-posta'nın yanında) bir Push adımı, yapay zeka tarafından oluşturulan metin, e-posta ile aynı birleştirme etiketleri ve yeniden kullanılabilir push şablonları ile. Oluşturdukları her şey kampanyanın push içeriği olur ve yukarıdaki gönderim yolu bunu iletir; uygulamanız yalnızca cihaz belirteçlerini kaydeder.

Canlıya geçmeden önce

FCM (Firebase aracılığıyla Android + iOS)

Firebase hizmet hesabı kimlik bilgilerinizi SocialHub ekibinize sağlayın. Gönderme, varsayılan sağlayıcı olan FCM HTTP v1 (bir hizmet hesabı aracılığıyla OAuth) aracılığıyla yapılır.

APN'ler (isteğe bağlı, doğrudan)

iOS'a doğrudan APN'ler üzerinden gönderim yapıyorsanız APN kimlik doğrulama anahtarınızı (.p8), Anahtar Kimliğinizi ve Ekip Kimliğinizi sağlayın. Bu cihazları sağlayıcıya kaydedin: "apns".

Onay

Anlık bildirimler, açık üye onayı ve Küresel Gizlilik Kontrolü sinyali (başarısız-kapalı) ile kontrol edilir. Aktif anlık bildirim onayı olmayan bir üye atlanır - şelale e-postaya geri döner.

Kabul kontrol listesi

Aynı cihazın iki kez kaydedilmesi bir kopya oluşturmaz; UPSERT, cihazı mevcut üyeye yeniden yönlendirir.

Geçerli bir token'a sahip, onay vermiş bir üye bildirim alır; token/onay almamış bir üye ise bunun yerine e-posta yedeklemesi alır — asla hiçbir şey, asla ikisi birden olmaz.

Anlık bildirim izninin (veya Küresel Gizlilik Kontrolü sinyalinin) iptal edilmesi, üyeyi hemen e-posta kanalına düşürür.

Bildirimleri etkinleştiriyor musunuz?

FCM/APN kimlik bilgileri, gönderme kanalı şelalesi veya ekibiniz için teslimatın etkinleştirilmesi hakkında bir mühendisle konuşun.

Mühendislikle konuş