Conecta Charitable a Brevo (anteriormente Sendinblue) para que los donantes que acepten en tus formularios de donación se añadan automáticamente a tu lista de contactos de Brevo, con sus detalles mapeados a los atributos de contacto de Brevo. Disponible en la extensión Charitable Newsletter Connect, versión 2.4.0 y posteriores.
Beta: El soporte de Brevo está actualmente en Beta. Es seguro usarlo en producción, y estamos recopilando activamente comentarios. Si algo no se comporta como se espera, tu registro de actividad de Charitable (ver Monitorización a continuación) captura los detalles.
Características clave
- Añade donantes a una lista de Brevo elegida automáticamente cuando acepten en un formulario de donación.
- Mapea los campos de donante de Charitable a los atributos de contacto de Brevo (nombre, apellido y tus propios atributos personalizados).
- Doble opción de confirmación opcional, para que un donante confirme por correo electrónico antes de ser suscrito.
- Establece una lista predeterminada para todas las campañas, o elige una lista diferente por campaña.
- Soporte completo de GDPR: exportación de datos de donantes y borrado permanente a través de las herramientas de privacidad de WordPress.
- Cada intento de suscripción y error se registra en el registro de actividad de Charitable para facilitar la resolución de problemas.
¿Por qué usar Brevo?
Cada donación es una oportunidad para construir una relación duradera, pero eso solo sucede si puedes mantener el contacto. Brevo es una de las plataformas de marketing por correo electrónico y CRM más populares, especialmente para organizaciones sin fines de lucro en Europa. Con esta integración, los donantes que aceptan fluyen directamente a tu audiencia de Brevo en el momento en que donan, para que puedas enviar secuencias de agradecimiento, actualizaciones de campañas y solicitudes sin exportar o importar un solo CSV.
Verlo en acción
Requisitos
- Charitable Pro con la extensión Newsletter Connect, versión 2.4.0 o posterior
- Una cuenta de Brevo
- Una clave API v3 de Brevo (no la clave SMTP)
Empezar
Encuentra tu clave API de Brevo
- Inicia sesión en tu cuenta de Brevo.
- Ve a SMTP y API, luego abre la pestaña Claves API.
- Copia tu clave API v3. Esta es la clave que comienza con
xkeysib-. No uses la clave SMTP.
Si tu cuenta de Brevo tiene habilitada la función de seguridad Direcciones IP autorizadas, añade la IP del servidor de tu sitio web a la lista de permitidos en Brevo en Seguridad > IPs autorizadas. De lo contrario, Brevo rechazará las llamadas API de tu sitio con un error 401.
Conecta Brevo en Charitable
- En tu administrador de WordPress, ve a Charitable > Ajustes > Marketing > Newsletters.
- Busca Brevo en la lista de proveedores y haz clic en Configurar.
- Pega tu clave API v3 en el campo Clave API y haz clic en Guardar cambios.
- Cuando la clave se acepta, los atributos de tu contacto de Brevo aparecen en la tabla de Campos de suscriptor.
Uso
Mapear tus campos de suscriptor
La tabla de Campos de suscriptor enumera los atributos disponibles en tu cuenta de Brevo. Para cada uno, elige el campo de Donación benéfica que debe rellenarlo. Por defecto, Donación benéfica mapea:
- Email a la dirección de correo electrónico del donante
- FIRSTNAME al nombre del donante
- LASTNAME al apellido del donante
Deja cualquier atributo establecido en el guion ( – ) si no deseas enviar un valor para él.
Atributos de número de teléfono: Brevo requiere que los atributos de SMS, WhatsApp y línea fija estén en formato de teléfono internacional, por ejemplo
+14155550123. Brevo rechaza el contacto completo si un número de teléfono no es válido, así que deja estos sin mapear a menos que tu formulario de donación recopile números de teléfono en ese formato.
Elegir una lista
En la pantalla principal de configuración de Boletines, usa Lista predeterminada para elegir la lista de Brevo a la que los donantes se unen por defecto. Puedes anular esto por campaña en la configuración del boletín de la campaña.
Elegir cómo los donantes aceptan
Usa Modo de aceptación predeterminado para controlar la aceptación del boletín en tus formularios de donación:
- Casilla de aceptación, no marcada por defecto: el donante debe marcar la casilla para unirse.
- Casilla de aceptación, marcada por defecto: la casilla está premarcada; el donante puede desmarcarla.
- Aceptación automática: cada donante se suscribe, sin mostrarse ninguna casilla.
También puedes personalizar la etiqueta de la casilla con Etiqueta de aceptación predeterminada.
Habilitar doble aceptación (opcional)
Activa Doble aceptación para que Brevo envíe un correo electrónico de confirmación antes de que un donante se añada a tu lista. El donante solo se suscribe después de hacer clic en el enlace de confirmación. Cuando la doble aceptación está activada, elige la plantilla de doble aceptación de Brevo e introduce una URL de redirección de confirmación (a dónde va el donante después de confirmar).
Para usar esto, primero crea una plantilla de doble aceptación dentro de Brevo. Si Donación benéfica no encuentra ninguna plantilla en tu cuenta, el campo de plantilla se convierte en un cuadro de texto donde puedes introducir el ID numérico de la plantilla.
Opciones de configuración
Conexión
| Configuración | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| Clave API | texto | vacío | Tu clave API v3 de Brevo, desde Brevo > SMTP & API > Claves API. |
Campos de suscriptor
| Configuración | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| Mapeo de campos | seleccionar (por atributo) | Email, FIRSTNAME, LASTNAME pre-mapeados | Mapea cada atributo de contacto de Brevo a un campo de donación benéfica. |
Doble aceptación
| Configuración | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| Doble aceptación | casilla de verificación | desactivado | Envía un correo electrónico de confirmación de Brevo antes de suscribir al donante. |
| Plantilla de doble confirmación | seleccionar o texto | vacío | La plantilla de Brevo utilizada para el correo electrónico de confirmación. Recurre a un campo de ID de plantilla numérico si no se encuentran plantillas. |
| URL de redirección de confirmación | texto | vacío | A dónde se envía al donante después de confirmar su suscripción. |
Comportamiento de boletines (pantalla de Boletines)
| Configuración | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| Lista predeterminada | seleccionar | Elegir una lista | La lista de Brevo a la que los donantes se unen por defecto en todas las campañas. |
| Modo de Opt-in Predeterminado | seleccionar | Casilla de verificación de suscripción, no marcada | Cómo aparece la suscripción en los formularios de donación. |
| Etiqueta de suscripción predeterminada | texto | Suscríbete a nuestro boletín | La etiqueta que se muestra junto a la casilla de verificación de suscripción. |
RGPD y Privacidad
La integración de Brevo con las herramientas de datos personales de WordPress se encuentra en Herramientas > Exportar datos personales y Herramientas > Borrar datos personales:
- Exportar devuelve los atributos de contacto de Brevo del donante.
- Borrar elimina permanentemente el contacto del donante de Brevo (un borrado duro, no solo una desuscripción).
Monitorización y Solución de problemas
Cada intento de suscripción se registra en el registro de actividad de Charitable en Charitable > Herramientas > Registros. Filtra por la fuente Brevo para ver éxitos y errores, incluyendo el mensaje exacto que devolvió Brevo.
La clave API no es aceptada (error 401)
Confirma que has utilizado la clave API v3 (empieza por xkeysib-), no la clave SMTP. Si tu cuenta de Brevo restringe el acceso a la API por IP, añade la IP del servidor de tu sitio a la lista blanca de IPs autorizadas en Brevo. La entrada del registro mostrará el mensaje exacto de Brevo, incluyendo una nota de "dirección IP no reconocida" cuando la IP sea la causa.
Un donante no fue suscrito
Comprueba Charitable > Herramientas > Registros filtrados por Brevo. Una causa común es un número de teléfono que no está en formato internacional y se envía al atributo de SMS, WhatsApp o línea fija, lo que hace que Brevo rechace todo el contacto. Desvincula esos atributos o asegúrate de que tu formulario recopila números de teléfono en formato +país.
Los correos electrónicos de doble confirmación no llegan
Confirma que la doble confirmación está habilitada, que se ha configurado una plantilla de Brevo válida y una URL de redirección de confirmación, y que la plantilla existe y está activa en tu cuenta de Brevo. Recuerda que un donante que nunca hace clic en el enlace de confirmación nunca se añade a la lista, lo cual es el comportamiento previsto.
Las listas están desactualizadas
Charitable almacena en caché tus listas de Brevo. Utiliza el botón Sincronizar listas junto a Brevo en la pantalla de Boletines para actualizarlas.
Recursos para desarrolladores
Filtros
charitable_newsletter_connect_brevo_subscriber_data— Filtra los datos que se envían a Brevo al suscribir a un donante. Recibe el array de carga útil, los datos del usuario y el ID de la lista.charitable_newsletter_connect_brevo_export_custom_field— Filtra si un atributo de Brevo dado se incluye en una exportación de datos personales de RGPD.charitable_settings_fields_providers_provider_brevo— Filtra los campos de configuración de Brevo.charitable_newsletter_connect_providers— Registra o modifica los proveedores de boletines disponibles.charitable_newsletter_connect_log_success— Devuelve false para suprimir las entradas de registro de éxito por donación, pero sigue registrando errores.
Constantes
CHARITABLE_DEBUG_NEWSLETTER— Defínelo como true para escribir detalles detallados de la solicitud y la respuesta en el registro de Charitable. La clave de la API nunca se registra. Úsalo solo para depuración controlada, ya que las entradas de depuración pueden incluir datos de respuesta de Brevo.
