¿Quieres saber exactamente qué datos llegan a tu Zap cuando se activa un disparador de Charitable? Cada disparador envía un paquete estructurado de campos de donación, donante, suscripción recurrente o campaña, y esta referencia enumera cada campo por tipo de disparador para que puedas mapearlos con confianza al siguiente paso.
Esta guía te guiará a través de los campos disponibles en cada disparador de Zapier de Charitable.
Nota: La integración de Zapier de Charitable requiere Charitable Pro 1.8.14+ y el complemento Automation Connect 2.1.0+ (plan Pro o superior).
Antes de empezar, asegúrate de haber conectado Charitable a Zapier.
- Campos del disparador de donación
- Campos del disparador de suscripción recurrente
- Campos del disparador de campaña
- Entradas de acción y búsqueda
Campos del disparador de donación
Estos campos son enviados por Nueva donación, Donación completada, Donación reembolsada, y Donante por primera vez. La forma exacta del paquete es la misma para los cuatro, por lo que un Zap creado para uno es fácil de adaptar a los otros.
| Campo | Descripción | Ejemplo |
|---|---|---|
donation_id | El ID de publicación interno de WordPress para la donación. | 123 |
evento | El slug del evento del disparador. | donacion_completada |
título | Prefijo del título del donante, cuando se recopila en el formulario. | Sra. |
nombre | Nombre del donante. | Wanda |
apellido | Apellido del donante. | Maximoff |
correo electrónico | Dirección de correo electrónico del donante. | [email protected] |
direccion | Línea de dirección postal. | Unidad 2b |
ciudad | Ciudad. | Novi Grad |
provincia | Estado o región. | Estado de Novi Grad |
codigo_postal | Código postal. | 12345 |
pais | Código de país o nombre completo, según la configuración del formulario. | Sokovia |
telefono | Número de teléfono del donante, cuando se recopila. | 987654321 |
subtotal | El importe base de la donación, antes de comisiones. | 25 |
total | El importe final de la donación que se cobra al donante, incluidas las comisiones que haya cubierto. | 26.50 |
fecha | Marca de tiempo de la donación en formato ISO 8601. | 2026-05-08T14:20:27+00:00 |
estado | Estado interno de Charitable con el prefijo charitable-. Consulte la referencia de estados a continuación. | charitable-completed |
pasarela_donacion | Slug de la pasarela de pago utilizada. | stripe, paypal, manual |
id_transaccion_pasarela | La referencia de la transacción de la pasarela, útil para la conciliación. | ch_abc123def |
modo_prueba | 1 si la donación se realizó en el modo de prueba de la pasarela, de lo contrario 0. | 0 |
id_campaña | La campaña a la que se realizó la donación. Cuando una donación se divide entre varias campañas, esta es una lista de IDs separada por comas. | 8 |
consentimiento_contacto | 1 si el donante aceptó ser contactado, de lo contrario 0. | 1 |
cubrir_comisiones | 1 si el donante optó por cubrir la comisión de procesamiento. | 1 |
importe_comision | La parte del total que cubre las comisiones de la pasarela. | 1.50 |
consentimiento para rastrear | 1 si el donante optó por los píxeles de seguimiento y análisis. | 0 |
Boletín de noticias | 1 si el donante se suscribió al boletín informativo. | 1 |
Gift Aid | 1 si el donante reclamó la bonificación fiscal (donantes del Reino Unido). | 0 |
donación anónima | 1 si el donante optó por mostrarse como anónimo públicamente. | 1 |
comentario del donante | Mensaje de texto libre dejado por el donante con la donación. | En memoria de María |
Valores de estado de la donación
El campo status utiliza los slugs internos de Charitable, todos prefijados con charitable-. Las reglas de filtrado y la lógica condicional deben coincidir con estos valores exactos.
charitable-completed– pago recibido y confirmado por la pasarela. Úselo cuando solo quiera actuar sobre donaciones reales.charitable-pending– fila de donación creada pero pago aún no confirmado. Común para pasarelas fuera de línea y transferencias bancarias.charitable-failed– la pasarela informó de un error. No se cobró al donante.charitable-cancelled– el donante o el administrador abandonaron la transacción.charitable-refunded– la donación fue reembolsada después de completarse.
Campos del disparador de suscripción recurrente
Estos campos son enviados por Nueva Suscripción Recurrente, Donación Recurrente Renovada, Suscripción Recurrente Cancelada, y Pago Recurrente Fallido. La carga útil describe el plan recurrente en sí, no un cargo único.
| Campo | Descripción | Ejemplo |
|---|---|---|
ID de donación recurrente | El ID de la publicación del plan recurrente. | 122 |
evento | El slug del evento del disparador. | subscription_renewed |
ID de la primera donación | El ID de la donación del primer cargo que inició este plan. | 123 |
Subtotal recurrente | El importe base recurrente antes de las comisiones. | 50 |
Total recurrente | El importe recurrente cobrado, incluidas las comisiones. | 53 |
periodo_recurrente | La unidad de recurrencia. | día, semana, mes, año |
Intervalo recurrente | Cuántas unidades de recurring_period entre cobros. 1 = cada mes, 3 = cada tres meses, etc. | 1 |
Duración recurrente | Número total de cobros. 0 significa que no hay fin fijo. | 6 |
Fecha de expiración recurrente | Fecha de finalización del plan, ISO 8601. Vacío si es de duración indefinida. | 2026-09-08T00:00:00+00:00 |
Fecha de renovación recurrente | Fecha del próximo cobro programado, ISO 8601. | 2026-06-01T00:00:00+00:00 |
ID de suscripción de la pasarela | Referencia de suscripción de la pasarela. Útil para conciliar directamente con Stripe o PayPal. | sub_xyz987 |
nombre | Nombre del donante. | Wanda |
apellido | Apellido del donante. | Maximoff |
correo electrónico | Dirección de correo electrónico del donante. | [email protected] |
dirección, dirección_2, ciudad, provincia, código_postal, país, teléfono | Dirección y teléfono del donante, cuando se recopilan en el formulario. | |
subtotal | El importe base del cargo individual más reciente. | 25 |
total | El importe final del cargo individual más reciente. | 26.50 |
fecha | Cuándo se creó el plan, ISO 8601. | 2026-05-08T14:20:27+00:00 |
estado | El estado actual del plan. Ver abajo. | charitable-active |
pasarela_donacion | Slug de la pasarela. | stripe |
modo_prueba | 1 si se creó en modo de prueba. | 0 |
id_campaña | La campaña que apoya el plan. Separado por comas cuando se divide. | 8 |
consentimiento_contacto, cubrir_comisiones, importe_comision, consentimiento_seguimiento, optin_boletin, giftaid_reclamado, donacion_anonima, comentario_donante | Mismos significados que en el payload de donación anterior. | |
ID de cliente de GoCardless | Referencia del cliente de GoCardless, cuando corresponda. | goc123123 |
ID de mandato de GoCardless | Referencia del mandato de GoCardless, cuando sea aplicable. | goc987987 |
Valores del estado de la suscripción recurrente
charitable-active– el plan está activo y se renueva según lo programado.charitable-cancelled– el donante o el administrador canceló el plan.charitable-expired– el plan alcanzó su fecha de finalización.charitable-failed– un intento de renovación falló y el plan está suspendido.
Campos del disparador de campaña
Estos campos son enviados por Campaign Goal Reached y Campaign Ended. La carga útil describe la campaña en sí.
| Campo | Descripción | Ejemplo |
|---|---|---|
id_campaña | El ID de la publicación de la campaña. | 123 |
evento | El slug del evento del disparador. | campaign_goal_reached |
título | Título de la campaña. | Llamada de fin de año |
description | Texto de descripción corta de la campaña. | Ayúdanos a alcanzar nuestro objetivo de igualación |
Objetivo | Objetivo de recaudación de fondos en la moneda de tu tienda. | 2000 |
Monto donado | Total recaudado en el momento en que se activó el evento. | 2045 |
Número de donantes | Número total de donantes únicos. | 38 |
Fecha de finalización | Fecha de finalización de la campaña, ISO 8601. Vacío si la campaña no tiene fecha de finalización. | 2026-12-31T23:59:59+00:00 |
fecha | Cuándo se publicó la campaña por primera vez, ISO 8601. | 2026-05-01T10:00:00+00:00 |
estado | Estado de la publicación de WordPress. | publish |
Enlace permanente | URL pública de la campaña. | https://example.org/campaigns/year-end/ |
ID del creador de la campaña | ID de usuario de WordPress del propietario de la campaña. | 4 |
Nombre del creador de la campaña | Nombre para mostrar del propietario de la campaña. | Bruce Banner |
Correo electrónico del creador de la campaña | Dirección de correo electrónico del propietario de la campaña. | [email protected] |
Destinatario | A dónde van los fondos – normalmente fundraiser para peer-to-peer o parent para campañas secundarias. | fundraiser |
Elemento padre | Si la campaña es hija de peer-to-peer, el ID de la campaña principal. 0para campañas independientes. | 99 |
Tipo de recaudador | Para campañas peer-to-peer, el tipo de recaudador. | individual, equipo |
team_id, team_name, team_captain_id | Metadatos del equipo para recaudadores de equipos peer-to-peer. |
Nota: Para Objetivo de campaña alcanzado, el evento incluye amount_raised, goal, y percent_funded como campos adicionales más allá de la carga útil estándar de la campaña. Estos se calculan en el momento en que se cruzó el objetivo y no se actualizarán después.
Entradas de acción y búsqueda
Los dos pasos de acción y los dos pasos de búsqueda tienen sus propios campos de entrada visibles en el editor de Zap. Dado que los campos de entrada evolucionan con más frecuencia que las cargas útiles de los desencadenadores, esta sección es un resumen rápido en lugar de una tabla exhaustiva: abra el paso en el editor de Zap para obtener la lista completa actual con texto de ayuda.
- Crear donante – acepta campos de perfil de donante (nombre, apellidos, correo electrónico, campos de dirección, teléfono, consentimiento de contacto, suscripción al boletín). Devuelve el registro completo del donante creado o coincidente.
- Actualizar donante – toma un campo de búsqueda (correo electrónico o ID de donante) más cualquiera de los mismos campos de perfil de donante. Solo se cambian los campos que usted proporciona.
- Buscar donante por correo electrónico – toma una entrada, la dirección de correo electrónico. Devuelve el registro completo del donante, o ninguna coincidencia.
- Buscar campaña – toma un slug de campaña o un ID de campaña. Devuelve la carga útil de la campaña descrita en la sección Campos de desencadenador de campaña anterior.
¡Eso es todo! Ahora sabe qué envía cada desencadenador de Zapier de Charitable, lo que significa que el mapeo de campos en cualquier paso posterior de Zap debería ser sencillo. A continuación, consulte Filtrar Zaps de Charitable por campaña para limitar un Zap a campañas o condiciones específicas, y Conectar Charitable a Zapier para la guía principal de inicio.
Preguntas frecuentes
¿Cuál es la diferencia entre subtotal y total?
subtotal es el importe base de la donación que el donante seleccionó. total es lo que se cobró realmente, que puede ser superior si el donante optó por cubrir la comisión de procesamiento de la pasarela. La diferencia aparece en el campo fee_amount.
¿Por qué status siempre empieza con charitable-?
Charitable registra sus propios estados de publicación de WordPress para mantenerlos separados de los estados integrados de WordPress como publish y draft. El prefijo charitable- es interno pero es necesario al filtrar: las reglas de (Texto) Coincide exactamente necesitan el valor completo con prefijo, no solo completed o refunded.
¿Hay algún campo que no esté en esta lista?
Sí. Charitable permite a los desarrolladores añadir campos personalizados de donación, donante y campaña, y cualquier campo marcado show_in_webhook en la API de Campos de Donación se incluye automáticamente en la carga útil junto con los valores predeterminados. Comprueba los datos de ejemplo del desencadenador en el editor de Zap para ver los campos personalizados añadidos por tu instalación específica o por otras extensiones de Charitable.
¿Puedo enviar solo un subconjunto de campos a mi acción posterior?
Sí. El paso de acción del editor de Zap te permite mapear cualquier subconjunto de los campos del desencadenador en las entradas de la acción. Los campos que no mapees simplemente se ignoran. Esta es la forma más limpia de mantener los registros de contactos de CRM despejados.
¿Cómo sé a qué campaña pertenece un recaudador de fondos entre pares?
Mira post_parent en la carga útil de un desencadenador de campaña. Para las campañas secundarias, post_parent contiene el ID de la campaña principal. Para las campañas independientes es 0.
