Introduction to Instagram Agent in Kipps.AI

The Instagram Agent in Kipps.AI is an intelligent, autonomous conversational assistant designed specifically for Instagram. Built around a dedicated Instagram Agent entity (InstagramAgent), it grounds automated responses in your company's Knowledge Bases, executes function calls (APIs, CRM lookups, and scheduling), and runs template-driven automations across comments and direct messages.

---

Architectural Overview

The modern Instagram Agent separates social channel authentication from agent intelligence, organizing features into four distinct layers:

1. Meta Webhook Ingestion: Ingests direct messages and post comments from Meta's Graph API in real time.

2. Account Linkage Layer: Associates the connected Instagram account with an InstagramAgent entity using the agent's unique identifier (agentUuid).

3. Agent Reasoning Engine: Combines your attached Multi-Knowledge Base context (RAG vector search) with your selected LLM and unified system prompt instructions.

4. Tool & Action Execution: Executes channel-agnostic function calls (such as Google Calendar scheduling, Shopify product lookups, and human agent handover) before streaming replies back to the user.

5. Dedicated Agent Entity: Your agent configuration (InstagramAgent) is independent of the social connection. It encapsulates your selected LLM provider, model, custom BYOK API keys, temperature, Multi-Knowledge Base grounding, and unified system instructions.

6. Account Linkage: A connected Instagram account is explicitly linked to the agent brain. You can link, unlink, or reconnect accounts at any time without resetting your agent's knowledge or prompt guidelines.

7. Template-Driven Post & Reel Automations: Automated comment-to-comment replies and comment-to-DM triggers are managed through reusable templates in the Template Library, ensuring consistency and high deliverability.

8. Function Calling & Tool Use: The agent can perform real-time actions during conversations, such as checking Google Calendar slot availability, booking meetings, querying CSVs, or escalating to human staff.

---

Sidebar Navigation Breakdown

The Instagram workspace inside Kipps.AI is structured into focused management tabs:

Note: Older legacy settings screens (/instagram/settings, InstructionsForDM, InstructionsForComment, CommentToDM, and FollowersSettings) have been superseded by the InstagramAgent entity and template-driven post assignments.

---

Prerequisites & Meta Requirements

To connect and activate your Instagram Agent:

1. Instagram Professional Account: Must be a Business or Creator account. Personal accounts cannot access Meta's Graph API webhooks.
2. Linked Facebook Business Page: The Instagram profile must be linked to a Facebook Page where you hold Admin / Full Control access.
3. Message Access Permission: In the Instagram mobile app, navigate to Settings and privacy > Messages and story replies > Message controls > Connected tools and verify that Allow access to messages is enabled.
4. Integration: Connect the account via Integrations > Instagram in the Kipps.AI dashboard before linking it to the agent.

---

Recommended Setup Flow

1. Connect Account: Authenticate your Instagram account in Integrations.
2. Configure the Agent Brain: Open the AI Tab, link your Instagram account, attach Knowledge Bases, select an LLM, and refine your system prompt.
3. Build Message Templates: Create interactive cards with buttons in the Template Library.
4. Automate Posts & Reels: Open Posts & Reels and assign templates to trigger on user comments.
5. Explore Functions & Assets: Review Functions and upload reference materials in Assets.

---

Troubleshooting

The Instagram Agent is connected, but incoming direct messages are not receiving automated AI replies. Verify that the account is linked in the AI tab or Instagram Settings (the status badge must indicate Connected to this agent, not Integrated · not linked). Next, verify that Allow access to messages is enabled in the Instagram mobile app under Settings > Messages and story replies > Message controls > Connected tools. Finally, ensure the agent has at least one trained Knowledge Base attached and its prompt instructions are saved.

Comment automations (Comment → Comment or Comment → DM) are not firing on posts or reels. Check the Posts tab to verify that a saved template from your library has been explicitly assigned to that specific post or reel. Also ensure your Meta permissions include instagram_manage_comments and instagram_manage_messages. For Comment → DM, verify that the commenter's account accepts direct message requests from business profiles.

The agent stopped replying and displays an authentication error. Meta Graph API access tokens expire periodically (typically every 60 days) or whenever the managing Facebook account changes its password. Open Integrations → Instagram and click Reconnect to re-authorize through Meta OAuth. Re-authorizing refreshes your token without wiping Knowledge Bases, post assignments, or templates.

Function calls (such as Google Calendar scheduling or Shopify lookups) are not being triggered by the agent. Confirm that the function is properly created and configured under the Functions tab with valid endpoints and parameter schemas. Additionally, verify that your unified system prompt in the AI tab instructs the agent to consult available tools when live availability, pricing, or order status is requested.

---

Frequently Asked Questions

Can I connect a personal Instagram profile to Kipps.AI? No. Meta's official Graph API strictly requires an Instagram Professional Account (Business or Creator) connected to an admin-managed Facebook Page. You can convert your account to a professional account for free inside the Instagram mobile app under Settings > Account type and tools.

What is the difference between "Disconnect" and "Remove Account" in Instagram Settings? Disconnecting is a soft unlink that sets account.agent = null. It pauses automated AI replies while keeping the account authorized with Meta and preserving all conversation threads, templates, and logs. Removing an account is a hard delete that unregisters webhooks, deletes conversation history and templates, and logs the account out of Kipps.AI.

How do template-driven post automations differ from the AI Agent? When a customer sends a private direct message, the AI Agent generates a dynamic, context-aware reply using its attached Knowledge Bases and selected LLM. When a user leaves a comment on a feed post or reel, the Post Automation engine fires the specific pre-built templates assigned to that post in the Posts tab (one public comment reply and one private DM with buttons).

Can human agents reply to Instagram messages manually? Yes. From the Kipps.AI unified inbox, team members can view live Instagram direct message and comment threads, pause AI automation on any active conversation, and reply manually at any time.

Do Instagram templates require Meta approval before sending like WhatsApp templates? No. Unlike WhatsApp message templates, which require advance approval from Meta, Instagram templates in Kipps.AI are internal, flexible message layouts that can be created, updated, and deployed instantly across your posts and DMs without waiting for review.

What is the 24-hour messaging window on Instagram? Under Meta's messaging policies, businesses can send automated or manual responses to customers within 24 hours of the customer's last interaction (inbound DM or post comment).