Instagram / Meta Kurulum Rehberi

1. Meta Uygulaması Oluşturma

Adım 1

developers.facebook.com/apps adresine gidin ve Uygulama Oluştur ile yeni bir uygulama oluşturun.

Adım 2

Uygulama türü olarak İş veya Diğer seçin. Uygulama adı ve iletişim e-postası girin.

Adım 3

Oluşturduktan sonra Ayarlar → Temel bölümünden Uygulama Kimliği ve Uygulama Gizlisi değerlerini not alın (OAuth ve sunucu tarafı için gerekir).

2. Instagram Graph API İzinleri

Adım 1

Ürün Ekle ile Instagram ürününü ekleyin. Instagram Graph API kullanacağız.

Adım 2

instagram_manage_messages, pages_show_list, pages_read_engagement izinlerini isteyin. Canlıya almadan önce bu izinlerin onayı gerekebilir.

Adım 3

Instagram hesabınızı bir Facebook Sayfasına bağlayın. Meta Ayarları → Sayfalar üzerinden sayfa oluşturup Instagram’ı “Profesyonel hesap” ile bağlayın.

3. Webhook Kurulumu

Adım 1

Uygulama panelinde Webhooks bölümüne gidin. Instagram için webhook ekleyin.

Adım 2

Callback URL: sunucunuzun herkese açık HTTPS adresi + /webhook. Örnek:

https://heoxify.com/webhook

Kendi alan adınız için panelde ayarladığınız Public URL + /webhook kullanın (ör. https://firmaniz.com/webhook). Geçici test için IP veya *.sslip.io gibi adresleri canlı yardım sayfalarında yayınlamayın; güvenlik tarayıcıları bunları riskli sayabiliyor.

Adım 3

Verify Token: Kendi belirlediğiniz bir metin (örn. my_verify_token_123). Bu değeri Heoxify panelinde “Hesap ayarları” → Verify Token alanına aynen yazın.

Meta, webhook’u doğrulamak için GET isteği atar; sunucumuz bu token’ı kontrol eder ve hub.challenge değerini döner.

4. Sayfa ID ve Instagram İş Hesabı ID

Sayfa ID

Facebook Sayfanızın sayfa kimliği: Sayfa ayarları veya Graph API Explorer ile me/accounts çağrısı yaparak id değerini alabilirsiniz.

Instagram İş Hesabı ID

Sayfaya bağlı Instagram hesabının ID’si: me/accounts?fields=instagram_business_account ile instagram_business_account.id alanına bakın. Webhook gelen isteklerde entry[].id olarak bu değer gelir.

5. Uzun Ömürlü Token (Long-Lived Token)

Kısa süreli kullanıcı token’ı ile Sayfa Erişim Token’ı alın. Graph API’de:

• Önce kullanıcı token’ını uzun ömürlü token’a çevirin.
• Sonra me/accounts ile sayfa token’larını alın. Her sayfa için access_token alanı, Meta API üzerinden gelen DM konuşmalarına yanıt vermek için kullandığınız Page Access Token’dır.

Bu token’ı Heoxify’ta Manuel bağlantı ile “Access Token” alanına yapıştırın. (Token’ı kimseyle paylaşmayın.)

6. Sık Karşılaşılan Hatalar ve Çözümleri

Webhook doğrulanamıyor: Callback URL’nin dışarıya açık ve HTTPS olduğundan emin olun. Verify Token’ın paneldeki ile birebir aynı olduğunu kontrol edin.

Gelen DM’e yanıt verilemiyor: Sayfa Access Token’ının süresi dolmamış olmalı. Gerekirse yeni sayfa token’ı alıp panelde güncelleyin. instagram_manage_messages izninin verildiğini kontrol edin.

Lead’ler gelmiyor: Webhook’ta gelen entry[].id ile panelde kayıtlı sayfa/IG hesap ID’sinin eşleştiğinden emin olun. İlgili hesabın “Aktif” olduğunu kontrol edin.