Lumina İşletme

Müşterinize doğrulanmış adınızla ulaşın

Doğrulama kodu, sipariş durumu ya da randevu hatırlatması: yazılımınızdan tek bir istekle gönderin, müşterinizin Lumina'sına işletme rozetinizle düşsün.

Nasıl başlanır? API'ye göz atın
Ç
ÇOKKEÇECİ YAZILIMDoğrulanmış işletme
Bugün
Vorteks İçin Doğrulama Kodunuz: 482913 Vorteks Çalışanları Dahil Kimseyle Paylaşmayınız
Bu sohbet yalnızca bildirim içindir.

Güven üzerine kurulu

Müşteriniz mesajın gerçekten sizden geldiğini bilir; siz de neyin gönderilebileceğini.

İşletme doğrulaması

Başvurunuz unvan ve vergi numaranızla incelenir. Onaylanan işletmeler mavi rozetle görünür.

Onaylı şablonlar

Yalnızca önceden onaylanmış metinler gönderilir. Değişen kısımlar için {{1}}, {{2}} yer tutucuları kullanılır.

API anahtarları

Her yazılımınız için ayrı anahtar üretin, istediğiniz an iptal edin. Bir işletme en fazla 10 etkin anahtar tutabilir.

Gönderim sınırı

Varsayılan sınır dakikada 60 mesajdır; aşıldığında yanıt ne kadar bekleneceğini söyler.

Başlangıç

Dört adımda ilk mesaj

Her şey uygulamadaki Ayarlar → İşletme araçları ekranından yönetilir.

  1. Başvurunİşletme unvanı, vergi numarası ve kategorinizle başvuru gönderin.
  2. Onayı bekleyinBaşvurunuz incelenir; onaylanınca rozetiniz etkinleşir.
  3. Şablon oluşturunGönderilecek metni yazın, onaya sunun.
  4. Anahtar üretin ve gönderinAPI anahtarınızı yazılımınıza koyun, ilk isteği yapın.
API

Tek istek, tek mesaj

Anahtarınızı başlıkta, alıcıyı ve şablon değişkenlerini gövdede gönderin. Yanıt 200 ise mesaj yola çıkmıştır.

  • Alıcının numarası +90…, 05… ya da 5… biçiminde yazılabilir
  • Anahtar Authorization: Bearer ya da X-Api-Key başlığıyla gönderilir
  • Anahtarı yalnızca sunucunuzda tutun; istemci uygulamasına gömmeyin
# Doğrulama kodu gönderme
curl -X POST "https://distributed-microservice-gateway.bilgiakademisi.net.tr/cokkececicloud/api/v7/lumina/v1/messages" \
  -H "Authorization: Bearer $LUMINA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+905551112233",
    "template": "kod_bildirimi",
    "language": "tr",
    "parameters": ["482913"]
  }'
# Yanıt
{ "messageId": "3f2b8c1e-7a41-4d0e-9b55-0c6a2e1d4f90", "status": "sent" }

Yanıt kodları

KodAnlamıNe yapmalı
200Mesaj kabul edildiAkışınıza devam edin
400Değişken sayısı ya da değeri hatalıİsteği düzeltin; yeniden denemeyin
401Anahtar geçersiz ya da iptal edilmişAnahtarı kontrol edin
403İşletme doğrulanmamış, şablon pazarlama türünde ya da alıcı sizi engellemişBaşka bir kanal kullanın
404Şablon bulunamadı ya da alıcı Lumina kullanıcısı değilBaşka bir kanal kullanın
409Şablon henüz onaylanmamışOnayı bekleyin
429Dakikalık sınır aşıldıRetry-After başlığındaki süre kadar bekleyin

Baştan bilmeniz gerekenler

  • Mesaj yalnızca Lumina kullanan numaralara ulaşır; diğerleri için ikinci bir kanal planlayın.
  • İşletme sohbetleri tek yönlüdür: müşteri yanıt yazamaz, arama yapamaz.
  • Pazarlama içerikli şablonlar şu an gönderime kapalıdır; API bildirim ve doğrulama içindir.
  • İletildi ya da okundu bilgisi API'den sorgulanamaz.
  • Aynı isteği iki kez gönderirseniz müşteriye iki mesaj gider.

İşletmenizi Lumina'ya taşıyın

Başvuru uygulamanın içinden yapılır. Önce Lumina'yı indirin, ardından Ayarlar → İşletme araçları bölümüne gidin.

Lumina'yı indirBize yazın