Description

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