Disparadores y acciones

Un disparador es el evento que inicia una automatización, por ejemplo un miembro nuevo o un curso terminado. Una acción es lo que hace después la automatización, por ejemplo añadir una etiqueta o enviar un correo. Este artículo los enumera todos con sus campos.

Abrir automatizaciones

Dónde los encuentra

En el editor, la Biblioteca tiene dos pestañas: Disparadores y Acciones. Los bloques integrados están en MemberArea, agrupados en Miembros, Pagos, Cursos, Comunidad, Eventos, Afiliados y Utilities. Las integraciones siguen con su propio nombre. Buscar pasos… busca en nombres y descripciones. Haga clic en un bloque o arrástrelo al lienzo, y luego haga clic en él para completar sus campos.

Crear una automatización

Disparadores de miembros

• Nuevo miembro: se crea una cuenta de miembro.
• Nuevo contacto: se crea un contacto, por ejemplo mediante un formulario de registro. Un contacto todavía no es un miembro, así que las acciones de miembro no hacen nada hasta que use Convertir contacto en miembro.
• Campo de miembro cambiado: cambia un campo de miembro. Elija el campo en Campo de miembro para reaccionar solo a ese campo; si lo deja vacío, cuenta cualquier campo. El valor nuevo está disponible para los pasos como {{value}}. Después de vaciar un campo, está vacío.
• Miembro inició sesión: un miembro inicia sesión, una vez por sesión.
• Etiqueta aplicada y Etiqueta eliminada: se añade una etiqueta a un miembro o se le quita. Elija la etiqueta en Etiqueta para reaccionar solo a esa etiqueta; si lo deja vacío, cuenta cualquier etiqueta.
• Miembro del equipo invitado: un administrador invita a un nuevo miembro del equipo.
• Miembro inactivo: se ejecuta una vez cuando un miembro no ha iniciado sesión durante un número de días. Introduzca el número en Días de inactividad, vea "Acotar un disparador" más abajo. Los miembros que ya están inactivos cuando usted activa la automatización se omiten; reacciona a los miembros que pasan a estar inactivos a partir de entonces.

Disparadores de pagos

• Nuevo cliente: un pedido pagado crea una nueva cuenta de miembro.
• Nuevo pedido: se paga un pedido nuevo.
• Checkout completado: un comprador completa un checkout en línea, sea cual sea el proveedor de pago que lo gestionó.
• Pago en proceso: un pago diferido como la domiciliación SEPA, Klarna o Sofort se autorizó y el dinero todavía está en camino. El comprador ya tiene acceso.
• El pago ha fallado: se rechaza el pago de un pedido, o un dinero que ya se había registrado como pagado se reclama días después.
• Suscripción renovada: una suscripción recurrente se renueva con éxito.
• Pago reembolsado: un pedido se reembolsa, total o parcialmente.
• Suscripción cancelada: un miembro cancela una suscripción.
• Renovación próxima: se ejecuta un número determinado de días antes de que se renueve una suscripción. Introduzca el número en Días antes de la renovación.

Disparadores de cursos

• Lección completada: un miembro completa una lección.
• Curso completado: se completan todas las lecciones obligatorias de un curso.
• Progreso del curso alcanzado: se ejecuta una vez cuando el progreso de un miembro en un curso supera un porcentaje. Introdúzcalo en Umbral de porcentaje, por ejemplo 50. Sin él, el disparador se ejecuta en cada paso de progreso.
• Examen aprobado y Examen suspendido: un miembro aprueba o suspende un examen.

Los cinco pueden acotarse a un curso con Curso. Una lección o un examen pueden estar en un módulo que comparten varios cursos. La automatización se inicia igualmente una vez por cada lección completada o resultado de examen, y Curso coincide cuando cualquiera de esos cursos es el que usted eligió.

Disparadores de la comunidad

• Comunidad: Publicación creada: un miembro crea una publicación, un debate o una encuesta. Foro lo acota a un foro.
• Comunidad: El miembro subió de nivel: un miembro alcanza un nivel superior.
• Comunidad: Denuncia abierta: un miembro o el sistema denuncia un contenido.
• Insignia obtenida: un miembro obtiene una insignia de la comunidad. Insignia lo acota a una insignia.

Disparadores de eventos

• Registro a evento: un miembro se registra en un evento.
• Asistencia al evento: un miembro se marca como asistente, por ejemplo en el check-in.
• El evento empieza pronto: se ejecuta un tiempo determinado antes de que empiece un evento, una vez por cada miembro registrado. Introduzca las horas en Horas antes del inicio, por ejemplo 24.

Evento acota los dos primeros a un evento.

Disparador de afiliados

Comisión de afiliado aprobada se ejecuta cuando una comisión se aprueba y queda bloqueada para el pago. Solo se dispara si usted tiene un programa de socios.

Programación y webhook

Según una programación

Según una programación (cron) inicia la automatización a horas fijas. Tiene dos campos:

• Cron expression (obligatorio): cinco partes para minuto, hora, día del mes, mes y día de la semana. 0 9 * * * significa todos los días a las 09:00, 0 9 * * 1 todos los lunes a las 09:00.
• Zona horaria: la zona horaria a la que se refieren las horas, por ejemplo Europe/Berlin. Es UTC si lo deja vacío.

La programación se comprueba cada minuto. La primera ejecución tiene lugar en la siguiente hora que coincida después de activar la automatización. Una ejecución programada no tiene miembro, así que úsela para pasos que no lo necesitan, como una solicitud externa o una integración que publica para su equipo.

Webhook entrante

Webhook entrante inicia la automatización cuando otro sistema le envía una solicitud, por ejemplo su sitio web, una herramienta de formularios o Zapier.

1. Añada el disparador y guarde la automatización. Hasta entonces, el panel muestra "Guarda la automatización para generar la URL y el secreto del webhook." Una automatización creada a partir de una plantilla, un duplicado o una copia para otra empresa tiene su propia dirección y su propio secreto desde el principio.
2. Haga clic en el disparador. El panel muestra la URL del webhook con Copiar URL y el Secreto con Copiar secreto.
3. En el otro sistema, envíe una solicitud POST a la URL. Ponga el secreto en el encabezado X-Automation-Secret. Envíe los datos como JSON.

Cada campo de primer nivel del cuerpo está disponible para los pasos como {{field}}. Si el cuerpo contiene member_email con la dirección de uno de sus miembros, la ejecución pertenece a ese miembro, y las acciones de miembro y los marcadores de posición funcionan.

La automatización tiene que estar activada y publicada. De lo contrario, la llamada se rechaza, igual que con un secreto incorrecto o ausente. Cada automatización acepta hasta 120 llamadas por minuto. Las llamadas adicionales se rechazan hasta que termina el minuto.

De forma predeterminada, quien llama recibe {"ok": true, "triggers_fired": 1} de inmediato, y los pasos se ejecutan en segundo plano. Si un paso Responder al webhook sigue a este disparador en el flujo, quien llama espera y recibe el estado y el cuerpo que usted haya definido en ese paso. Colóquelo antes de cualquier retraso; de lo contrario, quien llama recibe la respuesta predeterminada. Un paso Responder al webhook en una ruta a la que este disparador nunca llega no cambia nada.

Condiciones, ramas y retrasos

Rotar secreto crea un secreto nuevo después de que usted confirme. El antiguo deja de funcionar de inmediato, así que actualice todos los sistemas que lo usan.

Acotar un disparador

Muchos disparadores tienen campos que los acotan a un elemento o fijan un momento. Se encuentran en los ajustes del disparador justo debajo de Tipo de disparador, antes de Condiciones.

• Curso, Evento, Foro e Insignia son listas con los nombres de sus elementos. La primera opción, como Cualquier curso o Cualquier evento, vuelve a quitar el filtro, y el disparador reacciona a cualquier elemento.
• Los campos sin lista, como Producto, Lección o Calendario, admiten el ID del elemento. Para ver qué ID envía un disparador, abra una ejecución anterior en Ejecuciones y mire la Entrada del disparador.

Tres disparadores necesitan un número y nunca se inician sin él:

Introduzca un número entero de 1 o más. Mientras el campo esté vacío o por debajo de 1, el editor marca el disparador con una advertencia como "«Días de inactividad» debe ser 1 o más." y lo incluye entre los problemas cuando activa la automatización.

Los disparadores sin estos campos, por ejemplo Nuevo miembro o los disparadores de una integración, muestran Filtros en su lugar. Cada fila es una clave y un valor, y el disparador solo inicia la automatización cuando el evento lleva exactamente ese valor bajo esa clave. Use Añadir para más filas; todas las filas deben coincidir.

Pruebas e historial de ejecuciones

Condiciones sobre el miembro

Condiciones comprueba al miembro antes de que se inicie la automatización. Cada fila es el nombre de un campo de la cuenta del miembro y un valor, por ejemplo language y de. El disparador solo inicia la automatización cuando el miembro tiene exactamente estos valores en todas las filas.

Para comprobar más cosas, como una etiqueta que tiene el miembro o un campo personalizado, añada un paso Condición o Filtro después del disparador.

Condiciones, ramas y retrasos

Acciones de miembros

Las acciones de miembros actúan sobre el miembro de la ejecución.

• Agregar etiqueta y Eliminar Etiqueta: Etiqueta elige la etiqueta.
• Añadir al grupo y Eliminar del grupo: Grupo elige el grupo.
• Conceder acceso al curso y Revocar acceso al curso: Curso elige el curso. Un curso que no está publicado no se concede; la ejecución anota que no cambió nada.
• Establecer campo de miembro: Campo de miembro y Valor. El valor se guarda tal como lo escribe.
• Borrar campo de miembro: Campo de miembro se vacía para el miembro.
• Convertir contacto en miembro: crea una cuenta de miembro a partir de un contacto y traslada sus campos. Enviar correo de bienvenida está activado de forma predeterminada.
• Desactivar miembro: desactiva la cuenta del miembro en su plataforma.
• Enviar email: un correo al miembro, sin enlace para darse de baja. Para correos de marketing, use una secuencia de correos. Asunto y Cuerpo son obligatorios. Destinatario se deja vacío para escribir al miembro, o admite la dirección de correo de otro miembro de su plataforma.
• Enviar SMS: envía un mensaje de texto a través de Twilio. Mensaje es obligatorio. Complete su Twilio Account SID, Twilio Auth Token y From number; sin los tres, no se envía ningún SMS. En To number, introduzca un número o [|Phone|] para el número de teléfono del miembro. Si conectó Twilio como integración, su propia acción Enviar SMS usa esa conexión en su lugar.

Acciones de la comunidad

• Crear publicación en la comunidad: publica una entrada en el Foro elegido en nombre del miembro. Foro lista los foros de su plataforma por nombre y requiere que la comunidad esté activada. Título de la publicación es opcional, Post body es obligatorio.
• Otorgar insignia: da al miembro la Insignia elegida.
• Otorgar puntos: da al miembro Puntos, que cuentan para los niveles. Motivo es opcional y aparece en el historial de puntos.

Hacer solicitud externa

Hacer solicitud externa envía una solicitud HTTP a un servidor de su elección, por ejemplo para pasar un miembro nuevo a su propio sistema. Haga clic en Agrega tu solicitud para abrir Editar solicitud:

• Tipo de solicitud: GET, POST, PUT o DELETE.
• URL de solicitud: una dirección https. El campo ofrece campos de miembro para insertarlos como marcadores de posición.
• Encabezados: Agregar encabezado de solicitud añade una Clave y un Valor.
• Cuerpo: el Cuerpo de solicitud como JSON, con una Vista previa al lado.
• Respuesta: la respuesta de su última prueba.

Probar solicitud envía la solicitud de inmediato con el miembro que eligió en Miembro para pruebas. La pestaña Respuesta muestra entonces Encabezados de Respuesta, Cuerpo de Respuesta, Encabezados de Solicitud y Cuerpo de solicitud. Solo se permiten direcciones públicas, y la solicitud no sigue redirecciones. Guardar conserva la solicitud.

En una ejecución, la solicitud se envía como JSON con un límite de tiempo de 15 segundos. Si su servidor responde con un error, no responde a tiempo o redirige, el paso falla y también la ejecución. El error muestra el estado y el comienzo de la respuesta, por ejemplo "La solicitud devolvió HTTP 503: Service Unavailable". Pruebe la solicitud antes de activar la automatización.

Marcadores de posición

Marcadores de posición del miembro

Los campos de texto de las acciones, como el asunto y el cuerpo de un correo, el mensaje SMS, la publicación, el motivo de los puntos y la solicitud externa, sustituyen estos marcadores de posición por los datos del miembro:

• [|First Name|] o : nombre
• [|Last Name|] o : apellido
• [|Email|] o : dirección de correo
• [|Phone|] o {settings.phone}: número de teléfono del perfil
• [|Language|] o : idioma
• [|Member Id|] o : ID del miembro
• [|Image|] o : imagen de perfil
• [|Registered at|] o : fecha y hora del registro
• [|Last Login|] o : fecha y hora del último inicio de sesión
• [|Full Member Data|]: todos los datos del miembro como JSON

Un campo de miembro aparece como [|cf_…|] o {cf_…} con el ID del campo; la solicitud externa lo inserta por usted. Cuando una ejecución no tiene miembro, el nombre, el apellido, el correo y el teléfono proceden de los campos first_name, last_name, email y phone de los datos del disparador, si los tiene.

Marcadores de posición de datos

Los pasos Establecer campos, Condición, Filtro, Comparar, Bucle, Esperar hasta la fecha y Responder al webhook leen los datos de la ejecución:

• {{key}} toma un valor de los datos del disparador o de un paso anterior, por ejemplo {{amount}} de un pedido o un campo que envió su webhook.
• {{member.first_name}} y otros marcadores {{member.…}} leen al miembro de la ejecución. {{member.tags}} y {{member.groups}} devuelven las etiquetas y los grupos del miembro.
• {{member.cf_…}} con el ID de un campo personalizado lee el valor del miembro en ese campo tal como está almacenado. El ID es el del marcador {cf_…} de arriba.

Los campos de acción no leen {{key}}. Para usar datos del webhook en un correo, vincule la ejecución a un miembro con member_email y use los marcadores de posición del miembro.

Disparadores y acciones de integraciones

Cuando conecta un servicio, sus disparadores y acciones aparecen en la biblioteca con el nombre del servicio. Hasta que se conecta, permanecen atenuados con Conectar; al hacer clic en uno se abre el diálogo de conexión, y Añadir integración en la parte inferior de la biblioteca conecta otros servicios. Una automatización con un servicio que no está conectado no se puede activar. Integración en la acción elige la cuenta conectada que se usará.

Los disparadores proceden de Stripe, GoHighLevel, Calendly, Digistore24, Shopify, Hotmart, CopeCart y WooCommerce, por ejemplo para compras, reembolsos, cancelaciones o reservas.

Hay acciones disponibles para:

• Herramientas de automatización: Webhooks, Zapier, Make, n8n y Pabbly.
• Correo y CRM: ActiveCampaign, Brevo, Customer.io, Drip, Flodesk, GetResponse, GoHighLevel, HubSpot, Intercom, Kit, Klaviyo, KlickTipp, Mailchimp, ManyChat, Pipedrive y Quentn.
• Mensajes: Discord, Slack, Twilio y WhatsApp.
• Tienda y contabilidad: Shopify, lexoffice y sevDesk.
• Herramientas de trabajo: Airtable, Asana, ClickUp, Coda, Google Sheets, monday.com, Notion, Trello y Zoom.

Conectar otras herramientas

Iniciar automatizaciones mediante la API

Con una clave de API, su propio software puede listar sus automatizaciones, iniciar una con sus propios datos y leer sus ejecuciones.

Claves de API y acceso para desarrolladores

Artículos relacionados

• Resumen de las automatizaciones
• Crear una automatización
• Condiciones, ramas y retrasos
• Pruebas e historial de ejecuciones