Instagram Comments integration: connecting, using and removing

When the Instagram Comments integration is connected, comments left on the connected account's own posts arrive in Piyzi. You see them in a single list and can reply to them, hide them, mark them as handled or delete them. Replying, hiding and deleting are applied on Instagram at the same time.

Prerequisites

• A Piyzi account with an active subscription.

• Being the business owner, or having the “Entegrasyonları yapabilir” (manage integrations) permission in your role. The “Entegrasyonları görebilir” (view integrations) permission is enough to open Pi Store, but without “Entegrasyonları yapabilir” clicking a card opens nothing.

• An Instagram business (professional) account. Personal accounts cannot be connected.

• Signing in to Instagram as an admin of that account while connecting.

• No Facebook Page is required; the connection is made with the Instagram account directly.

Adding the app

1. In the left menu, open My Business → Pi Store.

2. Under the Messaging heading, click the Instagram Comments card; the “Instagram Comments Connection” dialog opens.

3. Click “Connect with Instagram”.

4. Sign in to your account on Instagram's authorization screen and approve the requested permissions.

5. When the authorization window closes, the page reloads by itself: the card badge shows “Connected” and a Messaging → Instagram Comments entry appears in the left menu. When you open the card again, it shows “Instagram Connected” with the connected account's @username.

The same Instagram account can be connected to more than one Piyzi business (for example two branches). If the account is already connected to another Piyzi business, you will see a confirmation question during connection; if you approve, incoming comments appear in every connected business separately. If you decline, the connection is not established.

Requested permissions

• Basic account info (instagram_business_basic): to read the connected account's username and to fetch the thumbnail and link of the post a comment belongs to.

• Comment management (instagram_business_manage_comments): to receive comments and to reply to, hide, unhide and delete them.

Instagram DMs are a separate Pi Store card with a separate authorization; the permission you grant for comments does not give access to your direct messages. Follower lists, insights and publishing posts are outside the scope of these permissions.

The Comments screen

• Once connected, a Messaging → Instagram Comments entry appears in the left menu. The entry is shown to staff whose role has the “Instagram yorumlarını görebilir” (view Instagram comments) permission; to open the screen, one of the “WhatsApp mesajlarını görebilir” or “WhatsApp mesajı gönderebilir” (view or send messages) permissions is also needed, otherwise clicking the entry opens the Calendar. The business owner and the built-in Yönetici (Manager) role have all of these permissions.

• Instagram and Google tabs sit at the top of the screen; the red number on a tab is the count of unhandled comments on that channel. The Google tab shows your Google Business Profile reviews and is covered in its own article.

• The list only contains comments on the connected account's own posts; comments you leave on other accounts' posts never arrive here. Live broadcast comments and comments that mention your account land in the same list.

• Comments are delivered from Instagram in real time and are recorded within a few seconds. On the web the list does not refresh by itself — reload the page. In the mobile app it refreshes every time you return to the screen, when you bring the app to the foreground, and when you pull to refresh.

• The newest comment is at the top; 30 comments load per page and the rest with “Show more”. The “Unhandled only” switch filters out the comments you have already marked.

• Your own replies also appear in the list, marked with a “Your reply” badge; comments you hid carry a “Hidden” badge. If the commenter's Instagram username matches one of your customer records, the customer's name and, if any, last visit date appear as a badge — click it to open the customer card.

Which post a comment belongs to

• The thumbnail of the post the comment was left on sits at the start of each row. Clicking the thumbnail or the “Go to Post” button opens the post on Instagram; the button only appears if the post's link could be fetched.

• Instagram's comment notification only carries the post id; the thumbnail and the post link are fetched separately by Piyzi.

• If the post was deleted or its image cannot be fetched, the comment is still listed and the commenter's initial is shown in place of the thumbnail.

Available actions

• Reply: write your reply in the “Reply to Comment” dialog and click “Send Reply”. It is published on Instagram underneath that comment on behalf of your business account, and the comment you replied to is automatically counted as “Handled”. The reply button only appears on incoming comments, not on your own replies.

• Draft with AI: this button in the reply dialog prepares a reply draft from the comment text and puts it in the box; it does not send it. Read and correct the draft — sending is your decision.

• Hide / Show: the comment is hidden on Instagram and no longer visible under your post. It is not deleted; “Show” brings it back at any time.

• Handled / Unhandled: a follow-up marker kept inside Piyzi only. Nothing changes on Instagram's side; handled comments are shown faded in the list.

• Delete: click the bin icon on the right of the row. If you confirm “This comment will be permanently deleted from Instagram. Are you sure?”, the comment is permanently deleted from Instagram and drops off the Piyzi list.

Replying, drafting, hiding, marking and deleting all require the “Instagram yorumlarını yanıtlayabilir ve yönetebilir” (reply to and manage Instagram comments) permission. Staff without it do not see the buttons and can only read the list.

Notification settings

1. In the left menu, open Messaging → Instagram Comments (or the Inbox).

2. Click the gear button (Notification Settings) at the top; the panel slides in from the right.

3. Turn on the “IG Comment” switch for the people who should be notified and click Save.

• The gear button and the panel are shown to staff whose role has the “Mesajlaşma bildirim ayarlarını yönetebilir” (manage messaging notification settings) permission.

• The same panel is reachable from either screen. If only Instagram Comments is connected, the Inbox does not appear in the menu — in that case the gear button is on the Instagram Comments screen.

• The panel also has WhatsApp, IG Message and Google Review switches; clicking a person's name turns all four on or off together.

• If nothing has been configured, comment notifications go to the business owner only.

• Notifications arrive as push notifications in the mobile app. Staff who have never signed in to the app are flagged with “Not signed in to the app — notifications won't arrive”, and anyone who has turned on Do Not Disturb in their own account (My Account → Notifications) receives none either.

• For comments, at most one notification is sent to a person every 2 minutes, and this limit applies per business: if five comments arrive within two minutes you receive a single notification. For messages the limit applies per conversation instead.

• Tapping the notification opens the IG Comments screen in the mobile app.

Removing the app

1. Open My Business → Pi Store.

2. Click the Instagram Comments card.

3. Click “Disconnect”. There is no confirmation: the connection is removed straight away and the page reloads.

• New comments no longer arrive in Piyzi, and replying, hiding and deleting stop working.

• The Instagram Comments entry disappears from the web panel menu.

• Comments already recorded are not deleted; the integration record is deactivated rather than removed.

• Replies you published and comments you hid on Instagram stay as they are — disconnecting does not undo them.

• You can reconnect at any time by following the same steps.

You can also remove the connection from Instagram: revoke Piyzi's access under the app permissions section of your Instagram account settings. Instagram then notifies Piyzi and both the Instagram Comments and the Instagram DM connections of that account are deactivated. If you send a data deletion request through Meta, the comment and DM records belonging to that account are deleted as well.

Troubleshooting

• The card does not show “Connected”: a pop-up blocker may have interrupted the authorization; disable it and try again. Make sure the account is a business account and that you signed in as an admin.

• Instagram Comments is missing from the menu: the integration is not connected, or your role does not have the “Instagram yorumlarını görebilir” permission.

• Clicking Instagram Comments opens the Calendar: besides “Instagram yorumlarını görebilir”, your role also needs one of the “WhatsApp mesajlarını görebilir” or “WhatsApp mesajı gönderebilir” permissions. Have it added to your role, or manage comments from the mobile app.

• A new comment is not in the list: on the web the list does not refresh by itself, so reload the page. A comment left on another account's post never reaches Piyzi.

• A comment arrived but no notification did: the person's “IG Comment” switch may be off in Notification Settings, they may not be signed in to the mobile app or may have turned on Do Not Disturb, or a comment notification may already have been sent within the last two minutes.

• Replying, hiding or deleting fails: the Instagram authorization may have dropped — because the account password changed or the authorization expired. When that happens a “Your Instagram connection has expired” warning appears at the top of the Comments screen; incoming comments keep arriving but actions stop working. In Pi Store, open the Instagram Comments card, click “Disconnect” and then “Connect with Instagram”. If you removed Piyzi on Instagram's side, the connection is already deactivated; just open the card and click “Connect with Instagram”.

• The post thumbnail is missing: the post was deleted or its image could not be fetched; the comment is still listed and can be replied to.