# Messenger & Instagram Kurulumu

Facebook Messenger + Instagram DM'lerini sesyaz asistanına bağlama rehberi.
WhatsApp ile aynı Meta App'i kullanabilirsiniz.

## Önkoşullar
- Facebook **Sayfası** (Messenger için şart)
- **Instagram Business/Creator** hesabı → Facebook Sayfasına **bağlı**
- Meta Developer App (WhatsApp'taki app olur)

## ADIM 1 — Messenger ürününü ekle
1. <https://developers.facebook.com/apps/> → app'iniz
2. **Add Product → Messenger → Set up**
3. **Settings → Access Tokens** → Sayfanızı seçin → **Generate Token**
   → Bu **Page Access Token** (panele girilecek)
4. Sayfa ID'yi not alın (Sayfa → Hakkında → Sayfa kimliği)

## ADIM 2 — Instagram ürününü ekle
1. **Add Product → Instagram → Set up**
2. Instagram Business hesabınızı bağlayın
3. Instagram hesap ID'yi not alın (opsiyonel; panelde IG ID alanı)

## ADIM 3 — sesyaz panelinde kaydet
Panel → asistan → **Messenger & Instagram Kanalı**:
- Facebook Sayfa ID
- Instagram Business ID (varsa)
- Verify Token (siz uydurun)
- App Secret (App → Settings → Basic)
- Page Access Token (Adım 1)
- **Aktif** ✅ → Kaydet

## ADIM 4 — Webhook ayarla (Meta App)
Messenger → Settings → **Webhooks** (Instagram için de aynı):
- **Callback URL:** `https://sesyaz.com/webhook/messenger`
- **Verify Token:** panelle birebir aynı
- **Verify and Save** → yeşil onay
- **Subscribe** edilecek alanlar: **messages**, **messaging_postbacks**
- Sayfanıza abone olun (Subscribe to Page)

## ADIM 5 — Test
- Facebook Sayfanıza Messenger'dan mesaj atın
- Instagram hesabınıza DM atın
- Asistan ~3-5 sn içinde otomatik yanıtlar
- Tüm mesajlar panel → **Gelen Kutusu**'nda görünür

## App Review (üretim için)
Kendiniz dışındakilere açmak için Meta App Review gerekir:
- İzinler: `pages_messaging`, `instagram_manage_messages`, `pages_manage_metadata`
- Geliştirme modunda: yalnızca app rolündeki kişiler test edebilir

## Sık sorunlar
| Sorun | Çözüm |
|---|---|
| Webhook verify failed | Verify token panel ≠ Meta — birebir karşılaştır |
| Mesaj geliyor cevap yok | Page Access Token süresi dolmuş → kalıcı token al |
| "eşleşen agent yok" | Panelde Sayfa/IG ID yanlış veya Aktif değil |
| Instagram mesajı gelmiyor | IG hesabı Business olmalı + FB Sayfasına bağlı olmalı |