Acción de API de Instagram

Este documento proporciona detalles completos sobre las acciones disponibles en la integración de Instagram de OneChat, lo que te permite automatizar tareas, interactuar con tus seguidores y gestionar tu cuenta de manera eficiente.

Requisitos previos

• Cuenta de OneChat

• Cuenta comercial de Instagram

Configuración de la integración en OneChat

Inicia sesión en tu cuenta de OneChat.

Accede a "Settings" y luego a "Channels".

Haz clic en "Add Channel" y selecciona "Instagram".

Para más información sobre el paso de integración, haz clic en el enlace de abajo:

Canal de Instagram

Insertar el nodo de acción en tu flujo

Inserta un nodo de acción en tu flujo y ve a Advanced Actions

Selecciona Instagram API

Acciones disponibles

OneChat ofrece una variedad de acciones para automatizar tareas e interactuar con Instagram.

1. Obtener usuario de Instagram

• Descripción: Recupera información sobre un usuario específico de Instagram.

• Respuesta:

name: Nombre del usuario.

• username: Nombre de usuario de Instagram.

• profile_pic: URL de la foto de perfil.

• is_verified_user: Indica si el usuario está verificado.

• follower_count: Número de seguidores.

• is_user_follow_business: Indica si el usuario sigue la cuenta comercial.

• is_business_follow_user: Indica si la cuenta comercial sigue al usuario.

• id: ID de la cuenta de Instagram.

1. Obtener cuenta de Instagram

• Descripción: Recupera información sobre una cuenta de Instagram.

• Parámetros/Campos:

fields (opcional): Lista de campos separados por comas para devolver (por ejemplo, media_count,followers_count).

• Respuesta:

id: ID de la cuenta de Instagram.

• username: Nombre de usuario de Instagram.

• name: Nombre de la cuenta de Instagram.

• media_count: Número de publicaciones multimedia.

• follows_count: Número de usuarios seguidos por la cuenta.

• followers_count: Número de seguidores de la cuenta.

• profile_picture_url: URL de la foto de perfil.

1. Listar contenido multimedia de la cuenta de Instagram

• Descripción: Recupera una lista de publicaciones multimedia de una cuenta de Instagram.

• Parámetros/Campos:

fields (opcional): Lista de campos separados por comas para devolver (por ejemplo, media_url,like_count).

• limit: Limita la cantidad de publicaciones multimedia a devolver.

• Respuesta:

data: Lista de publicaciones multimedia. Cada publicación incluye información como:

• id: ID de la publicación multimedia.

• caption: Descripción de la publicación.

• comments_count: Número de comentarios.

• like_count: Número de Me gusta.

• media_product_type: Tipo de contenido multimedia (por ejemplo, FEED).

• media_type: Tipo de contenido multimedia (por ejemplo, IMAGE).

• permalink: URL permanente de la publicación.

• shortcode: Código corto de la publicación.

• timestamp: Marca de tiempo de la publicación.

• username: Nombre de usuario de Instagram.

• media_url: URL del contenido multimedia.

• paging: Información de paginación para recuperar más publicaciones multimedia.

1. Listar contenido en vivo de la cuenta de Instagram

• Descripción: Recupera información sobre contenido en vivo (transmisiones en vivo) de una cuenta de Instagram.

• Parámetros/Campos ::

fields (opcional): Lista de campos separados por comas para devolver (por ejemplo, media_url,like_count).

• Respuesta:

id: ID del contenido en vivo.

• media_url: URL de la transmisión en vivo.

• viewer_count: Número de espectadores de la transmisión en vivo.

• comments_count: Número de comentarios en la transmisión en vivo.

• like_count: Número de Me gusta en la transmisión en vivo.

• timestamp: Marca de tiempo del contenido en vivo.

1. Obtener detalles de contenido multimedia de Instagram

• Descripción: Recupera información detallada sobre una publicación multimedia específica de una cuenta de Instagram.

• Parámetros/Campos:

id: ID de la publicación multimedia (obligatorio).

• fields (opcional): Lista de campos separados por comas para devolver (por ejemplo, comments_count,like_count).

• Respuesta:

Información detallada de la publicación multimedia, que incluye:

• id: ID de la publicación multimedia.

• caption: Descripción de la publicación.

• comments_count: Número de comentarios.

• like_count: Número de Me gusta.

• media_product_type: Tipo de contenido multimedia (por ejemplo, FEED).

• media_type: Tipo de contenido multimedia (por ejemplo, IMAGE).

• permalink: URL permanente de la publicación.

• shortcode: Código corto de la publicación.

• timestamp: Marca de tiempo de la publicación.

• username: Nombre de usuario de Instagram.

• media_url: URL del contenido multimedia.

1. Listar respuestas a comentarios en Instagram

• Descripción: Recupera una lista de respuestas a comentarios para un comentario específico en una publicación de Instagram.

• Parámetros/Campos:

comment_id: ID del comentario (obligatorio).

• fields (opcional): Lista de campos separados por comas para devolver (por ejemplo, time_stamp,text).

• Respuesta:

id: ID de la respuesta al comentario.

• text: Texto de la respuesta al comentario.

• time_stamp: Marca de tiempo de la respuesta al comentario.

• like_count: Número de Me gusta.

• from: Información sobre el usuario que respondió al comentario (incluye id, username).

1. Responder a comentario en Instagram

• Descripción: Responde a un comentario en una publicación de Instagram.

• Parámetros/Campos:

comment_id: ID del comentario (obligatorio).

• message: Mensaje de la respuesta al comentario (obligatorio).

• Respuesta:

id: ID de la respuesta al comentario.

1. Ocultar comentario en Instagram

• Descripción: Oculta un comentario en una publicación de Instagram.

• Parámetros/Campos:

comment_id: ID del comentario (obligatorio).

• Respuesta:

Mensaje de éxito o error.

1. Eliminar comentario en Instagram

• Descripción: Elimina un comentario en una publicación de Instagram.

• Parámetros/Campos:

comment_id: ID del comentario (obligatorio).

• Respuesta:

Mensaje de éxito o error.

Tutorial en video

TODO_VIDEO[a86de506a8]: reemplazar este video con un recurso oficial de OneChat.

Bpv-w

Responder a comentario en Instagram

Esta acción te permite responder a un comentario en una publicación de Instagram. Además, incluye una opción para guardar la respuesta al comentario como un mensaje del bot, haciéndola visible en el historial del chat.

Parámetros/Campos

• comment_id: ID del comentario (obligatorio).

• message: Mensaje de la respuesta al comentario (obligatorio).

• Save as Bot Message: Cuando está habilitado, el comentario se agregará a los mensajes del chat, pero no al entrenamiento previo.

Guía paso a paso

Paso 1: Agregar la acción Responder a comentario

1. Ve al editor de flujos y selecciona Instagram API.

2. Elige la acción "Reply to Comment".

1. Conecta el flujo con tu automatización de palabras clave de comentarios. (documentación adicional: Comment Keywords)

Paso 2: Configurar la acción

1. En la configuración de la acción, ingresa el ID del comentario.

2. Ingresa el mensaje que se enviará como respuesta.

3. Habilita la opción "Save as Bot Message" si quieres que la respuesta aparezca en el historial del chat.

(Consulta la Imagen 2: Panel de configuración de la acción)

Paso 3: Ver el comentario en el historial del chat

1. Una vez que el bot responda, ve al historial del chat.

2. La respuesta del bot se mostrará en el hilo de la conversación.

3. Esto permite un mejor seguimiento y referencia de las respuestas del bot.

Esto garantiza que las respuestas generadas por el bot a comentarios de Instagram queden registradas en el historial del chat para una mejor visibilidad y seguimiento.