Table of Contents
📌 ¿Qué es este módulo?
Instagram es una red social líder en marketing digital que permite crear contenido visual, ejecutar campañas publicitarias, aumentar el alcance y analizar métricas de interacción. Este módulo permite gestionar publicaciones, reels, comentarios, chats y suscripciones a eventos mediante webhooks.
📚 Descripción de los comandos
🔔 Subscribe to Webhook
Suscribirse a eventos de Instagram mediante webhook.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para suscribirse. | credential |
⏳ Wait for an Event
Esperar un evento desde el webhook de Instagram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para recibir eventos. | credential |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“from”:{“id”:”232323232″,”username”:”test”},”media”:{“id”:”123123123″,”media_product_type”:”FEED”},”text”:”This is an example.”} | {var} |
🗂️ List Posts
Listar publicaciones de Instagram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para listar publicaciones. | credential |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“posts”:[{“id”:”99999999999999999″,”caption”:”🚀 Automatiza sin complicaciones…”,”media_type”:”IMAGE”}]} | {var} |
🖼️ Create Post
Crear una nueva publicación en Instagram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para crear publicaciones. | credential |
| URL de imagen | URL de la imagen a publicar. | https://www.example.com/images/bronz-fonz.jpg |
| Texto (caption) | Texto del post. | This is a test post |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“postId”:”98765432109876543″} | {var} |
🎞️ Create Reel
Crear un reel en Instagram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para crear un reel. | credential |
| URL del video | Enlace del video a publicar. | https://www.example.com/videos/reel.mp4 |
| Texto (caption) | Descripción del reel. | This is a test post |
| Compartir en feed | Indica si se comparte también como publicación. | true |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“reelId”:”99887766554433221″} | {var} |
💬 List Post Comments
Listar comentarios de una publicación específica.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para listar comentarios. | credential |
| Publicación | Enlace o ID de la publicación. | https://www.instagram.com/p/1234567890/ |
| Usuario (opcional) | Filtrar comentarios por nombre de usuario. | MyUsername |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“comments”:[{“text”:”Hola, ¿todavía hay cupos?”}]} | {var} |
↩️ Reply to Comment
Responder a un comentario en un post.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para responder. | credential |
| Publicación | Enlace de la publicación. | https://www.instagram.com/p/1234567890/ |
| Comentario | Comentario al que se responderá. | This is a test comment |
| Mensaje | Mensaje de respuesta. | Hello, this is a reply to your comment |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“reply”:{“id”:”18945678901234567″}} | {var} |
💬 List Chats
Listar chats activos en Instagram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para acceder a los chats. | credential |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“chats”:[{“participant_username”:”johndoe”}]} | {var} |
✉️ Send Message
Enviar un mensaje a un usuario por Instagram.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Instagram necesaria para enviar el mensaje. | credential |
| Usuario | ID del usuario destino. | 1234213123123 |
| Mensaje | Contenido del mensaje. | Hello, this is a reply |
| Asignar variable | Variable donde se almacenará el resultado. Ejemplo: {“message_id”:”aWdfZAG1_1234567890ABCDEF”} | {var} |
🧪 Ejemplo de uso
- List Posts
Consultar publicaciones activas con su texto, imagen y fecha de publicación. - Create Post
Publicar una imagen desde una URL junto con su caption directamente desde Saturn Studio. - Create Reel
Subir un video como Reel y compartirlo también en el feed si se desea. - List Comments
Visualizar todos los comentarios de una publicación con opción de filtrarlos por usuario. - Reply to Comment
Responder a un comentario específico como parte de atención al cliente o interacción. - Send Message
Enviar un mensaje directo desde Saturn Studio a un contacto de Instagram.
🧩 Requisitos
- Contar con una credencial válida de Instagram conectada a una cuenta comercial.
- Tener permisos para publicar y acceder a mensajes/directos.
- Los enlaces de imagen/video deben ser accesibles públicamente o a través del archivo cargado.