Eventos de activación

Cuatro eventos de plataforma inician una campaña: un comentario en una publicación de una página de Facebook, un comentario en una publicación de Instagram, un mensaje de Facebook Messenger, y un mensaje directo de Instagram. Cada evento se compara contra las campañas activas vinculadas a la página conectada para la que llegó, y cada campaña cuya versión actual del grafo tiene el nodo de activación coincidente inicia una ejecución. Los clics en botones y los propios comentarios de la página nunca inician una campaña.

Resumen

Evento	Nodo de activación	Plataforma de la campaña	Inicia una ejecución
Comentario en una publicación de página de Facebook	`trigger_comment`	Facebook	Sí, una vez por cada campaña activa coincidente en esa página
Comentario en una publicación de Instagram	`trigger_comment`	Instagram	Sí, una vez por cada campaña activa coincidente en esa página
Mensaje de Facebook Messenger	`trigger_dm`	Facebook	Sí, cuando el mensaje lleva texto y no hay ninguna ejecución en curso para esa persona
Mensaje directo de Instagram	`trigger_dm`	Instagram	Sí, cuando el mensaje lleva texto y no hay ninguna ejecución en curso para esa persona
Clic en un botón dentro de un MD	ninguno	ambas	No — reanuda una ejecución que espera una respuesta
Respuesta en un hilo de comentarios que una ejecución espera	ninguno	ambas	No — reanuda esa ejecución, sin más coincidencia de campaña

Enrutamiento de eventos

Comentario en una publicación de página de Facebook

Nodo de activación: trigger_comment
Plataforma de la campaña: Facebook
Lleva: el comentario, su publicación, el texto del comentario, el nombre de quien comenta, cualquier foto o video adjunto, y el comentario padre en una respuesta

Un comentario en una publicación de una página de Facebook conectada se compara contra cada campaña activa vinculada a esa página. Una campaña cuya activación tiene post_scope establecido en specific solo coincide con comentarios en la publicación nombrada en post_id; una activación con alcance all coincide con comentarios en cualquier publicación de la página.

El alcance de publicación es lo único que filtra una activación de comentario. Un nodo de activación no tiene configuración de palabras clave, así que el filtrado de texto ocurre más abajo en el grafo, en el primer nodo condition que la ejecución alcanza.

Un comentario sin texto — un sticker, o un adjunto publicado sin descripción — llega con el texto de marcador de posición {{sticker}}, así que un nodo de condición siempre tiene algo determinista contra qué coincidir.

Comentario en una publicación de Instagram

Nodo de activación: trigger_comment
Plataforma de la campaña: Instagram
Lleva: el comentario, su contenido multimedia, el texto del comentario, el nombre de usuario de quien comenta, y el comentario padre en una respuesta

Los comentarios de Instagram siguen la misma ruta que los comentarios de Facebook y usan el mismo nodo de activación. La campaña tiene que estar vinculada a la cuenta empresarial de Instagram para la que llegó el comentario; la plataforma de una campaña se deriva de la página a la que apunta, así que vincularla a una cuenta de Instagram es lo que la hace elegible para eventos de Instagram.

Un comentario que reanuda una ejecución en espera en la ruta de Instagram llega con el texto de marcador de posición {{media}} cuando lleva contenido multimedia en lugar de texto.

Mensaje de Facebook Messenger

Nodo de activación: trigger_dm
Plataforma de la campaña: Facebook
Lleva: el remitente y el texto del mensaje

Un mensaje entrante de Messenger primero se verifica contra las ejecuciones que ya están en curso para esa persona en esa página. Una ejecución en curso toma el mensaje como respuesta. Sin ninguna ejecución en curso, AFP busca campañas activas en la página cuyo grafo actual empieza con trigger_dm e inicia una ejecución por cada coincidencia.

El nodo trigger_dm no tiene alcance de publicación ni filtro de texto, así que cualquier MD que lleve texto inicia cada campaña activa trigger_dm en la página. Cuáles de ellas terminan enviando algo lo deciden sus nodos de condición.

Mensaje directo de Instagram

Nodo de activación: trigger_dm
Plataforma de la campaña: Instagram
Lleva: el remitente y el texto del mensaje

Los MD de Instagram se resuelven a una página conectada, ya sea directamente, para una cuenta empresarial de Instagram conectada por sí sola, o a través de la página de Facebook a la que la cuenta está vinculada. Un evento para una cuenta de Instagram que no está conectada a AFP se descarta.

Qué lleva un evento al grafo

Valor	Eventos de comentario	Eventos de MD	Qué lo usa
La persona que lo envió	sí	sí	El destinatario de cada `send_dm` en la ejecución, y el contacto al que aplican `add_tag` y `remove_tag`
Texto del mensaje	el texto del comentario	el texto del mensaje	La coincidencia de `condition`, incluyendo listas de palabras clave
Nombre del remitente	sí	sí	Personalizar el texto de un `send_dm`, `reply_comment`, o `send_comment`
El comentario que activó	sí	no	`reply_comment`, `hide_comment`, y `delete_comment`, que actúan sobre ese comentario
La publicación en la que está el comentario	sí	no	La verificación de `post_scope` de la activación
Una foto o video adjunto	sí	no	Los filtros de medios en una `condition`, como `filter_images`
La página conectada y su plataforma	sí	sí	Decidir dónde se publican las acciones de la ejecución

Una respuesta que reanuda una ejecución en espera lleva texto pero ningún adjunto. Una condition cuyo filtro de imagen está activado por lo tanto no coincide con una respuesta de solo texto, y una rama de “esperar una imagen” enruta las respuestas de texto por la salida Sin coincidencia.

Un evento de MD no lleva comentario ni publicación, por lo cual las acciones de comentario no se pueden agregar a una campaña cuya activación es trigger_dm.

Eventos que no inician una campaña

Evento	Qué pasa
Un comentario eliminado u oculto en la plataforma	Ignorado. Solo se procesan comentarios nuevos.
Actividad de página que no es un comentario	Ignorado.
Un comentario que la propia página publicó, incluyendo uno que una campaña publicó	Ignorado, así que un `reply_comment` o `send_comment` no puede volver a activar su propia campaña.
Un eco de un MD que la página envió	Ignorado, así que un `send_dm` no puede reanudar su propia ejecución.
Un MD sin texto — solo imagen, sticker, o adjunto	Ignorado. No inicia una ejecución ni reanuda una en espera.
Un clic en un botón en un MD	Reanuda una ejecución en espera con la etiqueta del botón como el texto de respuesta; sin ninguna ejecución en curso para esa persona, no pasa nada.
Un segundo evento coincidente de la misma persona mientras su ejecución de esa campaña está en curso	Omitido. Una persona no puede tener dos ejecuciones de la misma campaña en curso a la vez.
Un evento para una página que no está conectada a AFP	Descartado.
Un evento para una página cuyo propietario no tiene una suscripción activa	Ninguna campaña se ejecuta. El comentario se registra como un error de suscripción en el feed de actividad.
Un evento para una página cuyo token de acceso ya no funciona	Ninguna campaña se ejecuta. El comentario se registra como un error de reinicio de sesión hasta que se renueva el acceso de la página.
Un evento en una campaña inactiva, o uno que coincide con una activación en una versión guardada más antigua del grafo	No coincide. Solo la versión actual de una campaña activa inicia ejecuciones.
Un evento en una campaña activa que no tiene grafo guardado, o cuyo grafo no tiene nodo de activación	No coincide. Activar por sí solo no hace elegible a una campaña.

Suscripción de página

Los eventos llegan a AFP solo para una página conectada cuya suscripción de eventos está registrada con la plataforma y verificada. Hasta que ese enlace tiene éxito, los comentarios y MD en la página no producen nada, sin importar cómo esté construida la campaña.

Crear la primera campaña en una página suscribe esa página, así que no hay un paso de suscripción separado que realizar. Cambiar la página a la que apunta una campaña también suscribe la nueva página, y eliminar la última campaña en una página elimina la suscripción de nuevo.

La suscripción cubre la actividad de comentarios en las publicaciones de la página, los mensajes entrantes, y los clics en botones dentro de esos mensajes — los cuatro eventos de activación pasan por ella.

Desactivar una campaña no elimina la suscripción. Los eventos siguen llegando para la página y no coinciden con nada mientras cada campaña en ella está inactiva, por lo cual reactivar una campaña empieza a funcionar de inmediato.

Notas

Cada campaña coincidente en la página inicia su propia ejecución. Dos campañas activas con palabras clave superpuestas se ejecutan ambas para el mismo comentario.
La coincidencia ocurre contra la versión del grafo guardada en el momento en que llega el evento, y la ejecución se queda fija en esa versión toda su vida.
La configuración unique_per_user de una activación restringe qué eventos repetidos de la misma persona inician una campaña. Tipos de nodo cubre lo que restringe.
Un comentario publicado como respuesta dentro de un hilo que una ejecución espera reanuda esa ejecución y se detiene ahí — el comentario no se ofrece a ninguna otra campaña en la página.

Relacionado

Estados de ejecución — qué le pasa a la ejecución que un evento inicia, y cómo termina.
Tipos de nodo — la configuración completa de trigger_comment, trigger_dm, y cada otro nodo.
Reglas de coincidencia de palabras clave — cómo se compara el texto que lleva un evento una vez que la ejecución alcanza una condición.
Prueba y depura campañas — cómo saber cuál de estos eventos llegó a tu campaña.