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ı.

• İşletme sahibi olmanız ya da rolünüzde “Entegrasyonları yapabilir” yetkisi bulunması. Pi Store'u açmak için “Entegrasyonları görebilir” yetkisi yeter; ancak “Entegrasyonları yapabilir” yetkisi olmadan karta tıkladığınızda pencere açılmaz.

• 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; “Instagram DM Bağlantısı” penceresi açılır.

3. “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. Açılır pencere kapanınca sayfa kendiliğinden yenilenir: kartın rozeti “Bağlı” olur ve sol menüde Mesajlaşma → Gelen Kutusu girdisi belirir. Kartı yeniden açtığınızda pencerede “Instagram Bağlı” başlığı ve bağlanan @kullanıcı adı görünür.

Aynı Instagram hesabı birden fazla Piyzi işletmesine (örneğin iki şubeye) bağlanabilir. Hesap başka bir Piyzi işletmesinde zaten bağlıysa bağlantı sırasında bir onay sorusu görürsünüz; onaylarsanız gelen mesajlar bağlı işletmelerin hepsinin gelen kutusuna ayrı ayrı düşer ve her işletme kendi tarafından yanıtlayabilir. Onaylamazsanız bağlantı kurulmaz.

İ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, rolünde “WhatsApp mesajlarını görebilir” yetkisi olan personel için Mesajlaşma → Gelen Kutusu girdisi belirir; yanıt yazmak için “WhatsApp mesajı gönderebilir” yetkisi gerekir. Bu yetkilerin adı WhatsApp dese de Instagram DM için de geçerlidir; hazır rollerden yalnızca Yönetici'de bulunurlar. Gelen kutusu ortaktır: WhatsApp ve Instagram sohbetleri aynı listede durur, birden fazla kanal bağlıysa listenin üstündeki kanal sekmeleri (Tümü / WhatsApp / Instagram DM) listeyi filtreler.

Mesajlara yanıt verme

• Instagram'da sohbeti siz başlatamazsınız. Instagram kuralları gereği sohbet ancak müşteri size yazdığında oluşur; gelen kutusundaki “Sohbet Başlat” düğmesi yalnız WhatsApp içindir.

• 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 altında görünür.

• Ataç simgesiyle fotoğraf, video ve ses gönderebilirsiniz; Instagram DM üzerinden belge gönderilemez.

• Bir mesajın üzerine geldiğinizde çıkan düğmelerle o 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.

• Okunmamış bir sohbeti açtığınızda mesajlar Instagram tarafında da okundu olarak işaretlenir ve müşteri “görüldü” bilgisini görür. Sohbet listesinin üstündeki bilgi şeridi bunu bir kez hatırlatır.

• Yanıtlamak için mesaj gönderme yetkisi gerekir; gelen kutusunu yalnızca görüntülemek için 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” onay sorar, 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 (kartta zaten bir kullanıcı adı yoksa ve başka bir müşteride kayıtlı değilse); 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şturabilir” 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ı

• Sohbet listesinin üstündeki dişli simgeli Bildirim Ayarları düğmesi paneli açar; hem görüntülemek hem değiştirmek “Mesajlaşma bildirim ayarlarını yönetebilir” yetkisi ister.

• Her personel için WhatsApp, IG Mesaj, IG Yorum ve Google Yorum ayrı ayrı açılıp kapatılır; kişinin adına tıklamak dördünü birlikte değiştirir.

• 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; bildirimler yalnızca mobil uygulamaya giriş yapmış ve kendi hesabında (Hesabım → Bildirimler) Rahatsız Etme Modu'nu açmamış personele ulaşır.

Sohbeti silme

• “Sohbeti Sil” sonlandırmadan ayrı bir yetkidir (rol ekranında “Sohbet silebilir (yalnız Piyzi tarafından)”); kalıcı bir işlemdir ve denetim kaydına yazılır. İşletme sahibi ve hazır Yönetici rolü silebilir.

• 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. Onay sorulmaz: bağlantı hemen kaldırılır ve sayfa yenilenir.

• 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: Pi Store'dan 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 o hesabın hem Instagram DM hem Instagram Yorumları bağlantısı 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ğlı” 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 “WhatsApp mesajlarını görebilir” yetkisi eksik olabilir.

• “Instagram DM bağlantısının süresi doldu — mesaj göndermek için 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; yeniden gönderebilmek için Pi Store'da Instagram DM kartını açıp önce “Bağlantıyı Kes”e, sonra “Instagram ile Bağlan”a bası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.

• Görüşme Yönetimi paneli görünmüyor: tarayıcı penceresi 1400 pikselden dardır; yakınlaştırmayı küçültün ya da mobil uygulamayı kullanın.

• Sohbette ad yerine numara görünüyor: profil çekilememiştir (gizli profil ya da Instagram'daki geçici bir sorun). 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.