Wapix

Instagram Bağlantısı

Wapix, Meta'nın Instagram Messaging API'sini kullanarak Instagram DM'lerine bağlanır; bu, ya Facebook girişi ile API ayarı (şu anda çoğu kontrol panelinin sunduğu) ya da Instagram girişi ile API ayarı ile yapılır. WhatsApp ile aynı Uygulama Kontrol Paneli, webhook imza şeması ve tek seferlik el sıkışma sürecini paylaşır, bu nedenle WhatsApp'ı zaten bağladıysanız, bu tanıdık gelecektir.

Meta'nın kontrol panelini ve Wapix panelinizi iki sekmede açık tutun. Değerleri karşılıklı olarak kopyalayacaksınız.

Kısaca

Bu nedir? Instagram profesyonel hesabınızı Wapix'e bağlamak, böylece doğrudan mesajlar (DM'ler) Gelen Kutunuza ulaşır ve AI bunlara yanıt verebilir.

Neden birkaç adım alıyor? Instagram Meta'ya aittir. WhatsApp'ta olduğu gibi, çoğu iş Meta'nın kontrol panelinde ve telefonunuzda bir kez yapılır.

Sonuç olarak ne elde edeceksiniz? Meta'dan Wapix'e kopyalanmış üç veya dört değer (Instagram hesap ID'niz, bir Facebook Sayfa ID'si, bir erişim belirteci ve uygulama sırrı) ve Wapix'den Meta'ya kopyalanmış iki değer.

Öncelikle bilmeniz gereken bir şey. Wapix, Instagram'da resim alabilir ancak gönderemez. Bu, sayfanın sonunda açıklanan bir Instagram kısıtlamasıdır.

Bir kanalın ne olduğunu ve sonrasında nasıl yönetileceğini görmek için Kanallar bölümüne bakın.

1. Meta uygulamanızı oluşturun ve Instagram kullanım durumunu ekleyin

Aşağıdaki her şey bir Meta geliştirici uygulaması içinde gerçekleşir, bu nedenle bu ilk adım.

  • Henüz bir Meta uygulamanız yok mu? Meta uygulamanızı oluşturun adımlarını takip edin ve kullanım durumları adımında Instagram'da mesajlaşmayı ve içeriği yönet seçeneğini işaretleyin. Aynı uygulamada WhatsApp ve Messenger'ı da işaretleyebilirsiniz, böylece bunu yalnızca bir kez yaparsınız.
  • Zaten bir uygulamanız var mı (örneğin WhatsApp veya Messenger'dan)? Kontrol Paneli'ni açın, Kullanım durumları ekle'ye tıklayın ve Instagram'da mesajlaşmayı ve içeriği yönet seçeneğini ekleyin.

Sonra kullanım durumunu ayarlayın:

  1. Sol menüde Kullanım durumları'nı açın ve Instagram kullanım durumunun yanındaki Özelleştir'e tıklayın.
  2. Sol menüsünden Facebook girişi ile API ayarı'nı seçin.

Hangi ayarı göreceğim? Meta'nın daha yeni panelleri yalnızca Facebook girişi ile API ayarı gösterir. Bazı uygulamalar ayrıca Instagram girişi ile API ayarı sunar, bu da bir Instagram Uygulama ID'si ve Instagram Uygulama Sırrı verir. Wapix her ikisiyle de çalışır. Bu kılavuz, çoğu hesabın şu anda aldığı Facebook girişini takip etmektedir. Bir uygulama yalnızca ikisinden birine sahip olabilir.

2. Instagram hesabını bir Facebook Sayfasına bağlayın

Facebook girişi ile Instagram hesabınızın profesyonel (İş veya Yaratıcı) bir hesap olması ve bir Facebook Sayfasına bağlı olması gerekir.

  1. Instagram uygulamasında: Profil düzenle → Sayfa, ardından bir Facebook Sayfasını bağlayın veya oluşturun.
  2. Sayfanın adını not edin. Bir sonraki adımda Sayfa ID'sine ve bunun için bir belirtece ihtiyacınız olacak.

3. İzinleri ekleyin

Kullanım durumunun İzinler ve özellikler listesinde, her birinin yanındaki Ekle'ye tıklayın:

  • instagram_manage_messages
  • instagram_basic
  • pages_show_list
  • pages_read_engagement
  • pages_messaging
  • pages_manage_metadata (Sayfanızı uygulamaya abone etmek için 8. adımda gereklidir)
  • business_management
  • İnsan Temsilcisi (isteğe bağlı, bir kişinin 7 güne kadar yanıt vermesine izin verir)

Listeden bir izin eksikse, İzinler ve özellikler bölümünde arayın ve Ekle'ye tıklayın. Graph API Explorer'da, belirteci oluşturmadan önce aynı izinleri işaretleyin.

4. Değerlerinizi toplayın

Wapix için dört değere ihtiyacınız var:

Değer Nerede bulabilirsiniz
Facebook Sayfa ID'si Sayfanın Hakkında bölümünde veya Meta'nın Graph API Explorer'ında.
Instagram hesap ID'si Graph API Explorer'da, Kullanıcı veya Sayfa kısmında Sayfanızı seçin ve me?fields=instagram_business_account komutunu çalıştırın (sadece bir ?). İçindeki sayı Instagram hesap ID'sidir. Bu sizin @handle'ınız değildir. Hiçbir şey döndürülmezse, o Sayfanın bağlı bir Instagram hesabı yoktur: diğer Sayfayı seçin veya Instagram uygulamasında bağlayın.
Erişim belirteci Yukarıdaki Sayfa ID'si ile aynı Sayfa için bir Sayfa erişim belirteci. Graph API Explorer'da: uygulamanızı seçin, 3. adımdan izinleri işaretleyin, Erişim Belirteci Oluştur butonuna tıklayın, açılır pencerede Sayfayı ve Instagram hesabını seçin, ardından Kullanıcı veya Sayfa kısmında o Sayfayı seçin ve belirteci kopyalayın. Süresiz bir belirteç için İş Ayarları kısmında bir Sistem Kullanıcısı oluşturun, ona uygulamanızı ve Sayfayı verin ve yukarıdaki izinlerle bir belirteç oluşturun. WhatsApp Bağlantısı'nın kalıcı belirteç adımına bakın.
Uygulama sırrı Uygulama ayarları → Temel → Uygulama sırrı (normal Meta uygulama sırrı, Meta uygulamanızı oluşturun kısmına bakın).

Eğer uygulamanız Instagram girişi ile API ayarı sunuyorsa, onun Instagram Uygulama Sırrını ve bir Instagram kullanıcı belirtecini kullanın ve Wapix'de Sayfa ID'sini boş bırakın.

5. Telefonunuzda mesajlara erişime izin verin

Meta, Instagram mobil uygulamasında izin vermediğiniz sürece API mesajlarını sessizce engeller. Bu ayar masaüstü web sitesinde gösterilmez.

  1. Telefonunuzda Instagram'ı açın ve bağlı hesaba giriş yapın.
  2. Ayarlar → Mesajlar ve hikaye yanıtları → Mesaj kontrolleri kısmına gidin.
  3. Aşağı kaydırın ve "Bağlı Araçlar" altında Mesajlara erişime izin ver seçeneğini AÇIK konuma getirin.

6. Wapix'de kanalı oluşturun

  1. Wapix'de Kanallar → Bir kanala bağlan kısmına gidin.
  2. Instagram'ı seçin, bir isim verin ve girin:
    • Instagram hesap ID'si
    • Facebook Sayfa ID'si (sadece Facebook girişi)
    • Erişim belirteci
    • Uygulama sırrı
  3. İsterseniz şimdi bir asistan seçin veya bunu daha sonra kanalın kartından yapın.
  4. Kaydedin.

Wapix'in kanal sayfası artık bir Callback URL ve Doğrulama belirteci gösteriyor.

7. Webhook'u Meta'da kaydedin

  1. Meta uygulamanızda Instagram için Kullanım durumları → Özelleştir kısmını açın. Sol menüde Webhook'lar'a tıklayın (eğer orada yoksa, Bu kullanım durumuna daha fazla ekle'ye tıklayın, ardından Webhook'lar'ın yanındaki Ekle'ye tıklayın).
  2. Webhook'lar sayfasında Instagram nesnesini seçin.
  3. Wapix'den Callback URL ve Doğrulama belirtecini yapıştırın ve Doğrula ve kaydet'e tıklayın.
  4. Webhook alanları altında, mesajlar için Abone ol seçeneğini açın.

Doğrulama başarısız oldu mu? WhatsApp'taki aynı nedenler: henüz HTTPS yok (Callback URL'niz gerçek kamu adresiniz olmalı, localhost değil), ekstra boşluklarla kopyalanmış bir Doğrulama belirteci veya Site URL'si uyuşmazlığı. Bakınız Sorun Giderme.

8. Sayfanızı uygulamaya abone edin

Bunu atlamayın. Webhook'u doğrulamak yeterli değildir. Meta, yalnızca o Sayfanın uygulamaya abone olmasından sonra Sayfanın Instagram mesajlarını uygulamanıza gönderir.

  1. Meta uygulamanızda Meta'dan Messenger'da müşterilerle etkileşim için Kullanım durumları → Özelleştir kısmını açın, ardından Messenger API Ayarları.
  2. 2. Erişim belirteçleri oluşturun kısmında, Sayfanızı bulun (eksikse önce bağlayın).
  3. Sayfanın yanındaki Abonelikler Ekle'ye tıklayın ve mesajlar'ı işaretleyin. Kaydedin. Satır "Abone olunmamış alan yok" demeyi bırakmalıdır.

Çalışıp çalışmadığını kontrol etmek için, Graph API Explorer'da (Sayfa belirteci seçili) me/subscribed_apps komutunu çalıştırın. Uygulamanız, abone alanlarında messages ile birlikte yanıt olarak görünmelidir.

DM'ye Yorum: yorumları otomatik olarak yanıtlayın

Birisi gönderilerinizden veya Reels'lerinizden birine bir kelime yorum yaptığında, kamuya yanıt verebilir ve onlara detaylarla özel bir mesaj gönderebilirsiniz. Özel mesaj, AI ve ekibinizin devam ettiği normal bir konuşmayı açar.

Kurulum

  1. Meta uygulamanızda yorum izinlerini ekleyin: instagram_business_manage_comments (Instagram girişi) veya instagram_manage_comments ve pages_read_engagement (Facebook girişi). Meta, bunları diğer kişilerin hesapları için çalışmadan önce gözden geçirir (Uygulama İncelemesi).
  2. Meta kontrol panelinde, webhook'u comments alanına abone edin.
  3. Otomasyonlar kısmında, Yorum anahtar kelimesi → DM ile başlayın. Aranacak kelimeyi ve isterseniz hangi gönderilere uygulanacağını seçin.
  4. Akışın iki adımı vardır: Yoruma yanıt ver (birkaç versiyondan biri rastgele seçilir) ve Yorum yapan kişiye özel bir mesaj gönder.

Meta'nın adımları izlediği kurallar

  • Her yorum için bir özel mesaj, yorumdan itibaren 7 gün içinde. Sonrasında adım, net bir sebep ile durur.
  • Özel mesaj düz metin olarak gönderilir. Kişi yanıtladıktan sonra, yanıtlarının üzerinden 24 saat içinde normal şekilde yazabilirsiniz.
  • Kendi yorumlarınız ve yanıtlarınız göz ardı edilir, bu nedenle bir otomasyon kendisine asla yanıt vermez.
  • Bir gönderi altında, saatte en fazla 500 otomatik yanıt gönderilir, Meta'nın limitleri içinde kalmak için.

Yorumlar, kişinin sayfasında Gönderilerinizdeki Yorumlar altında görünür.

Hikaye yanıtları ve bahsetmeler

Bir hikayenize yanıt veren bir mesaj, Hikayenize yanıt verdi şeklinde bir bağlantı ile gösterilir. Sizi bahseden bir hikaye, Hikayelerinde sizi bahsetti olarak gelir. Her ikisi de bir otomasyonu başlatabilir: tetikleyici olarak Birisi Instagram hikayenize yanıt verirse veya Birisi Instagram hikayenizde sizi bahsederse seçin.

9. Test edin

Bağlı Instagram hesabınıza başka bir Instagram hesabından bir DM gönderin. Bu, birkaç saniye içinde Wapix'in Gelen Kutusu'nda görünmelidir ve eğer bir bilgi bankası bağlıysa, bir AI yanıtı almalıdır.

Geliştirme Modunda Test mi yapıyorsunuz? Meta Uygulama İncelemesi için göndermeden önce test yapıyorsanız, muhtemelen bu Meta güvenlik tuzaklarına takılacaksınız:

  • Roller ve davetler: Mesajı gönderen kişinin uygulamada bir rolü olmalıdır (Kontrol panelinde Uygulama rolleri, örneğin Instagram Testeri) ve daveti telefonunda kabul etmelidir (Ayarlar → Uygulamalar ve Web Siteleri → Testçi Davetleri).
  • Mesaj İstekleri Klasörü: Test mesajı botun "Mesaj İstekleri" klasörüne düşerse, webhook çalışmayacaktır. Botun Instagram hesabına bir telefondan giriş yapmalı ve sohbette "Kabul Et"e tıklamalısınız.
  • Geliştirme Modu Hatası: Birçok geliştirici, Meta'nın şu anda hatalı olduğunu ve Geliştirme Modunda gerçek Mesaj webhook'larını göndermeyi tamamen reddettiğini bildirmektedir, hatta kabul edilen testçiler için bile. Sohbeti kabul ettikten sonra webhook'lar hala gelmiyorsa, tek çözüm uygulamayı incelemeye göndermek ve Canlı Mod'a geçmektir.

Eğer bir mesaj gelmiyorsa veya yanıt gitmiyorsa

Bu listeyi takip edin ve yanlış olan ilk şeyde durun:

  1. Sayfa abone mi? 8. adım. Onaylamak için Explorer'da me/subscribed_apps komutunu çalıştırın.
  2. Webhook doğrulandı mı, Instagram nesnesi için messages abone mi? 7. adım.
  3. Instagram telefon uygulamasında "Mesajlara erişime izin ver" açık mı (5. adım)?
  4. Uygulamanız yayımlanmamış mı? O zaman yalnızca uygulamada bir rolü olan kişiler hesabınıza mesaj atabilir ve gönderen daveti kabul etmelidir. Yukarıdaki Geliştirme Modu notlarına bakın.
  5. Mesaj Mesaj İstekleri'nde mi? Bir telefonda hesabı açın ve kabul edin.
  6. Sayfa ID'si, belirteç ve Instagram hesap ID'si hepsi aynı Sayfadan mı? Buradaki bir karışıklık, bir yanıtın başarısız olmasının en yaygın nedenidir.
  7. Belirteç süresi dolmuş mu? Hata kodu 190 bunu gösterir. Kod 10 bir izin eksik olduğunu gösterir (genellikle pages_messaging veya instagram_manage_messages). 3. adımda belirtilen izinlerle yeni bir belirteç oluşturun.
  8. Birkaç dakika sonra hala bir şey yok mu? destek ile iletişime geçin.

Ayrıca, Instagram'ın yalnızca müşterinin son mesajından itibaren 24 saat içinde yanıt vermenize izin verdiğini ve müşterinin önce yazması gerektiğini unutmayın.

Bilinen kısıtlama: dışa gönderilen resimler yok. Wapix, Instagram üzerinden bir müşteri tarafından gönderilen bir resmi alabilir ve depolayabilir, ancak bu kanalda bir resmi geri gönderemez — Meta'nın Instagram Messaging API'sinin bu kimlik türü için onaylanmış bir ham yükleme yolu yoktur. AI normalde bir resimle yanıt verecekse (örneğin bilgi bankasından bir ürün fotoğrafı), otomatik olarak Instagram'da metin tabanlı bir yanıt vermeye geri döner, sessizce başarısız olmaz. Bu, gerçek bir platform boşluğu olup, bir Wapix hatası değildir — WhatsApp ve Messenger genellikle dışa gönderilen resimleri destekler.

WhatsApp'tan Diğer Farklar

  WhatsApp Instagram
Önceden onaylı şablonlar Evet (Meta incelemesi gereklidir) Hayır — Wapix, bu kanalda şablon yanıtlarını düz metin olarak gönderir.
Metin mesajı limiti 4096 karakter 1000 karakter
Yazma göstergesi Destekleniyor Bu kanalda mevcut değil.