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

Conecta con Atención al Cliente →

📑 Encuentre la guía que necesita

Explore el Centro de documentación →

⬇️ Descarga estrategias probadas, ideas de campañas y herramientas expertas

Obtén el Kit de Recaudación de Fondos →

🔗 Deja que tu Asistente de IA haga el trabajo de recaudación de fondos por ti.

Conecta Charitable a tu asistente de IA →

💸 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!

embajadores Nuevo

🖨️ Presentamos Folletos y Carteles: ¡Recauda fondos fuera de la pantalla!

Gran parte de la recaudación de fondos entre particulares ocurre fuera de la pantalla: en la meta de una carrera de 5 km, en un tablón de anuncios escolar, en la cocina de una oficina. Charitable Ambassadors 3.4.7 añade 2 imprimibles: un folleto de recaudación de fondos que lleva la propia historia y código QR de cada recaudador, y un cartel de reclutamiento que inscribe a nuevos recaudadores. Ambos se abren como una página web normal y se imprimen directamente desde el navegador. Por qué esto es importante:

  • 🏁 Un folleto para cada recaudador: Cada uno lleva la foto, la historia y el objetivo del recaudador, con un código QR que abre su página en lugar de la de tu campaña principal.
  • 📌 Un cartel que recluta: Muestra "Reclutando ahora" encima del nombre de tu campaña con un gran código QR que abre tu formulario de inscripción, para que alguien pueda empezar a recaudar fondos sin esperar un enlace tuyo.
  • 🪄 No se necesita herramienta de diseño: Ambos imprimibles se muestran como una página web normal y se imprimen desde el navegador, sin necesidad de plugin PDF ni diseñador.
  • 📄 2 diseños de folleto: "Repartir" lleva la historia completa para dar a amigos y familiares, y "Colgar" lleva un breve gancho con 5 pestañas para arrancar para un tablón de anuncios.
  • 🛡️ Desactivado hasta que lo actives: Los folletos permanecen desactivados después de la actualización hasta que los habilites en Charitable » Ambassadors » Other » Fliers, y solo el propietario o un administrador puede abrir uno.

Consulta nuestro anuncio aquí.

Mejora Pagos

💸 Presentamos las tarifas escalonadas para el alivio de comisiones: ¡Ajusta la petición a la donación!

El alivio de comisiones hace una pregunta corta a tus donantes al finalizar la compra: ¿te gustaría cubrir la comisión de procesamiento de esta donación? Hasta ahora, esa pregunta utilizaba una única tarifa para cada donación en una pasarela, por lo que una donación de 10 $ y una de 500 $ recibían la misma pregunta de porcentaje. El alivio de comisiones 1.3.0 te permite establecer tantas bandas de donación como desees, cada una con su propia tarifa. Por qué esto es importante:

  • 🪙 Más suave con las donaciones pequeñas: Una comisión de transacción fija supone una parte mucho mayor de una donación de 10 $ que de una de 500 $, por lo que las bandas te permiten pedir menos en la parte inferior.
  • 🎚️ Tantas bandas como necesites: Cada banda tiene su propio porcentaje y su propio importe fijo, y la banda superior continúa sin límite superior.
  • 🛑 Un techo opcional: Un campo de comisión máxima evita que se pida a ningún donante más de una cantidad que tú elijas, por muy grande que sea la donación.
  • 🔌 Configurar por pasarela de pago: Stripe puede funcionar con cuatro bandas, mientras que Windcave y Payfast se mantienen con una tarifa única, ya que las bandas pertenecen a una pasarela y no a todo tu sitio.
  • 🛡️ Nada cambia hasta que tú lo digas: Tus tarifas actuales se mantienen exactamente como están hasta que actives Usar tarifas escalonadas en Charitable » Settings » Advanced » Fee Relief.

Consulta nuestro anuncio aquí.

Donaciones Mejora

📊 ¡Tu panel de control Pro ahora puede comparar, exportar y calificar!

La mayoría de los paneles de control de recaudación de fondos solo te dicen cuánto has recaudado. Charitable Pro 1.8.19 reconstruye el panel de control y la Descripción general de informes en torno a las preguntas más difíciles: si algo está roto, si este período superó al anterior y qué cambio único marcaría la mayor diferencia hoy. Por qué esto es importante:

  • 📈 Cada cifra tiene una tendencia: Elige un período y las fichas y el gráfico se mueven juntos, con cada total mostrado frente al período anterior.
  • 🗓️ Gráficos que se mantienen legibles: Los rangos cortos agrupan las donaciones día a día, mientras que los rangos más largos agrupan por semana o mes, por lo que un año completo se lee como una curva en lugar de una línea plana.
  • 🔀 Compara cualquier 2 períodos: No solo los consecutivos, para que puedas preguntar cómo fue este diciembre en comparación con el diciembre pasado. Eso importa porque la recaudación de fondos es estacional.
  • 📤 Exporta el resumen completo: Envía la descripción general completa como CSV o PDF, lista para un paquete de junta directiva o un informe de financiador.
  • 🎯 Califica tu configuración gratis: Haz que tu configuración de recaudación de fondos sea calificada, para que el único cambio que valga la pena hacer a continuación sea el que puedas ver.

Consulta nuestro anuncio aquí.

Función Nuevo

🎟️ Presentamos Eventos Benéficos: ¡Vende entradas dentro de tus campañas!

La mayoría de las organizaciones sin ánimo de lucro venden entradas para eventos en una herramienta y recaudan donaciones en otra, lo que genera dos conjuntos de informes y una conciliación manual al final del año. Eventos Benéficos une ambas cosas, vendiendo entradas a través de los mismos formularios de donación y pasarelas de pago que ya utilizas en Charitable. Por qué esto es importante:

  • 🎟️ Cada entrada es una donación: Las ventas de entradas se procesan a través de la pasarela que ya utilizas y cuentan para el objetivo de la campaña, con todo gestionado en Charitable » Eventos.
  • 📱 Registro con código QR desde cualquier teléfono: Cada asistente recibe su propio código QR en el recibo, y los voluntarios escanean en la puerta a través de un enlace de registro que no necesita cuenta de WordPress.
  • 🧾 Recibos listos para la declaración de impuestos: Asigna a cada tipo de entrada un valor justo de mercado, y Charitable incluirá el importe correcto deducible de impuestos en cada recibo de donante.
  • 📋 Detalles del asistente al finalizar la compra: Pregunta a cada invitado por su elección de comida, talla de camiseta o necesidades de acceso, con un registro de asistente independiente creado para cada entrada.
  • 🗓️ Bloques y calendarios incluidos: Tres bloques de editor, además de la compatibilidad con Sugar Calendar y The Events Calendar, muestran tus eventos donde los colaboradores ya los buscan.

Consulta nuestro anuncio aquí.

ia Nuevo

🚀 ¡Libera el poder de la IA en Charitable!

Tu asistente de IA ahora puede crear, editar y administrar tus campañas de recaudación de fondos de Charitable directamente, solo con pedírselo. Con Charitable Pro añadiendo soporte de escritura para la API de Habilidades de WordPress, herramientas como ChatGPT, Claude y Cursor pueden manejar acciones administrativas completas de forma segura a través de MCP. Por qué esto es importante:

  • 🤖 Creación de campañas en lenguaje natural: Pídele a tu asistente un objetivo como “Configura una recaudación de fondos para el refugio con un objetivo de 5.000 $”, y creará un borrador de campaña real completo con niveles de donación sugeridos.
  • 🎨 Ajustes instantáneos del formulario de donación: Añade campos personalizados, cambia los colores de los botones o reordena elementos sin tener que entrar en la configuración del formulario.
  • 📝 Registro de donaciones sin conexión: Informa a tu asistente sobre donaciones en efectivo o cheque, y cruzará los correos electrónicos de los donantes y registrará las transacciones en tu historial.
  • 🛡️ Seguridad y control por defecto: El acceso de escritura permanece estrictamente desactivado hasta que se active en Charitable » Herramientas » AI MCP, manteniendo el informe de solo lectura seguro por defecto.
  • 📜 Registro de auditoría completo: Cada cambio realizado por un asistente de IA se rastrea en Charitable » Herramientas » Registros, por lo que siempre sabrás quién (o qué) actualizó tu sitio.

Consulta nuestro anuncio aquí.