n8n-nodes-instagram-token

!Instagram Banner

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:

$3

- 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

$3

- 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

$3

- 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

$3

- 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)

$3

- 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

$3

- 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

$3

- 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

$3

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

$3

``bash
npm install n8n-nodes-instagram-token
`

---

⚡ Quick Start

$3

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

$3

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

$3

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

$3

- 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

$3

- ✅ 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

$3

- ✅ 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