Documentación de Charitable

Aprende a sacar el máximo partido a Charitable con instrucciones claras y paso a paso.

Asistentes de IA en Charitable: La Referencia Completa

Requiere: Charitable Pro 1.8.18+ y WordPress 6.9+

Actualizado: 17 de septiembre de 2026

Si aún no has conectado un asistente, empieza con Primeros pasos con los asistentes de IA. Esta página es la imagen completa: cada operación, cómo funcionan los permisos y qué está deliberadamente fuera de alcance.

Para obtener documentación más detallada, todo sobre Charitable + AI está aquí »

Cómo funciona

Charitable registra sus operaciones con la API de Habilidades de WordPress, que llegó en WordPress 6.9. Esa es una característica principal de WordPress, no una de Charitable: cualquier plugin puede describir lo que puede hacer, y cualquier cliente conectado puede entonces leer esa descripción y actuar sobre ella.

La consecuencia práctica es que Charitable no ha creado una integración con ningún asistente en particular. Publica sus operaciones en WordPress, y sea cual sea el cliente que conectes, ya sea Claude, ChatGPT o cualquier otro que hable MCP, lee la misma lista. Cuando aparece un nuevo cliente, funciona con Charitable desde el primer día sin que nosotros ni tú tengamos que hacer nada.

En WordPress 6.8 o anterior, no se registra nada y nada de tu sitio cambia.

Lo que puedes hacer

Cada una tiene una descripción escrita para el asistente, diciéndole cuándo la operación es la opción correcta y qué significan sus valores. Nunca las llamas por su nombre. Tú describes lo que quieres y el asistente elige.

Diagnósticos (3)

OperaciónLo que hace
Obtener información del plugin CharitableVersión, estado de la licencia y qué complementos de Charitable están activos.
Obtener entorno del sitioVersiones de WordPress y PHP, tema activo, moneda y estado del modo de prueba.
Obtener estado de la pasarelaQué pasarelas de pago están habilitadas y si cada una está configurada. Nunca incluye claves ni secretos.

Estas son las que permiten a un asistente responder a "¿por qué no aparecen mis donaciones?" con un diagnóstico real en lugar de una suposición.

Campañas (14)

OperaciónLo que hace
Listar CampañasTus campañas, filtrables por estado y ordenables por fecha, título, cantidad recaudada o objetivo.
Obtener CampañaDetalles completos de una campaña.
Obtener rendimiento de la campañaLo que una campaña ha recaudado, su número de donaciones y el progreso hacia el objetivo.
Listar plantillas de campañaLas plantillas del Creador de Campañas disponibles, para que una nueva campaña pueda usar una.
Crear CampañaUna campaña nueva, clásica o visual. Ver Creación de campañas.
Actualizar CampañaCambiar un objetivo, fecha de finalización, descripción o importes de donación sugeridos. Los campos que no menciones se dejarán como están.
Establecer Estado de CampañaPublicar, despublicar o mover entre borrador, pendiente y privado.
Enviar Campaña a la PapeleraMover una campaña a la papelera. Reversible. Rechaza una campaña con donaciones a menos que confirmes.
Restaurar CampañaRecuperar una campaña enviada a la papelera.
Obtener Formulario de Donación de CampañaLos campos del formulario de donación de una campaña, incluidas las opciones y el valor predeterminado de cualquier menú desplegable, radio o casilla.
Actualizar Formulario de Donación de CampañaCambiar campos existentes: etiquetas, marcadores de posición, estado requerido, orden dentro de un paso.
Añadir Campo de Formulario de Donación de CampañaAñadir una nueva pregunta a un formulario de donación. Ver Campos del formulario.
Obtener Estilos de CampañaLos colores de diseño, tipografía y configuración de animación de una campaña, tal como se muestra actualmente.
Actualizar Estilos de CampañaCambiar esos colores y configuraciones. Solo campañas de Campaign Builder.

Donaciones (4)

OperaciónLo que hace
Listar DonacionesDonaciones, filtrables por campaña, donante, estado y rango de fechas.
Obtener DonaciónUna donación completa, incluido en qué campañas se dividió.
Crear Donación ManualRegistrar un regalo que llegó fuera de tu sitio web, como un cheque, efectivo o una transferencia bancaria.
Obtener Resumen de DonacionesTotales, recuentos y promedios para un conjunto de donaciones.

Donantes (3)

OperaciónLo que hace
Listar donantesSus donantes y sus totales. Nunca incluye direcciones de correo electrónico o postales, quienquiera que pregunte.
Obtener donanteUn donante nombrado en su totalidad, con detalles de contacto incluidos. Requiere la capacidad de datos confidenciales.
Obtener donaciones de donanteTodo lo que un donante ha dado. Requiere la capacidad de datos confidenciales.

Informes (5)

OperaciónLo que hace
Obtener resumen de informesTotales para cualquier rango de fechas: recaudado, reembolsado, neto, recuento de donaciones y donantes.
Obtener actividad de informesUn desglose día a día, opcionalmente para una sola campaña. Limitado a 732 días por solicitud.
Obtener campañas principalesSus campañas de mejor rendimiento. Clasificadas de todos los tiempos a menos que proporcione fechas.
Obtener donantes principalesSus mayores patrocinadores, con totales. Clasificados de todos los tiempos a menos que proporcione fechas. Requiere la capacidad de datos confidenciales.
Obtener rangos de fechas de informesLos rangos nombrados disponibles y la fecha del calendario actual, que es cómo un asistente calcula qué significa realmente "el final del próximo mes".

En un sitio multidivisa, cada cifra anterior es el importe convertido, por lo que un informe nunca suma yenes a dólares.

Creación de campañas

Dos tipos, y la diferencia importa:

Las campañas visuales se crean con una plantilla de Campaign Builder y se pueden editar posteriormente en el constructor de arrastrar y soltar. Esto es lo que debería ser una recaudación de fondos creada por IA, y la propia descripción de la operación lo indica. El modo visual configura el diseño y el contenido de la plantilla, sus colores y una escalera de importes de donación sugeridos.

Esa escalera está escalada a su objetivo, por lo que una campaña grande recibe sugerencias proporcionalmente mayores en lugar de importes que un donante tendría que dar cientos de veces:

MetaImportes sugeridos
50.000 $ y más100 / 250 / 500 / 1.000
10.000 $ a 49.999 $50 / 100 / 250 / 500
2.000 $ a 9.999 $25 / 50 / 100 / 250
500 $ a 1.999 $10 / 25 / 50 / 100
Menos de 500 $, o sin objetivo5 / 10 / 15 / 20

Pide tus propias cantidades y obtendrás esas en su lugar. Pide ninguna y no obtendrás ninguna.

El modo visual no configura una pasarela de pago, y no inventa un objetivo ni una fecha de finalización, así que proporciónalos si la campaña los necesita.

Las campañas clásicas son básicas, se editan en el editor de entradas normal de WordPress: sin plantilla, sin colores, sin cantidades sugeridas. Una campaña clásica no tiene estilos de diseño propios, por lo que Actualizar estilos de campaña la rechazará y explicará que sus colores provienen de tu tema, y que abrirla una vez en el Constructor de campañas es cómo convertirla.

Las nuevas campañas se crean como borradores a menos que pidas lo contrario, así que nada se publica por accidente.

Campos de formulario

Un asistente puede añadir diez tipos de pregunta a un formulario de donación: texto de una línea, texto de párrafo, número, teléfono, URL, correo electrónico, fecha, casilla de verificación, botones de radio y desplegable.

Los tres últimos toman un conjunto de opciones y, si quieres, un valor preseleccionado por defecto. “Añade un desplegable para cómo se enteraron de nosotros: Facebook, un amigo, nuestro boletín, por defecto el boletín” funciona como una sola petición. Se requiere al menos una opción, porque un campo de elección sin nada para elegir no es un campo.

Dos cosas que un asistente deliberadamente no puede hacer, porque cualquiera de ellas detendría la visualización de tu formulario:

  • Mover un campo entre pasos de un formulario de varios pasos. Puede reordenar campos dentro de un paso.
  • Eliminar un campo que el formulario necesita para funcionar, es decir, la cantidad de la donación o la sección de pago.

Diseño y estilos

Obtener estilos de campaña informa de los colores, la tipografía y la configuración de animación de una campaña tal como los representa actualmente. Una campaña que nunca ha guardado su pestaña de Estilos informa de la paleta de la plantilla con la que se construyó.

Dos limitaciones honestas, ambas deliberadas:

  • El color del texto del cuerpo no se informa. En una campaña construida a partir de una plantilla no se puede leer de forma fiable, por lo que Charitable no informa de un valor que podría equivocarse. Actualizar estilos de campaña aún puede establecerlo.
  • La familia de fuentes de la campaña no se puede cambiar a través de un asistente. Nada representa esa configuración todavía, y el control de Familia de fuentes del propio Constructor de campañas tiene la misma limitación, por lo que la solicitud se rechaza en lugar de aceptarse e ignorarse silenciosamente.

Los tamaños de tipografía y los ajustes preestablecidos de animación se comprueban con los valores que realmente funcionan. Pide algo que no existe y se te dirá cuáles son los valores aceptados, en lugar de un mensaje de éxito y ningún cambio visible.

El acceso de escritura está desactivado hasta que lo actives

Independientemente de, y además de, todo lo que hay en la sección Permisos de abajo.

Un sitio que nunca ha tocado la configuración permite a un asistente leer sus campañas, donaciones, donantes e informes, y rechaza cada cambio. Nueve de las veintinueve operaciones son cambios: las ocho de campaña que crean, actualizan, publican, envían a la papelera, restauran o cambian el estilo, más el registro de una donación. Las otras veinte son lecturas y nunca se ven afectadas.

Actívalo en Charitable > Herramientas > IA MCP. Esa pantalla también muestra lo que está registrado y si un cliente puede conectarse o no.

Tres cosas que vale la pena entender sobre cómo se comporta:

  • Nada se oculta. Una operación restringida todavía aparece para el asistente, por lo que sabe que la capacidad existe. Intentarla devuelve una negativa que nombra la pantalla a la que ir para cambiar, en lugar de que la operación simplemente no exista, lo que dejaría a un asistente diciéndote que Charitable no puede hacer algo que sí puede.
  • Una negativa no cambia nada en absoluto. La solicitud es rechazada antes de que ocurra cualquier lectura, validación o escritura.
  • Las negativas se registran, en Charitable > Herramientas > Registros filtrados por Habilidades, por lo que un intento de cambiar algo mientras la escritura estaba desactivada deja un registro.

Los desarrolladores pueden anular la configuración en cualquier dirección con el filtro charitable_abilities_allow_write, lo cual es útil para forzar su desactivación en un entorno de prueba independientemente de lo que diga la base de datos.

Permisos

Nada se expone a nadie que no pudiera hacerlo ya en tu panel de control. Cada operación comprueba una capacidad de Charitable antes de ejecutarse, y un asistente conectado como Gestor de Campañas puede hacer estrictamente menos que uno conectado como administrador.

Para hacer estoNecesitas poder
Leer diagnósticosGestionar la configuración de Charitable
Leer o listar campañasEditar campañas, además de leer esa campaña en particular
Crear o editar una campañaEditar esa campaña específica, no solo las campañas en general
Publicar o despublicar una campañaPublicar campañas
Enviar una campaña a la papeleraEliminar campañas publicadas
Leer donaciones, o listar donantesEditar donaciones
Registrar una donación manualEditar donaciones de otros
Ver los detalles de contacto de un donante nombrado, o tus donantes principalesVer datos sensibles de Charitable
Leer informesExportar informes de Charitable

Observa la tercera fila. La edición de una campaña se comprueba contra esa campaña, no contra las campañas como categoría, por lo que en un sitio con varios autores, un creador de campañas no puede acceder al trabajo de otro a través de un asistente.

Lo que está deliberadamente fuera de alcance

  • Todos los cambios, hasta que el acceso de escritura esté activado. Ver arriba. Este es el único límite en esta lista que controlas tú en lugar de nosotros.
  • Credenciales de pago. Tus claves y secretos de pasarela no se incluyen en nada que un asistente pueda leer, a ningún nivel de permiso.
  • Direcciones de correo electrónico y postales de donantes en bloque. Las listas de donantes nunca las llevan, quienquiera que las pida, por lo que una lectura permitida no puede convertirse en una exportación de tu archivo de donantes.
  • Eliminar permanentemente una campaña. Sus registros de donaciones apuntan a ella, y destruirla dejaría huérfanos el dinero que personas reales dieron. La papelera es reversible; la eliminación permanente no se ofrece.
  • Enviar a la papelera una campaña que tiene donaciones, a menos que lo confirmes explícitamente.
  • Desactivar el modo de prueba, habilitar una pasarela o cambiar el estado de una donación. Estos son trabajos del panel de control, a propósito.

Ver lo que hizo un asistente

  • Charitable » Herramientas » Registros, filtrado a Habilidades, registra cada cambio. Si varias personas usan asistentes en tu sitio, dale a cada uno su propia contraseña de aplicación y este registro te dice quién hizo qué.
  • Charitable » Herramientas » Información del sistema tiene una sección API de Habilidades: si las operaciones están registradas, si son visibles a través de la API REST y qué soporta tu versión de WordPress. Empieza aquí cuando un cliente se conecta pero no ve nada.

Solución de problemas

El sitio se conecta, pero no aparecen operaciones de Charitable. 

No es un problema de autenticación. Comprueba que WordPress sea 6.9 o posterior y Charitable Pro sea 1.8.18 o posterior, luego mira Herramientas > Información del sistema.

Tu asistente dice que no puede cambiar nada. 

El acceso de escritura está desactivado, que es el valor predeterminado. Actívalo en Charitable > Herramientas > AI MCP. La lectura no se ve afectada de ninguna manera.

Tu asistente informa de un error de permisos. 

La cuenta que conectaste carece de la capacidad que necesita esa operación, así que revisa la tabla anterior y conéctate como un usuario que la tenga. Esto es diferente a que el acceso de escritura esté desactivado, y el mensaje indica cuál.

Falla un informe día a día durante varios años. 

La actividad de Obtener informes está limitada a 732 días por solicitud, y nombra la operación a usar para un período más largo. Solicita totales en lugar de un desglose diario, o reduce el rango.

«¿Qué campaña está funcionando mejor?» da una respuesta que no esperabas. 

Las campañas principales y los donantes principales se clasifican durante todo el tiempo por defecto y reportan el período que usaron. Si una cifra parece incorrecta, revisa primero el período en la respuesta.

No hay sección de Contraseñas de Aplicación en tu perfil. 

Solo aparece en sitios servidos a través de HTTPS.

Enlaces Útiles

🤝 Obtenga ayuda cuando la necesite

Conéctese con el Soporte al Cliente →  

📑 Encuentre la guía que necesita

Explore el Centro de Documentación →  

⬇️ Descarga estrategias probadas, ideas de campañas y herramientas de expertos
Obtén el Kit de Recaudación de Fondos →  

💸 Obtén recursos gratuitos de recaudación de fondos
Ve al Centro de Recaudación de Fondos de Charitable

¿Tienes preguntas sobre Charitable?
Preguntas frecuentes de Charitable

¿Necesita ayuda para entender la terminología y la jerga de las organizaciones sin ánimo de lucro?
Consulte nuestro Glosario de organizaciones sin ánimo de lucro

¿Todavía tienes preguntas? ¡Estamos aquí para ayudarte!

Última modificación:

Novedades en Benéfico

Ver las últimas actualizaciones
🔔 Suscríbete para recibir nuestras últimas actualizaciones
📧 Suscribirse a correos electrónicos

Suscripción por correo electrónico

Únete a nuestro boletín

No te enviaremos spam. Solo enviamos un correo electrónico cuando creemos que realmente te ayudará. ¡Date de baja en cualquier momento!

Mejora Pagos

💰 Acepta donaciones recurrentes con Windcave y Charitable

Un donante configura su donación una vez en la página de pago segura de Windcave, y Charitable factura cada renovación según lo programado. Por qué esto es importante:

🏦 Organizaciones con sede en Nueva Zelanda o Australia: donaciones mensuales en la pasarela con la que tu banco ya te ha configurado, sin un segundo procesador que incorporar.
⛪ Iglesias que reciben diezmos y ofrendas regulares: los miembros de la congregación establecen su propio calendario una vez, que es la forma más sencilla de lanzar donaciones recurrentes para la iglesia sin una plataforma separada.
🌏 Grupos con donantes en varias divisas: Windcave gestiona más de 20, por lo que un donante puede dar en la divisa que realmente posee.
📅 Fondos operativos en lugar de campañas puntuales: activa el modo Solo Recurrente y la opción única desaparece, por lo que cada donación a esa campaña es una suscripción.
🧾 Equipos sin desarrollador en plantilla: 3 conjuntos de credenciales pegados en una página de configuración, y sin código en ninguna parte.

Consulta nuestro anuncio aquí.

automatización actualizar

⚡ Creador Visual de Automatización: ¡Arrastrar y Soltar Sin Código!

Charitable Automation Connect 2.3.0 presenta el Generador de Automatización Visual, un lienzo a pantalla completa que presenta cada automatización como un flujo de tarjetas conectadas: un desencadenador, condiciones opcionales y una lista de acciones que se ejecutan en orden.

🧩 Muchas acciones, un desencadenador: Etiqueta a un donante, envía un correo electrónico, agrega una nota y activa una llamada webhook desde un solo evento, arrastrado en cualquier orden.

✉️ Actúa dentro de Charitable: Las nuevas acciones Enviar correo electrónico, Etiquetar donante y Agregar nota de donante se ejecutan sin necesidad de un servicio externo.

🔤 Etiquetas de combinación: Personaliza correos electrónicos y notas con campos en vivo como {first_name}, {total} y {campaign_name}.

🔁 Aplicar a donantes existentes: Ejecuta Etiquetar donante y Agregar nota de donante contra los donantes que ya tienes.

🖥️ Lienzo o Simple: Cambia de vista en cualquier momento, y las automatizaciones creadas antes de la 2.3.0 siguen funcionando sin cambios.

Lee más aquí.

Integración actualizado

📬 Presentamos Brevo para Charitable: Convierte donantes en suscriptores automáticamente

El momento en que un donante realiza una donación es cuando está más comprometido. Con la nueva integración de Brevo para Charitable, puedes convertir automáticamente a esos donantes únicos en suscriptores a largo plazo sin tocar una sola hoja de cálculo.

Simplemente recopila el consentimiento del donante directamente en tu formulario de donación y comienza tu serie de bienvenida de inmediato.

Novedades:

🔄 Sincronización automática de suscriptores: Los nuevos donantes que aceptan se añaden directamente a tu lista de contactos de Brevo tan pronto como se procesa su pago, sin necesidad de exportaciones manuales ni importaciones de CSV.

🎯 Control granular de consentimiento y opción de suscripción: Personaliza la etiqueta de tu casilla de verificación, elige si se marca por defecto o no, o activa la doble opción de suscripción de Brevo para mantener tu lista limpia y conforme.

📋 Mapeo de listas por campaña: Dirige a los donantes a tu lista de correo global o mapea campañas específicas a listas de Brevo dirigidas para adaptar tus mensajes de seguimiento.

⚡ Configuración en 5 minutos: Conéctate al instante pegando tu clave API de Brevo en la configuración de Newsletter, mapea tus campos de contacto y empieza a crear tu lista de correo en piloto automático.

¿Listo para hacer crecer tu lista de correo? Brevo ya está disponible a partir del plan Charitable Plus. ¡Conecta tu cuenta hoy mismo!

donaciones recurrentes actualizado

💳 Presentamos Actualizaciones de Tarjeta: ¡Soluciona Tarjetas Caducadas Sin Perder Suscripciones!

Las tarjetas de crédito caducadas o actualizadas son una de las mayores fugas silenciosas en la recaudación de fondos recurrente. Con las actualizaciones de tarjetas en la extensión de donaciones recurrentes, los donantes ahora pueden actualizar sus detalles de pago directamente, manteniendo intactas su suscripción, su calendario y su historial de donaciones.

Sin planes cancelados, sin historial perdido y sin dolores de cabeza administrativos para tu equipo.

Novedades:

⚡ Autoservicio en 30 Segundos: Los donantes obtienen un botón dedicado de “Actualizar Tarjeta” en su panel que abre el Portal de Clientes seguro y compatible con PCI de Stripe para actualizar los detalles de la tarjeta al instante.

🔒 Acceso Seguro y Delimitado: Delimitado exclusivamente a las actualizaciones de tarjetas por defecto, los donantes no pueden cancelar ni alterar accidentalmente sus planes desde el portal, manteniendo tus webhooks y datos sincronizados.

🤝 Soporte Asistido por Administrador: ¿Ayudando a un donante por teléfono? Abre su portal seguro de Stripe con un solo clic desde tu pantalla de administrador o genera un enlace de actualización de un solo uso para enviárselo por correo electrónico.

📋 Pista de Auditoría Automática: Cada actualización de método de pago se registra automáticamente con una marca de tiempo tanto en los registros generales del sistema como en el perfil del donante individual.

¡Listo para proteger tus ingresos recurrentes? Obtén el plan Plus o Pro y actualiza Donaciones Recurrentes a la versión 2.3.0+ y activa “Actualizar Método de Pago” en tu Configuración hoy mismo.

Integración constructor de páginas

¡Fans de Divi, regocíjense! ¡Módulo nativo de barra de progreso de campaña para Divi 5!

Con nuestro nuevo módulo nativo para Divi 5, puedes anclar tus micrositios con estadísticas de recaudación de fondos en tiempo real directamente en el lienzo visual. Así es como funciona y por qué vale la pena activarlo hoy.

Crea actualizaciones de campaña que sean VISUALES Y EN VIVO. También puedes:

📊 Barra de progreso de la campaña: Inserta una barra de progreso en vivo en cualquier diseño de Divi 5 y muestra el progreso de los objetivos en tiempo real.

🎨 Controles de estilo avanzados: Personaliza fácilmente el color de la barra y el seguimiento, la altura y el radio para que coincidan perfectamente con tu marca.

👁️ Listo para el constructor visual: Configura y previsualiza todo directamente en el lienzo de Divi como un módulo de primera clase.

🔁 Renderizado idéntico: El mismo motor exacto impulsa este módulo, lo que significa un diseño consistente sin soluciones alternativas heredadas.

✅ Lanzamientos más rápidos: Nunca salgas de la interfaz de Divi 5 para configurar códigos cortos o adivinar cómo se verán las etiquetas de tus objetivos.

Más información aquí.