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ón | Lo que hace |
|---|---|
| Obtener información del plugin Charitable | Versión, estado de la licencia y qué complementos de Charitable están activos. |
| Obtener entorno del sitio | Versiones de WordPress y PHP, tema activo, moneda y estado del modo de prueba. |
| Obtener estado de la pasarela | Qué 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ón | Lo que hace |
|---|---|
| Listar Campañas | Tus campañas, filtrables por estado y ordenables por fecha, título, cantidad recaudada o objetivo. |
| Obtener Campaña | Detalles completos de una campaña. |
| Obtener rendimiento de la campaña | Lo que una campaña ha recaudado, su número de donaciones y el progreso hacia el objetivo. |
| Listar plantillas de campaña | Las plantillas del Creador de Campañas disponibles, para que una nueva campaña pueda usar una. |
| Crear Campaña | Una campaña nueva, clásica o visual. Ver Creación de campañas. |
| Actualizar Campaña | Cambiar 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ña | Publicar, despublicar o mover entre borrador, pendiente y privado. |
| Enviar Campaña a la Papelera | Mover una campaña a la papelera. Reversible. Rechaza una campaña con donaciones a menos que confirmes. |
| Restaurar Campaña | Recuperar una campaña enviada a la papelera. |
| Obtener Formulario de Donación de Campaña | Los 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ña | Cambiar campos existentes: etiquetas, marcadores de posición, estado requerido, orden dentro de un paso. |
| Añadir Campo de Formulario de Donación de Campaña | Añadir una nueva pregunta a un formulario de donación. Ver Campos del formulario. |
| Obtener Estilos de Campaña | Los 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ña | Cambiar esos colores y configuraciones. Solo campañas de Campaign Builder. |
Donaciones (4)
| Operación | Lo que hace |
|---|---|
| Listar Donaciones | Donaciones, filtrables por campaña, donante, estado y rango de fechas. |
| Obtener Donación | Una donación completa, incluido en qué campañas se dividió. |
| Crear Donación Manual | Registrar un regalo que llegó fuera de tu sitio web, como un cheque, efectivo o una transferencia bancaria. |
| Obtener Resumen de Donaciones | Totales, recuentos y promedios para un conjunto de donaciones. |
Donantes (3)
| Operación | Lo que hace |
|---|---|
| Listar donantes | Sus donantes y sus totales. Nunca incluye direcciones de correo electrónico o postales, quienquiera que pregunte. |
| Obtener donante | Un donante nombrado en su totalidad, con detalles de contacto incluidos. Requiere la capacidad de datos confidenciales. |
| Obtener donaciones de donante | Todo lo que un donante ha dado. Requiere la capacidad de datos confidenciales. |
Informes (5)
| Operación | Lo que hace |
|---|---|
| Obtener resumen de informes | Totales para cualquier rango de fechas: recaudado, reembolsado, neto, recuento de donaciones y donantes. |
| Obtener actividad de informes | Un desglose día a día, opcionalmente para una sola campaña. Limitado a 732 días por solicitud. |
| Obtener campañas principales | Sus campañas de mejor rendimiento. Clasificadas de todos los tiempos a menos que proporcione fechas. |
| Obtener donantes principales | Sus 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 informes | Los 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:
| Meta | Importes sugeridos |
|---|---|
| 50.000 $ y más | 100 / 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 objetivo | 5 / 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 esto | Necesitas poder |
|---|---|
| Leer diagnósticos | Gestionar la configuración de Charitable |
| Leer o listar campañas | Editar campañas, además de leer esa campaña en particular |
| Crear o editar una campaña | Editar esa campaña específica, no solo las campañas en general |
| Publicar o despublicar una campaña | Publicar campañas |
| Enviar una campaña a la papelera | Eliminar campañas publicadas |
| Leer donaciones, o listar donantes | Editar donaciones |
| Registrar una donación manual | Editar donaciones de otros |
| Ver los detalles de contacto de un donante nombrado, o tus donantes principales | Ver datos sensibles de Charitable |
| Leer informes | Exportar 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→


