Funciona cuando Instagram está habilitado
Configuración de una respuesta a un callback de Instagram
Debes activar el interruptor en la cuenta de Instagram conectada dentro de la sección Mensajería para que tu bot pueda responder a los comentarios.
Si Instagram muestra "Reconectar para trabajar con comentarios" debajo de tu conexión oficial de Instagram, debes reconectar Instagram para actualizar los permisos necesarios. Para hacerlo, haz clic en el ícono de la papelera en la esquina inferior derecha (eliminar bot).
Vuelve a conectar la cuenta de Instagram. Cómo conectar Instagram, consulta aquí.
Al publicar publicaciones como coautor, todas las notificaciones de comentarios se enviarán a la cuenta desde la cual creas la publicación.
Funciona con comentarios en Reels así como en publicaciones.
Cuando un usuario comenta una publicación, se envía un callback al bot (puedes verlo en la sección "Clientes" dentro del diálogo del usuario).
El callback tiene el formato: client_wall_reply_new link id: text
donde:
-
linkes el enlace de la publicación -
ides el ID del registro -
textes el texto del comentario
Podemos trabajar con los comentarios de dos maneras: responder con tu comentario o escribir un mensaje en Direct.
client_wall_reply_new - es una parte común del callback.
client_wall_reply_new_comment - si nos interesan solo los comentarios en la publicación
client_wall_reply_new_live - si los comentarios son solo durante la transmisión en vivo
Cómo configurar una respuesta automática a comentarios en Direct
La respuesta automática a un comentario NO abre una ventana de 24 horas.
Copia el callback y ve a la sección Constructor de Embudos. Crea un bloque del tipo "Verificación de condición primaria" o "Condición sin estado" y pega el callback copiado en la condición. Estamos configurando una verificación "Por la presencia de palabras clave"
¡ATENCIÓN! No se recomienda usar números como desencadenante para iniciar un bot.
El ID de la publicación puede contener estos números. El bot puede responder a cualquier callback que contenga estos números si elige una coincidencia basada en la presencia de palabras clave.
Si deseas configurar una reacción a comentarios en cualquier publicación para cualquier comentario, entonces en los términos especificas solo client_wall_reply_new_comment.
Al seleccionar una coincidencia, se establece "Coincidencia de palabras clave**".**
Nota importante:
Recomendamos usar el tipo de búsqueda "Coincidencia de palabras clave" al configurar una respuesta de callback.
Recuerda, la lógica de coincidencia para la condición de un bloque debe elegirse según la configuración y los requisitos de tu proyecto. Por lo tanto, ¡asegúrate de probar minuciosamente el flujo de tu chatbot!
Lee sobre cómo elegir una coincidencia en la condición del bloque en el artículo "Tipo de desencadenante y coincidencia".
Si planeas configurar una reacción a una publicación específica, incluye client_wall_reply_new_comment seguido del ID de la publicación en el campo de desencadenante.
¡ATENCIÓN!
No se recomienda usar números como desencadenantes para iniciar tu bot.
Un ID de publicación a menudo consiste en números. Si tu bot usa coincidencia basada en palabras clave, podría responder incorrectamente a cualquier callback que contenga esos números.
Si planeas configurar una reacción a una publicación específica, incluye client_wall_reply_new_comment seguido del ID de la publicación en el campo de desencadenante.
¡ATENCIÓN!
No se recomienda usar números como desencadenantes para iniciar tu bot.
Un ID de publicación a menudo consiste en números. Si tu bot usa coincidencia basada en palabras clave, podría responder incorrectamente a cualquier callback que contenga esos números.
En el campo de respuesta, ingresa el texto que deseas enviar como respuesta a este comentario.
Sobre el mensaje, indica que se envió en respuesta a un comentario. Si haces clic en "Ver publicación", serás redirigido a la publicación que comentaste.
Si un usuario deja un comentario para el cual no has configurado una respuesta (o si no has configurado ninguna respuesta), puedes responderle con un solo Mensaje Directo en la sección "Clientes".
Sin embargo, si intentas enviar al usuario otro Mensaje Directo, el segundo mensaje no se entregará porque responder a un comentario no reabre la ventana de mensajería de 24 horas.
Cómo usar enlaces directos de publicaciones de Instagram al trabajar con comentarios
Para trabajar con comentarios, debes activar el interruptor "Responder a comentarios" en la sección Canales de Instagram.
Cuando un usuario comenta una publicación, aparece una notificación en el chat dentro de la sección Clientes que contiene el texto del comentario, y se genera la variable instagram_media_url con un enlace a la publicación.
Puedes usar la variable instagram_media_url para configurar reacciones a comentarios en publicaciones específicas de Instagram.
Veamos un ejemplo.
Configuración de diferentes respuestas según la publicación comentada
Tarea: La cuenta tiene varias publicaciones, incluyendo tres que presentan productos a diferentes precios. Configura respuestas a comentarios en estas tres publicaciones para responder con el precio exacto. Para todas las demás publicaciones, responde con "A convenir." La respuesta debe enviarse tanto como Mensaje Directo como comentario debajo de la publicación.
Solución:
- Configura reacciones basadas en palabras clave para los comentarios en las publicaciones. Esto significa que el bot reaccionará a cualquier publicación donde un comentario contenga las palabras clave especificadas.
- Usa la función
insta_create_commenten la Calculadora para publicar un comentario debajo de la publicación relevante, mientras también configuras el texto de respuesta en el campo Texto del mensaje para enviar un Mensaje Directo. Esto permite que el usuario reciba el precio simultáneamente tanto en los comentarios como en los Mensajes Directos. - Si aparece un comentario que contiene las palabras clave debajo de cualquier otra publicación, el usuario recibirá un mensaje que dice "a convenir."
Paso 1. En el campo de desencadenante del Bloque de inicio, ingresa client_wall_reply_new seguido de las palabras clave que deseas que activen una respuesta. Establece el tipo de coincidencia en "Coincidencia de palabras clave".
Ejemplo para copiar:
client_wall_reply_new_comment (price|how many|cost|find out)
Si solo deseas responder a comentarios en publicaciones, usa
client_wall_reply_new_comment. Si solo deseas responder a comentarios durante una transmisión en vivo, usaclient_wall_reply_new_live.
Los comentarios en Reels funcionan de la misma manera que en publicaciones simples.
Paso 2. En el campo "Calculadora", declara una variable text. Su valor se determina mediante una condición IF que verifica la variable instagram_media_url.
Ejemplo para copiar (recuerda reemplazar los enlaces con las URL reales de tus publicaciones). Puedes copiar la URL de la variable instagram_media_url en el chat del cliente (sección Clientes) después de que comenten la publicación relevante:
text = if(instagram_media_url == "https://www.instagram.com/reel/Cagzkx", "$10", if(instagram_media_url == "https://www.instagram.com/p/CqvCq4", "$29", if(instagram_media_url == "https://www.instagram.com/p/CocLhN", "$35", "Other")))
Paso 3. Usa el método insta_create_comment para publicar un comentario.
Ejemplo para copiar:
insta_create_comment("#{text}")
donde #{text} es el texto de respuesta que enviamos al usuario.
Paso 4. En el campo Texto del mensaje, ingresa la variable que contiene la respuesta para el Mensaje Directo.
En este ejemplo, la variable es #{text}. La misma respuesta se publica como comentario y se duplica en el Mensaje Directo. Puedes configurar diferentes respuestas para cada uno si es necesario.
client_wall_reply_newes el prefijo común del callback. Para apuntar solo a comentarios en publicaciones, usaclient_wall_reply_new_comment. Para apuntar solo a comentarios durante una transmisión en vivo, usaclient_wall_reply_new_live.
Cómo publicar un comentario en respuesta a un mensaje debajo de una publicación o durante una transmisión en vivo
Al trabajar con comentarios y configurar respuestas debajo de una publicación, usa una función aleatoria y envía un texto variable. Si el bot envía repetidamente texto idéntico, puedes encontrar el error: "Esta llamada API no admite el formato de respuesta solicitado." Puedes obtener más información sobre cómo trabajar con la función aleatoria aquí.
Paso 1. En la sección Clientes, copia el callback (notificación) que indica que se ha publicado un comentario, luego navega al Constructor.
Paso 2. Crea un bloque "Inicio" o "Desencadenante" y pega el callback copiado en el campo Desencadenante.
Hay varias formas de configurar la condición de activación del bot.
En este ejemplo, el bot responde a comentarios en todas las publicaciones con el mensaje "responder en comentarios." Para configurar esto, ingresa el prefijo principal del callback y la palabra clave en el campo de condición:
client_wall_reply_new_comment reply in comments
Importante: establece el tipo de coincidencia en "Coincidencia de palabras clave".
¡ATENCIÓN!
No se recomienda usar números como desencadenantes para iniciar tu bot.
Un ID de publicación a menudo consiste en números. Si tu bot usa coincidencia basada en palabras clave, podría responder incorrectamente a cualquier callback que contenga esos números.
client_wall_reply_newes el prefijo común del callback que se activa tanto para publicaciones como para transmisiones en vivo.Para responder solo a comentarios en publicaciones, usa:
client_wall_reply_new_commentPara responder solo a comentarios durante una transmisión en vivo, usa:
client_wall_reply_new_live
Hay un comportamiento específico para los callbacks de transmisión en vivo (
client_wall_reply_new_live): el bot solo reaccionará durante la transmisión en vivo. Una vez que la transmisión en vivo termina, el bot ya no detectará comentarios debajo de ella y no podrá responder.
Paso 3. En el campo respuesta, ingresa #{none}.
Paso 4. En el campo "Calculadora", escribe:
insta_create_comment("your comment text response")
El texto de tu comentario debe colocarse dentro de los paréntesis.
Luego, haz clic en "Listo".
Con esta configuración, como en el ejemplo, el comentario generado por el bot se publicará en respuesta a cualquier comentario debajo de una publicación que contenga las palabras clave "responder en los comentarios".
Ejemplo de la respuesta de un bot a un comentario en los comentarios.
La respuesta del bot a CUALQUIER comentario debajo de CUALQUIER publicación.
Si ingresas solo el prefijo general del callback client_wall_reply_new en el campo "Desencadenante", tu comentario se publicará en respuesta a comentarios en todas las publicaciones (independientemente del texto que haya escrito el usuario).
La respuesta del bot a UNA FRASE ESPECÍFICA debajo de CUALQUIER publicación.
Si dejas en el campo "Desencadenante" client_wall_reply_new ``y la palabra clave, entonces tu comentario se enviará en respuesta a los comentarios con la palabra clave debajo de todas las publicaciones.
La respuesta del bot a UNA FRASE ESPECÍFICA debajo de UNA PUBLICACIÓN ESPECÍFICA.
Copia el callback completo de la sección de clientes y colócalo en el campo del bloque Inicio:
Puedes responder a comentarios que los usuarios dejan durante una transmisión en vivo (hay una clave separada para ello client_wall_reply_new_live).
Hay una característica especial para las transmisiones en vivo: el bot solo reaccionará durante la transmisión. Si la transmisión ha terminado, el bot no verá los comentarios debajo de esta transmisión y no podrá responder.
Cómo guardar el texto del comentario en una variable
Para guardar el texto del comentario de un usuario, usa la función comment_text().
Inserta el callback client_wall_reply_new en el campo Desencadenante. Luego, en el campo "Calculadora", asigna el texto a una variable—por ejemplo, comm (puedes usar cualquier otro nombre):
comm = comment_text()
A continuación, haz clic en "Agregar condición" en la calculadora y especifica:
comm = comment_text()
Cómo eliminar un comentario
La función insta_delete_comment(comment_id) elimina un comentario.
Si no se proporciona comment_id, la función usa la variable del cliente instagram_last_comment_id.
En caso de éxito, devuelve {"success":true}. Si se proporciona un comment_id inexistente, devuelve {"An unexpected error has occurred. Please retry your request later."}.
Trabajar con menciones de cuentas
Cómo mencionar en medios
Cuando un usuario etiqueta tu perfil en su publicación, tu bot recibirá el siguiente callback:
Aparecen las siguientes variables:
mention_caption — título de la publicación
post_url — enlace de la publicación
mention_comments_count — número de comentarios
mention_like_count — número de Me gusta
mention_media_id — ID de la publicación
Configuremos una reacción para responder a una mención.
Para hacerlo, crea un bloque "Verificación de condición primaria" o "Estado con condición". En el campo "Condición", ingresa mention_in_media y establece el tipo de coincidencia en "Coincidencia de palabras clave".
En el campo "Calculadora", ingresa el siguiente método:
reply_to_mention(text)
donde text es el comentario que aparecerá debajo de la publicación mencionada. Puedes especificar una variable (insertada sin comillas dentro de los paréntesis) o ingresar el texto directamente (entre comillas).
Ejemplo:
Paso 1. Ve al constructor y crea un bloque con un desencadenante (bloque Inicio o bloque Desencadenante). Luego, en el campo Desencadenante, especifica el callback mention_in_media.
Selecciona "Mención en publicación" en la lista de desencadenantes y, como método de calculadora, elige "Comentario de respuesta a una publicación". Luego, ingresa el texto para el comentario de respuesta.
Paso 2. Haz clic en "Agregar desencadenante". El desencadenante junto con el método se ingresarán entonces en el bloque:
Cómo mencionar en un comentario
Cuando un usuario etiqueta tu cuenta en los comentarios, el chat recibirá un callback como:
Si tu cuenta es etiquetada en un perfil privado, no se recibirá el callback.
Las siguientes variables también aparecerán en la tarjeta del cliente:
-
mention_like_count— número de Me gusta -
mention_media_id— ID de la publicación
Configuremos una reacción para responder a una mención en un comentario.
Para hacerlo, crea un bloque "Inicio" o "Desencadenante". En el campo "Condición", ingresa mention_in_comment y establece el tipo de coincidencia en "Coincidencia de palabras clave".
En el campo "Calculadora", ingresa el siguiente método:
reply_to_mention(text)
donde text es el comentario que se publicará en respuesta a la mención. Puedes especificar una variable (insertada sin comillas dentro de los paréntesis) o ingresar el texto directamente (entre comillas).
Ejemplo:
Paso 1. Ve al constructor, crea un bloque con un desencadenante (bloque Inicio o bloque Desencadenante) e ingresa el siguiente callback en el campo "Desencadenante":
A continuación, selecciona la condición "Mención en comentario".
Paso 3. Haz clic en Calculadora y en el campo que aparece, ingresa el método:
reply_to_mention("Response text for mention in comment")
Si la ventana de 24 horas no está abierta en el chat con el usuario, no puedes enviar un mensaje directo en respuesta a la mención. Solo puedes responder con un comentario.
Si la ventana de 24 horas está abierta, puedes ingresar texto en el campo Respuesta, que el usuario recibirá como mensaje directo después de que se mencione tu cuenta.
Cómo mencionar otros perfiles en los comentarios debajo de tus publicaciones
Si alguien es etiquetado en los comentarios debajo de tu cuenta, la variable mentioned_in_comment se crea en la tarjeta del cliente.
Almacena el nombre de usuario de la persona que fue etiquetada.
Si se etiquetan más de dos personas, los nombres de usuario se almacenan en un array.
Si necesitas segmentar usuarios que han etiquetado a dos o más amigos, puedes asignar una variable como len = arr_len(mentioned_in_comment) y luego comparar esa variable con el valor deseado.
Si la ventana de mensajería de 24 horas no está abierta en el chat con el usuario, no puedes enviar un mensaje directo en respuesta a la mención. Solo puedes responder con un comentario.