Laravel 11 + Alexa Custom Skill

Sesli deneyimi kur bilgisiyle bulusturan webhook.

EchoBridge, Alexa uzerinden kullanicidan gelen istegi alip dogrular, uygun intent'i route eder, guncel sterlin kurunu ceker ve Alexa uyumlu bir yanita donusturur. Kisa cevaplar, net akis ve test edilebilir servis mimarisi icin tasarlandi.

Webhook akisina bak Neler sundugunu gor

1 endpoint `POST /api/alexa/webhook` ile tek giris, net is akisi.

SSML cikti Alexa icin okunabilir, dogal ve kontrollu ses cevabi.

Mock destekli Harici kur servisi olmadan da yerelde test edilebilir.

Canli ses akisi

IntentRequest

Ornek Alexa cevabi “Sterlin su an altmis lira doksan kurus.”

Turkceye yakin seslendirme

Alexa'nin telaffuzunu iyilestirmek icin cikti katmaninda SSML odakli bir cevap stratejisi kullaniliyor.

LOG

Izlenebilir islem gunlugu

Request tipi, intent adi, request ID ve olusan cevap merkezi olarak loglanarak hata ayiklamayi hizlandiriyor.

Neden EchoBridge

Demo olmaktan cikmis, urune donusebilir bir temel.

Proje sadece bir webhook degil; sesli arayuz, servis entegrasyonu ve savunmaci uygulama tasarimini ayni yerde birlestiren temiz bir baslangic noktasi sunuyor.

API-first yaklasim

Alexa istekleri icin ayrik bir giris noktasi bulunuyor. Bu da skill gelistirme, entegrasyon testi ve gelecekteki mobil veya web istemcileri icin yeniden kullanim imkani sagliyor.

Servis bazli mimari

Parsing, intent routing, response uretimi ve kur cekme adimlari birbirinden ayrilmis durumda. Kod okunabilirligi ve test kapsami bu sayede daha guclu.

Hazir buyume alani

Yeni intent'ler, farkli doviz turleri, ekstra verification katmani veya yeni sesli komutlar eklemek icin mevcut omurga yeterince esnek.

Istek Akisi

Alexa istegi geldikten sonra neler oluyor?

EchoBridge, kullanicinin sesli komutunu arkada kucuk ama net adimlarla isleyip tek bir Alexa uyumlu JSON cevabina donusturuyor.

Webhook istegi aliniyor

Alexa, skill istegini `POST /api/alexa/webhook` endpoint'ine gonderiyor. Uygulama request tipi ve metadata bilgisini ayiklamaya hazirlaniyor.

Parsing ve dogrulama yapiliyor

Request parser payload yapisini normalize ediyor. Gecersiz istekler kontrollu sekilde reddediliyor ve anlamli bir Alexa cevabi uretiliyor.

Intent route ediliyor

Gelen `IntentRequest`, ilgili handler'a yonlendiriliyor. Desteklenmeyen intent'ler fallback yanitina dusuyor.

Kur servisi devreye giriyor

`GetExchangeRateIntent`, harici kur verisini cekiyor veya mock modda sabit veri kullaniyor; sonra bu veri sesli ifade icin formatlaniyor.

SSML yaniti Alexa'ya donuyor

Response service, Alexa'nin bekledigi `version`, `outputSpeech` ve `shouldEndSession` alanlarini olusturarak yaniti tamamliyor.

API Yuzeyi

Kucuk endpoint, buyuk etki.

Uygulamanin odaginda tek bir webhook bulunuyor. Bu sadelik, dokumantasyon yazmayi da entegrasyon yapmayi da kolaylastiriyor.

Ornek istek

Alexa tarafindan gonderilen tipik bir `IntentRequest`, uygulamanin giris noktasina bu yapida ulasiyor.

{
  "version": "1.0",
  "request": {
    "type": "IntentRequest",
    "requestId": "amzn1.echo-api.request.intent.exchange-rate",
    "locale": "tr-TR",
    "intent": {
      "name": "GetExchangeRateIntent"
    }
  }
}

Ornek cevap

Cevap, Alexa uyumlu JSON ve SSML uretimi ile sesli kullanima hazir sekilde donuyor.

{
  "version": "1.0",
  "response": {
    "outputSpeech": {
      "type": "SSML",
      "ssml": "<speak>Sterlin shoo an altmish leera doksan kurush</speak>"
    },
    "shouldEndSession": true
  }
}

Teknik Omurga

Bugun calisir, yarin genisler.

EchoBridge'in mevcut yapisi, yalnizca bir proof of concept degil; dogru yerlere ayrilmis sorumluluklar sayesinde rahatca genisletilebilecek bir cekirdek.

SRV

Ayri servis katmanlari

`AlexaRequestParserService`, `AlexaIntentRouterService`, `AlexaResponseService` ve `ExchangeRateService` birbirinden bagimsiz calisiyor.

TST

Davranis odakli testler

Launch request, desteklenen intent, bilinmeyen intent ve bozuk payload senaryolari feature testlerle korunuyor.

SEC

Guvenlik icin hazir alan

Alexa signature verification middleware'i iskelet olarak hazir; uretim ortami icin sertlestirme asamasi planlanmis durumda.

Kapanis

EchoBridge, sesli finans sorgulari icin temiz bir baslangic noktasi.

Ana sayfa artik Laravel varsayilan ekranini degil, projenin amacini, teknik gucunu ve gelisim yonunu anlatiyor. Bu temel uzerine istersen sonraki adimda ekrani daha da urunlestirip ekran goruntuleri, ekip bolumu veya canli API durum bilgisi de ekleyebiliriz.