n8n-nodes-instagram-token

Professional N8N community nodes for Instagram API integration with access token authentication.

📌 Fork Notice: This is a fork of n8n-nodes-instagram-integrations with enhanced token management and additional features.

Installation • Features • Quick Start • Documentation

🔄 What's Different from the Original?

This fork includes several enhancements over the original n8n-nodes-instagram-integrations:

✨ New Features:

• Comment Management - Reply to comments automatically, hide/unhide, and delete comments
• Enhanced Token Management - Automatic refresh with smart fallback
• Better Error Handling - More detailed debugging and logs
• Format Validation - Proper audio format support (AAC, M4A, WAV, MP4)
• Performance Improvements - Token caching and optimization

🔧 Technical Improvements:

• Access Token API - Simplified authentication method
• Automatic Token Refresh - No more "refreshToken is required" errors
• Smart Fallback - Uses original token if refresh fails
• Enhanced Logging - Better debugging capabilities

🚀 Features

🔐 Access Token Management

• Automatic token refresh - Tokens refresh automatically before expiration
• Smart fallback - Uses original token if refresh fails
• No more "refreshToken is required" errors - Intelligent token lifecycle management
• Access Token API - Simple authentication with automatic refresh
• Auto-discovery - Automatically fetches Instagram Business Account ID

📬 Instagram Messaging

• Text Messages - Send formatted text with up to 1000 characters
• Image Messages - Share images via public HTTPS URLs
• Audio Messages - Send voice messages (AAC, M4A, WAV, MP4 formats)
• Video Messages - Share video content
• Media Upload - Upload and publish photos, videos, reels, and stories
• Private Replies - Send private replies to commenters directly (with optional quick replies)

💬 Interactive Templates

• Button Templates - Up to 3 action buttons (web links or postbacks)
• Generic Templates - Carousel cards with images and buttons
• Quick Replies - Up to 13 quick response options

📝 Content Management

• Create Posts - Single images, videos, and carousel posts
• Create Reels - Short-form video content
• Create Stories - Temporary 24-hour content
• Comment Management - Reply to comments, hide/unhide comments, and delete comments

🔔 Webhook Events

• Message Events - Incoming messages, postbacks, quick replies
• Comment Events - New comments and mentions
• Opt-in Events - User subscription confirmations

📋 Prerequisites

• n8n (v1.0.0 or higher)
• Instagram Business Account with Messaging API access
• Facebook App with Instagram Basic Display API
• Webhook URL (for receiving events)

🚀 Installation

Method 1: Community Nodes (Recommended)

1. Go to Settings > Community Nodes in n8n
2. Click Install a community node
3. Enter: n8n-nodes-instagram-token
4. Click Install

Method 2: Manual Installation

npm install n8n-nodes-instagram-token

⚡ Quick Start

1. Configure Credentials

1. Create Instagram Access Token API credential
2. Enter your Access Token (long-lived recommended)
3. Enable Auto Refresh Token (recommended)
4. Set Refresh Threshold to 7 days

2. Create Your First Workflow

1. Add Instagram node
2. Select Resource: Message
3. Select Operation: Send Text
4. Configure your message
5. Execute the workflow

3. Set Up Webhooks (Optional)

1. Add Instagram Trigger node
2. Configure webhook URL
3. Set up event handling

📚 Documentation

• API Reference - Complete API documentation
• Authentication Guide - Setup and configuration
• Migration Guide - Migrating from OAuth2
• Quick Start - Getting started guide

🔧 Configuration

Instagram Access Token API

• Access Token: Your Instagram access token
• Instagram Business Account ID: Auto-discovered if not provided
• Auto Refresh Token: Enable automatic token refresh
• Refresh Threshold: Days before expiration (default: 7)
• Webhook Verify Token: Optional webhook verification

What's New in 2.4.1

• ✅ Hide/Unhide Comments - Hide or unhide comments on your posts
• ✅ Delete Comments - Delete comments from your posts
• ✅ Enhanced Comment Management - Complete control over comment moderation

v2.2.0 Highlights

• ✅ Private Replies - Send private replies with plain text or quick replies directly from the message node
• ✅ Authentication Updates - Support Authorization: Bearer header for compatible API scenarios

v2.0.1 Highlights

• ✅ Comment Management - Reply to comments automatically
• ✅ Access Token System - Simplified authentication
• ✅ Enhanced Error Handling - Better debugging and logs
• ✅ Format Support - Proper audio format validation
• ✅ Performance Improvements - Token caching and optimization

🤝 Support

• Issues: GitHub Issues
• Documentation: GitHub Wiki
• Community: n8n Community Forum

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Original Authors - n8n-nodes-instagram-integrations for the foundation
• n8n Team - For the amazing workflow automation platform
• Instagram API - For providing comprehensive messaging capabilities
• Community - For feedback and contributions

Made with ❤️ for the n8n community