Publication

Guía de Uso: Componente de Publicación en Instagram (Nappai)

Bienvenido a la documentación del componente Publication en Nappai. Este componente está diseñado para ayudarte a conectar tu sistema de automatización con tu cuenta de Instagram de forma sencilla. Su propósito principal es permitirte publicar mensajes y multimedia (imágenes o videos) en tu perfil automáticamente y consultar los comentarios que reciban tus publicaciones.

Piensa en este componente como un “asistente personal” que se encarga de subir tus fotos y leer lo que la gente dice en Instagram, mientras tú te enfocas en otras tareas.

¿Cómo funciona?

Este componente actúa como un puente seguro entre Nappai y la API de Instagram (gestionada por Meta). Internamente, realiza las siguientes acciones:

Autenticación: Primero verifica que tienes permiso para actuar en nombre de tu cuenta de Instagram utilizando las credenciales que configuras previamente.
Publicación: Si decides crear una publicación, toma la imagen o video que has proporcionado y el texto (legenda) para enviarlos a los servidores de Instagram.
Consulta de Comentarios: Si prefieres no publicar, pero quieres saber qué opina tu audiencia, el componente buscará los comentarios asociados a una publicación específica o a todas tus publicaciones recientes.

Al finalizar, te devolverá un “comprobante” (un código JSON) que indica si la acción fue exitosa y te proporcionará el ID de la nueva publicación, el cual puedes usar para futuros pasos en tu automatización.

Conexión y Credenciales

Para que este componente funcione, es obligatorio conectar tu cuenta de Instagram de forma segura. No necesitas configurar claves API complejas cada vez; en su lugar, usaremos el sistema de Credenciales de Nappai.

Sigue estos pasos para configurar tu conexión:

Dirígete a la sección de Credenciales en tu panel de Nappai.
Crea una nueva credencial seleccionando el tipo Instagram.
Rellena los campos requeridos (Identificador de la API, Token de Acceso y Token de Verificación). Para obtener estos datos, te recomendamos seguir la guía oficial de Instagram Basic Display API. Asegúrate de activar los permisos instagram_basic e instagram_manage_comments.
Una vez guardada la credencial, vuelve a tu flujo de trabajo y en el campo Credential de este componente, selecciona la credencial que acabas de crear.

Entradas

Los siguientes campos están disponibles para configurar este componente. Estos campos te permiten definir qué quieres hacer y con qué datos.

Operation: Define la acción principal que deseas realizar. Este componente está optimizado para dos acciones principales: crear una publicación o obtener información sobre publicaciones existentes.
Media URL: La dirección web (URL pública) de la imagen o video que deseas publicar. Debe ser una URL accesible desde internet. Tip: Puedes usar el componente de Dropbox de Nappai para generar URLs válidas fácilmente.
Type of Media: El formato del archivo que vas a subir. Debes seleccionar si es “Image” (Imagen) o “Video”. Asegúrate de que el archivo cumpla con los estándares técnicos de Instagram.
Publication Text: El texto o leyenda que aparecerá junto a tu imagen o video en Instagram. Es el mensaje que tu audiencia verá.
Publication Id: El identificador único de una publicación específica de Instagram. Úsalo si quieres obtener los comentarios de una publicación concreta. Si dejas este campo vacío en las operaciones de consulta, el sistema intentará devolver comentarios de múltiples publicaciones si es posible.

Salidas

Al ejecutar este componente, Nappai generará una salida estructurada que puedes conectar a otros componentes en tu flujo de automatización.

Ejemplo de Respuesta JSON

El componente devuelve un objeto JSON similar al siguiente cuando la operación se realiza correctamente: json { “status_code”: 200, “success”: true, “data”: { “media_id”: “17841234567890”, “caption”: “¡Hola mundo! Esta es una publicación automática.”, “comments_count”: 0, “message”: “Media published successfully” } }

status_code: Indica si la solicitud fue exitosa (200) o hubo un error.
success: Un valor verdadero/falso que confirma si la operación tuvo éxito.
data: Contiene la información específica, como el media_id de la nueva publicación creada, que es crucial para realizar seguimiento o obtener comentarios posteriormente.

Conectividad

Este componente suele integrarse en flujos de marketing o gestión de redes sociales. Lógicamente:

Entradas: Se conecta generalmente a componentes que generan imágenes (como un generador de diseños) o componentes que almacenan archivos (como Dropbox o Google Drive) para proporcionar la Media URL necesaria.
Salidas: El media_id obtenido en la salida suele conectarse a otros componentes de Instagram (si existen) para obtener comentarios de esa publicación específica, o a bases de datos para registrar las métricas de la publicación.

Ejemplo de Uso

Imagina que quieres automatizar la publicación de tus novedades semanales en Instagram.

Paso 1: Usas un componente de Dropbox para subir una imagen de tu producto. Este componente te devuelve la Media URL.
Paso 2: Conectas esa URL al campo Media URL del componente Publication.
Paso 3: En el campo Publication Text, escribes un mensaje predeterminado como “¡Nuevo producto disponible!”.
Paso 4: Al ejecutar el flujo, el componente Publication sube la imagen a tu Instagram.
Resultado: Recibes el ID de la publicación, confirmando que todo salió bien.

Consejos y Mejores Prácticas

URLs Públicas Asegúrate de que la Media URL sea pública. Instagram no puede descargar archivos privados o que requieran inicio de sesión adicional.
Manejo de Errores: Si la publicación falla, revisa el status_code en la salida. Un código diferente a 200 suele indicar problemas de formato de imagen o permisos.
Uso de Credenciales: Mantén tus credenciales de Instagram actualizadas. Si cambias tu contraseña en Instagram o revocas el acceso, deberás regenerar la credencial en Nappai.

Consideraciones de Seguridad

Acceso Restringido: Este componente interactúa con una API externa. Asegúrate de que solo el personal autorizado pueda acceder a las credenciales de Instagram en el panel de Nappai.
Permisos Mínimos: Al configurar tu credencial en el portal de desarrolladores de Meta, otorga solo los permisos necesarios (instagram_basic para leer perfil básico y instagram_manage_comments para gestionar publicaciones) para minimizar riesgos de seguridad.