n8n-nodes-instagram-token
Version:
N8N nodes for Instagram API integration with access token authentication
180 lines (128 loc) • 6.9 kB
Markdown
# n8n-nodes-instagram-token
[](https://www.npmjs.com/package/n8n-nodes-instagram-token)
[](https://opensource.org/licenses/MIT)
[](https://n8n.io)
Professional N8N community nodes for Instagram API integration with **access token authentication**.
> **📌 Fork Notice**: This is a fork of [n8n-nodes-instagram-integrations](https://www.npmjs.com/package/n8n-nodes-instagram-integrations) with enhanced token management and additional features.
[Installation](#installation) • [Features](#features) • [Quick Start](#quick-start) • [Documentation](#documentation)
---
## 🔄 What's Different from the Original?
This fork includes several enhancements over the original [n8n-nodes-instagram-integrations](https://www.npmjs.com/package/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
```bash
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](API_REFERENCE.md)** - Complete API documentation
- **[Authentication Guide](AUTHENTICATION_GUIDE.md)** - Setup and configuration
- **[Migration Guide](docs/MIGRATION_HYBRID_TOKEN.md)** - Migrating from OAuth2
- **[Quick Start](docs/QUICKSTART.md)** - 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](https://github.com/r-milioli/n8n-nodes-insta-accessToken/issues)
- **Documentation**: [GitHub Wiki](https://github.com/r-milioli/n8n-nodes-insta-accessToken/wiki)
- **Community**: [n8n Community Forum](https://community.n8n.io)
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details.
---
## 🙏 Acknowledgments
- **Original Authors** - [n8n-nodes-instagram-integrations](https://www.npmjs.com/package/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**