Instagram DM entegrasyonu: bağlama, gelen kutusu ve kaldırma

Piyzi'de Instagram DM entegrasyonu bağlıyken, Instagram işletme hesabınıza gelen direkt mesajlar ortak Piyzi gelen kutusuna düşer ve tüm ekibiniz tek yerden yanıtlar. Gönderi yorumları ayrı bir Pi Store kartıdır; DM'i bağlamak yorumları da bağlamaz.

Ön koşullar

• Aboneliği aktif bir Piyzi hesabı.

• Pi Store düzenleme yetkisi ya da işletme sahibi olmanız.

• Instagram hesabınızın işletme (professional) hesabı olması. Kişisel hesaplar bağlanamaz.

• Yetkilendirme sırasında o Instagram hesabının yöneticisi olarak giriş yapmanız.

• Facebook Sayfası gerekmez. Piyzi Instagram Login kullanır; Facebook sayfası olmayan salon ve stüdyolar da bağlanabilir.

Entegrasyonu bağlama

1. Sol menüden İşletmem → Pi Store bölümünü açın.

2. Mesajlaşma başlığı altındaki Instagram DM kartına tıklayın.

3. Açılan pencerede “Instagram ile Bağlan” düğmesine basın; bir açılır pencere gelir.

4. Bu pencerede Instagram hesabınıza giriş yapın ve istenen izinleri onaylayın.

5. Piyzi'ye döndüğünüzde kart “Instagram Bağlı” olarak ve bağlanan @kullanıcı adıyla görünür.

İstenen izinler

• instagram_business_basic: hesabınızın temel bilgilerini (kullanıcı adı, ad, profil fotoğrafı) okur; bağlantının doğru işletmeye eşlenmesini sağlar ve mesajı yazan kişinin kullanıcı adını, adını ve profil fotoğrafını bir kez çekerek gelen kutusunda ham numara görünmesini engeller.

• instagram_business_manage_messages: gelen direkt mesajları alır, yanıtlarınızı gönderir, sohbeti okundu olarak işaretler ve tepki gönderir.

Bu izinlerle takipçileriniz, gönderileriniz, reklam hesaplarınız ve yorumlarınız görüntülenmez. Yorumlar için ayrı Instagram Yorumları kartı ve ayrı izin gerekir.

Gelen kutusunu kullanma

Bağlantıdan sonra sol menüde, mesajlaşma yetkisi olan personel için Mesajlaşma → Gelen Kutusu girdisi belirir. Gelen kutusu ortaktır: WhatsApp ve Instagram sohbetleri aynı listede durur, üstteki kanal sekmeleri (Tümü / WhatsApp / Instagram DM) listeyi filtreler.

Mesajlara yanıt verme

• Sohbeti siz başlatamazsınız. Instagram kuralları gereği sohbet ancak müşteri size yazdığında oluşur; “yeni sohbet” düğmesi yoktur.

• Müşterinin mesajı 24 saatlik yanıt penceresini açar. Bu süre boyunca serbestçe yanıtlarsınız; kalan süre yazma alanının üstünde görünür.

• Metin, fotoğraf, video ve ses gönderebilirsiniz. Instagram DM üzerinden belge gönderilemez.

• Bir mesajı yanıtlayabilir ve mesaja tepki verebilirsiniz. Instagram sınırlı bir tepki kümesi kabul ettiği için seçtiğiniz emoji en yakın desteklenen tepkiye eşlenir.

• Sohbeti açtığınızda mesajlar Instagram tarafında da okundu olarak işaretlenir.

• Yanıtlamak için mesaj gönderme yetkisi gerekir; gelen kutusunu yalnızca görüntülemek için mesajlaşma görüntüleme yetkisi yeterlidir.

Gelen ekler ve paylaşımlar

• Fotoğraf, video ve ses dosyaları Piyzi'ye indirilir ve doğrudan baloncukta görünür.

• Paylaşılan gönderi veya Reels “Paylaşılan içerik (Reels/gönderi)” etiketiyle gelir. Gönderide küçük resim indirilip gösterilir; Reels bir Instagram bağlantısı olarak geldiği için önizleme yerine baloncukta Instagram'da açma seçeneği sunulur.

• Hikâyenize gelen yanıt “Hikayeye yanıt”, hikâyede bahsedilme ise “Hikayede bahsetme” etiketiyle görünür.

• Müşterinin gönderdiği dosya belge olarak listelenir ve açılabilir; yalnızca siz belge gönderemezsiniz.

• Instagram'ın Piyzi'nin gösteremediği bir biçimde ilettiği içerik “Desteklenmeyen mesaj türü” olarak görünür; yani hiçbir mesaj sessizce kaybolmaz.

Görüşmeyi personele atama ve sonlandırma

• Sağdaki Görüşme Yönetimi paneli yalnızca ekibinize görünür: burada yaptığınız hiçbir şey müşteriye bildirilmez.

• “Görüşmeyi yürüten personel” alanından bir personel seçin. Yazışmada “{ad} görüşmeye katıldı” satırı belirir.

• Atamayı kaldırmak “{ad} görüşmeden ayrıldı” satırını yazar; görüşmeyi başkasına devrederseniz iki olay da sırayla yazılır.

• Yalnızca bu işletmede aktif üyeliği olan personel atanabilir.

• “Görüşmeyi Sonlandır” görüşmeyi kapatır ve “Görüşme … tarafından sonlandırıldı” satırını yazar. Aynı kişi tekrar yazarsa ayrı bir görüşme olarak açılır; müşteri bunu fark etmez.

• Atama ve sonlandırma için mesaj gönderme yetkisi gerekir.

Müşteri eşleştirme ve profil fotoğrafı

• Instagram sohbetleri müşteri kartındaki Instagram kullanıcı adı üzerinden eşleşir. Büyük/küçük harf ve baştaki @ işareti fark etmez.

• Webhook yalnızca hesap kimliği taşır, kullanıcı adını göndermez; bu yüzden Piyzi profili bir kez çekip sonra eşleştirir. İlk mesajda kısa süre numara görünmesinin sebebi budur.

• Sohbet eşleşmediği sürece her gelen mesajda eşleştirme yeniden denenir; yani müşteriyi sonradan eklerseniz eski sohbet de kendiliğinden eşleşir.

• “Mevcut müşteriyle eşleştir” işlemi Instagram kullanıcı adını müşteri kartına da yazar; böylece sonraki sohbetler kendiliğinden eşleşir.

• “Yeni müşteri olarak ekle” müşteri veritabanınıza yazdığı için ayrıca müşteri oluşturma yetkisi ister.

• Profil fotoğrafı Instagram'ın CDN adresinden gelir ve bu adresin süresi zamanla dolar. Süresi dolunca fotoğraf yüklenmez ve yerine baş harf görünür; bozulan bir şey yoktur. Müşteri kartında fotoğraf varsa önce o kullanılır.

Bildirim ayarları

• Gelen kutusundaki Bildirim Ayarları düğmesi paneli açar; hem görüntülemek hem değiştirmek bildirim ayarı yetkisi ister.

• Her personel için WhatsApp, IG Mesaj ve IG Yorum ayrı ayrı açılıp kapatılır.

• Görüşme birine atanmışsa bildirim yalnızca atanan kişiye gider — listede olmasa bile.

• Hiç ayar yapılmamışsa yalnızca işletme sahibi bildirim alır. Liste var ama boşsa kimseye bildirim gitmez.

• Aynı görüşme için 2 dakikada en fazla 1 bildirim gönderilir ve bildirimler yalnızca mobil uygulamaya giriş yapmış personele ulaşır.

Sohbeti silme

• “Sohbeti Sil” sonlandırmadan ayrı bir yetkidir; kalıcı bir işlemdir ve denetim kaydına yazılır.

• Sohbet ve tüm mesajları Piyzi'den, tüm Piyzi cihazlarından kaldırılır ve bu işlem geri alınamaz.

• Silme yalnızca Piyzi tarafındadır. Meta API'leri karşı tarafın Instagram uygulamasındaki kopyayı silmeye izin vermez; böyle bir seçenek hiç kimse için yoktur.

• Aynı kişi tekrar yazarsa tertemiz yeni bir sohbet açılır; eski geçmiş geri gelmez.

Bağlantıyı kaldırma

1. İşletmem → Pi Store bölümünü açın.

2. Instagram DM kartına tıklayın.

3. “Bağlantıyı Kes” düğmesine basın.

• Yeni mesajlar artık alınmaz ve gönderim yapılamaz.

• Piyzi'deki mevcut sohbetler ve mesajlar okunabilir kalır; entegrasyon silinmez, pasife alınır.

• Bağlı mesajlaşma kanalı kalmadığında Gelen Kutusu girdisi menüden kalkar.

• Instagram Yorumları ayrı bir karttır: DM bağlantısını kesmek yorumları kesmez.

• Dilediğiniz zaman aynı adımlarla yeniden bağlanabilirsiniz.

Bağlantıyı Instagram tarafından da kaldırabilirsiniz: hesabınızın uygulama ayarlarından Piyzi'yi kaldırın. Instagram bu durumda Piyzi'ye bildirim gönderir ve entegrasyon kendiliğinden pasife alınır. Ayrıca Meta üzerinden veri silme talebi gönderirseniz, o hesaba ait tüm Instagram sohbet ve yorumları Piyzi'den kaldırılır.

Sorun giderme

• Kart “Bağlandı” görünmüyor: açılır pencere engelleyicisi yetkilendirmeyi kesmiş ya da Instagram penceresini işlem bitmeden kapatmış olabilirsiniz. Pi Store'dan tekrar deneyin.

• Yetkilendirme başarısız oluyor: hesabın işletme (professional) hesabı olduğundan ve o hesabın yöneticisi olarak giriş yaptığınızdan emin olun.

• Menüde Gelen Kutusu yok: entegrasyon bağlı olmayabilir ya da rolünüzde mesajlaşma görüntüleme yetkisi eksik olabilir.

• “Bağlantının süresi doldu — Pi-Store üzerinden yeniden bağlanın”: Instagram anahtarı kendiliğinden yenilenir, ancak şifre değişimi veya izin iptali onu geçersiz kılar. Gelen mesajlar akmaya devam eder; gönderim için Pi Store'dan yeniden bağlanın.

• Yanıt gönderilemiyor: büyük olasılıkla 24 saatlik pencere kapanmıştır. Instagram'da şablon alternatifi yoktur; müşteri size yazınca gönderim yeniden açılır.

• Sohbette ad yerine numara görünüyor: profil çekilememiştir (gizli profil ya da geçici Instagram hatası). Sohbet yine çalışır; müşteriyi elle eşleştirin.

• Profil fotoğrafı yüklenmiyor: Instagram CDN adresinin süresi dolmuştur. Yerine baş harf görünür, yapmanız gereken bir şey yoktur.

• Müşteri eşleşmiyor: müşteri kartına Instagram kullanıcı adını yazın ya da “Mevcut müşteriyle eşleştir” ile bağlayın; kullanıcı adı bir sonraki sefer için kaydedilir.