README

🇪🇸 Español | 🇺🇸 English

🇪🇸 Español

📝 Descripción Detallada

Instagram API Manager es una solución empresarial de código abierto para Laravel 12+, desarrollada para cerrar la brecha entre las complejas especificaciones de la Graph API de Instagram y las aplicaciones modernas. Este paquete no es solo un envoltorio (wrapper) de API; es un ecosistema completo que permite a los desarrolladores gestionar interacciones de Instagram Business a escala.

Desde la automatización de respuestas en Direct Message (DM) hasta la gestión de perfiles comerciales y la implementación de herramientas de crecimiento (Growth Tools), este paquete proporciona una interfaz fluida basada en Facades, Modelos Eloquent y Servicios modulares, permitiéndote centrarte en la lógica de tu negocio mientras nosotros nos encargamos de la complejidad de Meta.

Caution

Aviso de marca y protección de marca (METAS): Este es un paquete de CÓDIGO ABIERTO NO OFICIAL. No está afiliado, asociado, autorizado, respaldado ni conectado oficialmente con Meta Platforms, Inc., Instagram, ni ninguna de sus subsidiarias o afiliadas. Las marcas comerciales "Instagram", "Meta" y "Facebook", así como los nombres, marcas, emblemas e imágenes relacionados, son marcas registradas de sus respectivos propietarios. El uso de este paquete debe cumplir plenamente con las Políticas de la Plataforma de Meta.

Important

Estado del Proyecto: Este paquete se encuentra actualmente en Fase ALFA. Está en desarrollo activo y aún no ha alcanzado la versión Beta ni una versión estable. No se recomienda su uso en entornos de producción. Puedes probarlo y usarlo bajo tu propia responsabilidad.

📖 Documentación

Sección	Descripción
1. 🚀 Instalación	Guía paso a paso para instalar y preparar el entorno Laravel.
2. 🧩 Configuración	Configura tus credenciales de Meta y personaliza el comportamiento del paquete.
3. 👤 Cuentas	Gestión avanzada de perfiles, permisos OAuth e identificación de cuentas.
4. 💬 Mensajería	Envío masivo y filtrado de texto, multimedia, stickers y plantillas interactivas.
5. 🛠️ Automatización	Configuración de la experiencia de chat: Menús persistentes e Ice Breakers.
6. 🔗 Growth Tools	Generación dinámica de enlaces ig.me y códigos QR oficiales de Meta.
7. 📡 Webhooks	Arquitectura de eventos para recibir y procesar mensajes en tiempo real.

✨ Características Principales

✅ Arquitectura Escalable: Diseñado para soportar desde una sola cuenta hasta cientos de perfiles comerciales simultáneamente.
✅ Persistencia Eloquent: Guarda automáticamente conversaciones, contactos y mensajes para facilitar el análisis histórico.
✅ Gestión de Tokens: Automatización del flujo de intercambio de tokens de corta duración por tokens de larga duración.
✅ Mensajería Enriquecida: Soporte completo para Quick Replies, Generic Templates y Reacciones de Instagram.
✅ Seguridad Nativa: Verificación de firmas X-Hub-Signature en webhooks para garantizar que los datos provienen de Meta.

🇺🇸 English

📝 Detailed Description

Instagram API Manager is an enterprise-grade open-source solution for Laravel 12+, built to bridge the gap between complex Instagram Graph API specifications and modern applications. This package is not just an API wrapper; it is a full ecosystem that allows developers to manage Instagram Business interactions at scale.

From automating Direct Message (DM) responses to managing commercial profiles and implementing Growth Tools, this package provides a fluid interface based on Facades, Eloquent Models, and modular Services, allowing you to focus on your business logic while we handle the complexity of Meta.

Caution

Trademark Notice & Protection (METAS): This is an UNOFFICIAL OPEN SOURCE package. It is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Meta Platforms, Inc., Instagram, or any of its subsidiaries or affiliates. The trademarks "Instagram", "Meta", and "Facebook", as well as related names, marks, emblems, and images, are registered trademarks of their respective owners. Use of this package must fully comply with Meta Platform Policies.

Important

Project Status: This package is currently in ALPHA Phase. It is under active development and has not yet reached Beta or a stable version. Use in production environments is not recommended. You may test and use it at your own risk.

📖 Documentation

Section	Description
1. 🚀 Installation	Step-by-step guide to install and prepare the Laravel environment.
2. 🧩 Configuration	Configure your Meta credentials and customize package behavior.
3. 👤 Accounts	Advanced profile management, OAuth permissions, and account identification.
4. 💬 Messaging	Batch sending and filtering of text, media, stickers, and interactive templates.
5. 🛠️ Automation	Chat experience setup: Persistent menus and Ice Breakers.
6. 🔗 Growth Tools	Dynamic ig.me link generation and official Meta QR codes.
7. 📡 Webhooks	Event architecture for receiving and processing messages in real-time.

✨ Key Features

✅ Scalable Architecture: Designed to support from a single account to hundreds of business profiles simultaneously.
✅ Eloquent Persistence: Automatically saves conversations, contacts, and messages for easy historical analysis.
✅ Token Management: Automates the flow of exchanging short-lived tokens for long-lived tokens.
✅ Rich Messaging: Full support for Instagram Quick Replies, Generic Templates, and Reactions.
✅ Native Security: X-Hub-Signature verification on webhooks to guarantee data comes from Meta.

🚀 Instalación Rápida / Quick Start

composer require scriptdevelop/instagram-api-manager

use ScriptDevelop\InstagramApiManager\Facades\Instagram;

// Enviar un mensaje / Send a message
Instagram::message()
    ->withAccessToken($token)
    ->withInstagramUserId($igId)
    ->sendTextMessage('RECIPIENT_ID', 'Welcome to Instagram API Manager!');

🤝 Contribuir / Contributing

¡Las contribuciones son lo que hacen a la comunidad open source un lugar increíble para aprender, inspirar y crear! Si deseas mejorar este paquete:

Haz un Fork del proyecto.
Crea una Rama para tu mejora (git checkout -b feature/AmazingFeature).
Haz Commit de tus cambios (git commit -m 'Add some AmazingFeature').
Haz Push a la rama (git push origin feature/AmazingFeature).
Abre un Pull Request.

📄 Licencia / License

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Desarrollado con ❤️ por Wilfredo Perilla de ScriptDevelop.

scriptdevelop / instagram-api-manager

Maintainers

Details