Documentación de Charitable

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

Conectar Charitable con Zapier

¿Le gustaría enviar los datos de sus donaciones de Charitable a su CRM, herramienta de correo electrónico, hoja de cálculo o aplicación de chat en el momento en que se produce una donación? Zapier conecta Charitable con miles de aplicaciones, por lo que las nuevas donaciones, las renovaciones recurrentes, los registros de donantes y los hitos de las campañas pueden iniciar un flujo de trabajo en cualquier servicio que ya utilice.

Esta guía le guiará a través de los pasos para conectar Charitable con Zapier y crear su primer Zap.

Nota: La integración de Zapier de Charitable requiere Charitable Pro y el complemento Automation Connect (plan Pro o superior).

Antes de empezar, asegúrese de que Charitable Pro esté instalado y activado en su sitio.

Generación de una clave API

La integración de Zapier se ofrece a través del complemento Charitable Automation Connect. Consulte Instalación de extensiones para ver los pasos generales de instalación si aún no lo ha activado.

Zapier se conecta a su sitio Charitable utilizando una clave API, una cadena larga y única que demuestra que Zapier tiene permiso para leer los datos de sus donaciones y escuchar eventos. Cada clave pertenece a un usuario de WordPress, y puede tener varias claves activas al mismo tiempo, con una clave por integración.

Desde el administrador de WordPress, vaya a Charitable » Automation y cambie a la pestaña API Keys.

En el campo Key name en la parte superior de la página, escriba una etiqueta que explique dónde se utilizará la clave; por ejemplo, "Zapier production" o "Zapier – reviewer". La etiqueta es solo para uso interno, nunca se comparte con Zapier ni es visible para los donantes. Cuando esté listo, haga clic en Generate Key.

La nueva clave aparece en la tabla Your API keys de abajo, y el valor completo en texto plano se muestra una vez en la parte superior de la página.

Nota: Asegúrese de copiar la clave inmediatamente. El valor en texto plano solo se muestra una vez y no se puede recuperar más tarde. Si la pierde, genere una nueva clave y actualice Zapier con el nuevo valor.

Conectar Charitable con Zapier

Con su clave API en mano, el siguiente paso ocurre dentro de Zapier.

Desde el editor de Zap, busque Charitable en el selector de aplicaciones y selecciónelo. Zapier le pedirá dos datos.

  • Site URL – la dirección de su sitio Charitable, por ejemplo https://example.org. No incluya una barra inclinada al final. Zapier añade el resto de la ruta automáticamente.
  • API Key – pegue la cadena cak_… que generó en el paso anterior.

Después de confirmar, Zapier envía una solicitud de prueba a su sitio. Una confirmación de éxito en verde significa que la conexión funciona y Zapier ahora puede ver sus donaciones, donantes y campañas.

Nota: Si su sitio aplica SSL, la URL del sitio debe comenzar con https://. Una discrepancia entre el esquema de la URL y la configuración real del sitio es la causa más común de fallos en la conexión.

Eventos desencadenantes

Un disparador es algo que ocurre en tu sitio de Charitable y que inicia un Zap. Charitable proporciona diez eventos de disparador.

  • Nueva donación – se activa en el momento en que se crea una nueva fila de donación en tu sitio, independientemente del estado del pago. Elige esta opción cuando quieras registrar cada intento, incluidos los pendientes.
  • Donación completada – se activa cuando una pasarela de pago marca una donación como completada. Elige esta opción para secuencias de agradecimiento y recibos posteriores a la donación.
  • Donación reembolsada – se activa cuando una donación se reembolsa, total o parcialmente. Útil para la conciliación contable y los flujos de trabajo de relación con el donante.
  • Nueva suscripción recurrente – se activa cuando un donante establece un nuevo plan de donación recurrente. Elige esta opción para incorporar a los donantes recurrentes a una lista de CRM separada.
  • Donación recurrente renovada – se activa cada vez que un cargo de donación recurrente se realiza con éxito. Elige esta opción para correos electrónicos de reconocimiento de renovación o para registrar cada renovación en el CRM.
  • Suscripción recurrente cancelada – se activa cuando se cancela un plan recurrente, ya sea por el donante o por un administrador. Elige esta opción para campañas de recuperación y para actualizar las etapas del ciclo de vida del CRM.
  • Pago recurrente fallido – se activa cuando falla un cargo recurrente programado. Elige esta opción para flujos de trabajo de cobro y alertas de recuperación de donantes.
  • Objetivo de campaña alcanzado – se activa la primera vez que las donaciones de una campaña superan su objetivo. El evento se registra una vez por campaña, por lo que nunca se repite. Elige esta opción para mensajes de celebración a tu equipo o junta directiva.
  • Campaña finalizada – se activa cuando una campaña alcanza su fecha de finalización. Elige esta opción para activar informes de fin de campaña y comunicaciones de cierre.
  • Donante por primera vez – se activa cuando se registra la primera donación completada de un donante. Elige esta opción para secuencias de bienvenida y gestión de donantes por primera vez.

Todos los disparadores se activan instantáneamente en el momento en que ocurre el evento en tu sitio; no hay retraso de sondeo. Cada disparador también se puede limitar a una campaña específica en el editor de Zap, por lo que el Zap solo se ejecuta para esa campaña. Para filtros más avanzados (por pasarela de pago, importe de donación, correo electrónico del donante o cualquier otro campo de datos), añade un paso de Filtrar por Zapier justo después del disparador.

Pasos de acción y búsqueda

Una acción es algo que Zapier hace en tu sitio de Charitable al final de un Zap. Una búsqueda es una acción que busca datos y los introduce en pasos posteriores. Charitable proporciona dos de cada.

  • Crear donante (acción) – añade un nuevo registro de donante a Charitable. Si ya existe un donante con el mismo correo electrónico, se devuelve el registro existente en su lugar, por lo que este paso se puede usar repetidamente sin crear duplicados.
  • Actualizar donante (acción) – actualiza un donante existente por correo electrónico o ID de donante. Solo se cambian los campos que proporcionas; todo lo demás permanece igual.
  • Buscar donante por correo electrónico (buscar): busca un donante de Charitable por correo electrónico y devuelve su registro completo. El Zap se puede configurar para detenerse o continuar cuando no se encuentra ninguna coincidencia.
  • Buscar campaña (buscar): busca una campaña por slug o ID y devuelve el registro completo, incluido el total de donaciones actual y el objetivo.

Creación y prueba de su primer Zap

La forma más rápida de confirmar que la integración funciona de principio a fin es crear un Zap pequeño y observar cómo se activa.

Desde el editor de Zap, selecciona Nueva donación como desencadenador y elige tu cuenta de Charitable conectada. Zapier extraerá una donación real reciente de tu sitio para que puedas mapear los campos contra la forma de datos real, no contra muestras sintéticas.

Para el paso de acción, elige cualquier servicio que ya utilices: Email by Zapier, Slack, Google Sheets o tu CRM. Mapea el nombre del donante y el importe de la donación en los campos de la acción, y luego publica el Zap.

Una vez que el Zap esté activado, haz una pequeña donación de prueba en tu sitio. Una donación de 1 $ a través de tu método de pago habitual funciona bien. En unos segundos, Zapier recibe el evento y la acción se ejecuta.

Si algo no se activa como se esperaba, la pestaña Historial de Zap en Zapier muestra la carga útil exacta que envió Charitable y cualquier error del paso de acción, lo que facilita la detección de un mapeo de campo faltante o un valor mal nombrado.

Solución de problemas

Zapier informa “Error de autenticación” al guardar la conexión

Esto significa que Zapier recibió un error HTTP de tu sitio. Confirma que la clave API es la cadena completa cak_…, es más larga que la mayoría de las claves cortas a las que podrías estar acostumbrado. La URL del sitio debe apuntar a la raíz de la instalación de WordPress, no a un subdirectorio ni a un dominio CDN. Si tu sitio aplica SSL, la URL debe comenzar con https://.

Mi Zap no se activa cuando se realiza una donación

Primero, confirma que el Zap está publicado y activado en el panel de control de Zap. Los Zaps en estado de borrador no reciben eventos. Si está publicado, abre la pestaña Historial de Zap en Zapier: los eventos que envió Charitable aparecerán allí con su carga útil completa. Si no aparece nada en el historial, es posible que tu sitio esté bloqueando las llamadas HTTPS salientes; las causas comunes son plugins de seguridad agresivos, firewalls de solicitudes o entornos de staging donde el tráfico saliente está restringido.

La pantalla de configuración del desencadenador muestra muestras sintéticas en lugar de mis donaciones reales

La configuración del desencadenador extrae tus tres registros coincidentes más recientes para que puedas mapear los campos contra formas reales. Si solo aparecen muestras sintéticas, tu sitio aún no tiene registros recientes de ese tipo. Haz una pequeña donación de prueba y luego haz clic en Buscar registros nuevos en el editor de Zap para actualizar la lista.

Cambié mi clave API y ahora nada funciona

Las claves de API están vinculadas a la conexión de Zapier, no a Zaps individuales. Cuando regeneras una clave, cada Zap con la clave antigua deja de recibir eventos. La solución más rápida es abrir la lista de conexiones de Zapier, editar la conexión de Charitable existente y pegar el nuevo valor cak_… , lo que actualiza todos los Zaps que utilizan esa conexión a la vez.

¡Eso es todo! Charitable ahora está conectado a Zapier y puedes dirigir eventos de donaciones, donantes y campañas a cualquiera de los miles de aplicaciones que Zapier admite. A continuación, consulta Filtrar Zaps de Charitable por Campaña para delimitar Zaps individuales y la Referencia de Campos de Zapier de Charitable para obtener la lista completa de campos que envía cada desencadenador.

Preguntas frecuentes

¿Puedo tener más de una cuenta de Zapier conectada al mismo tiempo?

Sí. Cada conexión de Zapier utiliza una clave de API, y puedes generar tantas claves como necesites desde Charitable » Automatización » Claves de API. Una clave separada por integración facilita la revocación del acceso para una sola herramienta sin interrumpir las demás.

¿Los desencadenadores se activan para las donaciones realizadas antes de que instalara el complemento?

No. Los desencadenadores solo se activan en eventos que ocurren después de que un Zap se publica y está escuchando. Para migrar datos históricos, expórtalos desde Charitable » Donaciones e impórtalos directamente en tu aplicación de destino.

¿Ve Zapier los detalles de la tarjeta de pago de mis donantes?

No. Charitable nunca almacena números de tarjeta, y los datos que recibe Zapier solo contienen campos de perfil del donante, importes de donaciones, detalles de la campaña e identificadores de transacciones de la pasarela.

¿Puedo usar Zapier en una red multisitio?

Sí, pero cada sitio de la red necesita su propia licencia de Charitable Pro, el complemento Automation Connect y una clave de API. Las conexiones de Zapier son por sitio, no por red.

¿Cómo revoco una clave sin romperlo todo?

En la tabla Tus claves de API en la pestaña Charitable » Automatización » Claves de API, cada clave tiene una acción Revocar a nivel de fila. Revocar una clave tiene efecto inmediato y detiene todos los Zaps que utilizan esa clave. Genera un reemplazo primero, actualiza la conexión de Zapier y luego revoca la antigua para evitar interrupciones.

¿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 Recaudadores sin Contraseña: ¡Regístrate solo con tu correo electrónico!

Los seguidores llegan queriendo ayudar, y luego el formulario les pide que inventen una contraseña para un sitio web que quizás solo visiten dos veces. Muchos de ellos se detienen ahí mismo. Las cuentas de recaudación de fondos sin contraseña, nuevas en Charitable Ambassadors 3.5.0, permiten a un seguidor iniciar una recaudación de fondos de persona a persona con solo una dirección de correo electrónico. Por qué esto es importante:

  • 🔑 Sin paso de contraseña para perderlos: Actívalo en Charitable » Ambassadors » Templates » Submit Form y el formulario de creación de recaudación de fondos solo pide un nombre, una dirección de correo electrónico y un título de página.
  • 👤 Sigue siendo una cuenta real de WordPress: Un clic en un correo electrónico confirma la dirección, los inicia y crea la cuenta, para que puedan volver más tarde a editar su historia, cambiar su foto y ver quién ha donado.
  • 🎚️ Tu decisión en cada campaña: Cada campaña de persona a persona puede seguir la configuración predeterminada del sitio o anularla, lo que importa cuando una campaña paga a los recaudadores de fondos a través de Stripe Connect y esas personas necesitan una contraseña.
  • 📋 Ver quién no ha hecho clic todavía: La pestaña Charitable » Ambassadors » Directory » Awaiting Sign-In enumera a todos los que aún esperan, con la campaña a la que se unieron y un botón de Reenviar, para que un error tipográfico o una carpeta de spam sea algo que puedas detectar y corregir.
  • 🛡️ Enlaces que un escáner no puede agotar: Abrir el enlace solo muestra una página, y tu recaudador de fondos inicia sesión cuando presiona el botón en él, por lo que los escáneres de correo electrónico corporativos nunca queman el enlace. Cada uno funciona una vez, expira por sí solo y se almacena solo como un hash.

Consulta nuestro anuncio aquí.

embajadores Nuevo

🏃 ¡Presentamos Actividad: Muestra el progreso en más que solo dinero!

La mayoría de las recaudaciones de fondos entre pares se centran en más que el dinero. Una maratón de lectura se basa en los minutos leídos, una caminata en las millas recorridas y una colecta de alimentos en las comidas preparadas. La Actividad para Embajadores Benéficos permite que tus recaudadores de fondos muestren ese esfuerzo junto a los dólares que recaudan. Por qué esto es importante:

  • 🎯 Progreso en lo que realmente cuentas: Una barra de progreso muestra cada cosa que cuentas contra su propio objetivo, justo al lado del dinero recaudado.
  • 🏅 Hitos para las cosas de sí o no: Una insignia de hito marca los esfuerzos que simplemente están hechos o no hechos, sin un número que perseguir.
  • ✍️ Los recaudadores registran sus propios números: Tus donantes introducen sus totales desde sus propias páginas, para que el esfuerzo deje de vivir en una hoja de cálculo, un comentario o en ningún sitio.
  • 🤖 Algunos números se cuentan solos: Una etiqueta AUTOMÁTICA aparece donde el sitio ha calculado la cifra a partir de donaciones completadas, para que puedas ver de un vistazo lo que nadie ha escrito.
  • 🧩 Configúralo una vez, úsalo en cualquier lugar: Tú decides qué se cuenta una vez, luego eliges qué campañas lo cuentan. Disponible ahora en Embajadores Benéficos 3.4.7, sin complementos nuevos y sin desarrollador.

Consulta nuestro anuncio aquí.

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í.