El Constructor Visual de Automatizaciones convierte Charitable Automation Connect en un lienzo de arrastrar y conectar a pantalla completa donde puedes ver cada automatización como un flujo de tarjetas conectadas: un Disparador, Condiciones opcionales y una o más Acciones que se ejecutan en orden. En lugar de configurar una única webhook en un formulario, ahora construyes un pequeño pipeline que se dispara cuando algo sucede en Charitable, comprueba si tus reglas coinciden y luego ejecuta cada acción que hayas añadido.

Disponible en Charitable Automation Connect 2.3.0 y versiones posteriores.

Características clave

• Crea automatizaciones visualmente en un lienzo a pantalla completa diseñado para coincidir con el Constructor de Campañas de Charitable.
• Ejecuta múltiples acciones por automatización, en orden, desde un único disparador.
• Etiqueta donantes automáticamente dentro de Charitable con la nueva acción Etiquetar Donante, sin necesidad de servicios externos.
• Envía webhooks a Zapier, Make, n8n, Pabbly Connect o cualquier endpoint que acepte una solicitud HTTP POST.
• Controla cada automatización con grupos de condiciones que coincidan con TODAS o CUALQUIERA de tus reglas.
• Aplica una automatización a donantes que ya existen con la función de relleno Aplicar a Donantes Existentes.
• Cambia libremente entre el editor de formulario Sencillo y el constructor de Lienzo, ambos editando la misma automatización.
• Elige entre 21 eventos disparadores en donaciones, donantes, donaciones recurrentes y campañas.
• Prueba y depura cualquier webhook en línea antes de que se ejecute en una donación real.

¿Por qué usar el Constructor Visual de Automatizaciones?

Antes de la versión 2.3.0, cada automatización era una única webhook activada por un único evento. Los flujos de trabajo reales de recaudación de fondos rara vez son tan simples. A menudo quieres que un evento haga varias cosas a la vez, por ejemplo, etiquetar al donante, notificar a tu equipo en Slack y enviar el registro a tu CRM. El Constructor Visual de Automatizaciones te permite ver y gestionar todo ese flujo en una sola pantalla, añadir tantas acciones como necesites y confirmar exactamente lo que se ejecutará antes de que se active. Aporta la claridad de una herramienta de flujo de trabajo visual a tus automatizaciones de donaciones sin pedirte que escribas código.

Verlo en acción

Requisitos

• Charitable Automation Connect 2.3.0 o posterior
• Un plan activo de Charitable Pro que incluya Automation Connect (la entrega se bloquea con una licencia insuficiente o caducada)
• WordPress 6.2 o posterior
• Action Scheduler (incluido con Charitable) para la entrega de webhooks en segundo plano

Empezar

Dónde encontrarlo

1. En tu panel de administración de WordPress, ve a Charitable > Automatizaciones.
2. La lista de Automatizaciones muestra cada automatización, su disparador, estado y última entrega.
3. Haz clic en Añadir para crear una nueva automatización, o haz clic en una existente para editarla.

Las automatizaciones nuevas y basadas en plantillas se abren en el constructor de Lienzo por defecto. Las automatizaciones existentes se abren en la vista que mejor les convenga, con un botón para cambiar.

Los Dos Editores: Sencillo y Lienzo

Cada automatización se puede abrir en una de dos vistas. Ambas editan la misma automatización subyacente y puedes cambiar entre ellas en cualquier momento.

Simple

La vista clásica, incrustada en el panel de administración normal de WordPress. Es ideal para ediciones rápidas: elige un disparador, establece condiciones y configura una única entrega. Usa el enlace Vista de lienzo para abrir la misma automatización en el constructor visual.

Lienzo

El constructor visual a pantalla completa. Ocupa toda la pantalla, al igual que el Constructor de campañas, y muestra:

• Una barra superior con el logotipo de Charitable, un campo de nombre de automatización en vivo, un botón de Guardar y un control de estado.
• Un enlace Vista simple que regresa al editor incrustado. Si tienes cambios sin guardar, te pedirá que guardes primero.
• Una columna de configuración izquierda con cuatro pestañas:Disparador,Condiciones,AccióneInformación.
• El lienzo en sí: tarjetas de Disparador, Condiciones y Acción unidas por líneas de conexión, con un botón deAñadir acción, controles de zoom, ajuste a la cuadrícula y un minimapa. La línea del Disparador a las Condiciones se anima para mostrar la dirección del flujo.

Creación de una automatización

1. Elige un disparador. En la pestaña Disparador, elige el evento que inicia la automatización, por ejemplo, Donación creada o Pago recurrente de donación realizado.
2. Añade condiciones (opcional). En la pestaña Condiciones, crea uno o más grupos de reglas. Déjalo vacío para que se ejecute siempre.
3. Añade acciones. Haz clic enAñadir acción para abrir la paleta de acciones, luego elige Webhook o Etiquetar donante. Cada acción que añadas aparece como una nueva tarjeta en el flujo. Las acciones se ejecutan de arriba abajo.
4. Configura cada acción. Selecciona una tarjeta de acción, luego usa la pestaña Acción para establecer sus opciones.
5. Reordena si es necesario. Arrastra las acciones para cambiar el orden en que se ejecutan.
6. Guardar. Haz clic enGuardar. El botón confirma en línea cuando tus cambios se han almacenado.

Eventos desencadenantes

Automation Connect 2.3.0 incluye 21 eventos de disparador que abarcan el ciclo de vida de las donaciones, los donantes, las donaciones recurrentes y las campañas. Los ejemplos incluyen:

• Donación creada
• Donación completada
• Donante creado (primera donación)
• Pago recurrente de donación realizado
• Objetivo de campaña alcanzado

El selector de disparadores enumera todos los eventos en formato Título. Cada evento muestra texto de ayuda que describe cuándo se activa.

Condiciones

Las condiciones son opcionales. Crea uno o más grupos de reglas y elige si una automatización se ejecuta cuando coincide conTODAS o ALGUNA de las reglas de un grupo. Deja las condiciones vacías para que se ejecute siempre. El constructor de condiciones refleja el estilo de la lógica condicional del Constructor de campañas, por lo que la experiencia resulta familiar.

Acciones

Una automatización ejecuta una lista ordenada de acciones cuando se activa su disparador y sus condiciones se cumplen. La versión 2.3.0 incluye dos tipos de acciones.

Webhook

Envía los datos del evento como una solicitud HTTP POST a cualquier URL. Así es como conectas Charitable con Zapier, Make, n8n, Pabbly Connect y otras herramientas.

Opción	Tipo	Predeterminado	Descripción
URL de entrega	cadena	(vacío)	Requerido. La URL que recibe la solicitud POST del webhook. Debe empezar con https://.
Modo de entrega	elección	Asíncrono	Asíncrono pone en cola la solicitud en segundo plano para un mejor rendimiento.
Tipo de contenido	elección	JSON	JSON (application/json) para Zapier, Make y la mayoría de las herramientas modernas, o codificado en formulario (application/x-www-form-urlencoded) para puntos de conexión que lo esperan.
Secreto	cadena	generado automáticamente	Opcional. Se utiliza para firmar las cargas útiles del webhook. Déjalo en blanco para generar automáticamente.
Encabezados personalizados	lista	(vacío)	Encabezados de solicitud opcionales, como una clave API o un token de portador. Los encabezados Content-Type y signature se gestionan automáticamente y no se pueden anular.
Carga útil	campos	todos los campos	Elige qué campos incluir y arrástralos para reordenarlos. La edición de la carga útil está disponible en modo Simple.

La entrega de webhooks se ejecuta en segundo plano de forma predeterminada. Los webhooks no se aplican durante la retroalimentación.

Etiquetar donante

La primera acción que se ejecuta dentro de Charitable, sin necesidad de un servicio externo. Cambia las etiquetas de un donante cuando se ejecuta la automatización.

Opción	Tipo	Predeterminado	Descripción
Modo	elección	Añadir etiqueta	Añadir etiqueta (mantener etiquetas existentes), Eliminar etiqueta o Reemplazar grupo (promover o degradar dentro de un grupo de etiquetas con nombre).
Grupo	cadena	(vacío)	Se utiliza solo cuando el Modo es Reemplazar grupo. El grupo de etiquetas dentro del cual intercambiar.
Etiquetas	lista	(vacío)	Requerido. La etiqueta o etiquetas a aplicar. Las etiquetas se crean automáticamente si no existen.

Debido a que Etiquetar donante escribe dentro de Charitable, se puede aplicar a donantes existentes a través de la retroalimentación.

Aplicar a donantes existentes (Retroalimentación)

Para automatizaciones cuyas acciones lo admiten, como Etiquetar donante, un control de Aplicar a donantes existentes estima cuántos donantes se verían afectados, te pide que confirmes y luego los procesa en segundo plano. Solo las acciones dentro de WordPress se ejecutan durante una retroalimentación. Las acciones de webhook se omiten, ya que las donaciones pasadas no se realizaron en tiempo real.

Probar y depurar

En la pestaña Probar de una acción de webhook, utiliza Enviar carga útil de prueba para enviar un webhook y ver la respuesta en línea. Puedes probar con datos de ejemplo o con un registro real para ver exactamente qué enviará una entrega en vivo. La prueba omite la entrega asíncrona para que obtengas el resultado de inmediato. Una vez que se guarda una automatización, el historial de entrega y un control de Reenviar te ayudan a diagnosticar fallos.

Compatibilidad

Las automatizaciones creadas antes de la versión 2.3.0 siguen funcionando sin cambios. Una automatización heredada de un solo webhook se trata como una automatización con una acción de webhook, por lo que las entregas y Zaps existentes continúan activándose exactamente como antes. No se requiere ningún paso de migración por su parte.

Solución de problemas

Faltan las líneas de conexión entre las tarjetas

Esto se resolvió en la versión 2.3.0. Si está en la versión actual y aún no ve las líneas, recargue el constructor. Las líneas de flujo se dibujan automáticamente cuando se abre el lienzo.

Una automatización no se activa

Compruebe que el estado de la automatización esté activo, no en pausa o deshabilitado. Solo las automatizaciones activas se envían. Confirme también que su licencia de Charitable Pro esté activa y no caducada, ya que la entrega se bloquea con un plan insuficiente o caducado.

Los webhooks se ponen en cola pero nunca se envían

Los webhooks se envían de forma predeterminada en segundo plano (asíncrona), lo que depende de Action Scheduler. Asegúrese de que las tareas programadas de su sitio se estén ejecutando. Para obtener un resultado inmediato durante las pruebas, utilice el control Enviar carga de prueba o establezca la acción en entrega síncrona.

La retrocarga no envió webhooks a donantes anteriores

Esto es lo esperado. La retrocarga solo ejecuta acciones dentro de WordPress, como Etiquetar donante. Las acciones de webhook se omiten para los donantes existentes por diseño.

Recursos para desarrolladores

Ganchos y filtros

• charitable_automation_connect_actions filtra los tipos de acción registrados, por lo que puede agregar su propia acción.
• charitable_automation_connect_events y charitable_automation_connect_event_labels filtran los eventos de activación registrados y sus etiquetas.
• charitable_automation_connect_events_for_editor filtra la lista de eventos (y el texto de ayuda por evento) que se pasa al constructor.
• charitable_automation_connect_condition_fields filtra los campos disponibles en el constructor de condiciones.
• charitable_automation_connect_templates y charitable_automation_connect_zapier_templates filtran las plantillas de inicio.
• charitable_automation_connect_merge_tags y charitable_automation_connect_payload_fields filtran las etiquetas y los campos de fusión de la carga útil del webhook.
• charitable_automation_connect_default_editor_mode filtra qué editor se abre por defecto.
• charitable_automation_connect_http_args y charitable_automation_connect_secret_key filtran la entrega de webhooks salientes.
• charitable_webhook_subscription_failure_threshold filtra cuántos fallos deshabilitan una automatización.
• charitable_automation_connect_fire_event se activa cuando se envía un evento, para un manejo personalizado.

Notas para extender acciones

Las acciones se registran en el registro de acciones del complemento y cada una extiende una clase abstracta de acción compartida que declara su identificador, etiqueta, grupo, eventos compatibles, si es retrocargable, su esquema de configuración y su método de ejecución. Registre su propia acción en charitable_automation_connect_actions para que aparezca en la paleta Agregar acción.

Recursos adicionales

• Documentación de Automation Connect
• Anuncio del constructor visual de automatizaciones
• Documentación de Zapier