Requiere: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Cada acción significativa en tu programa de Embajadores debe desencadenar una respuesta. Cuando se aprueba una recaudación de fondos, el embajador debe saberlo de inmediato. Cuando se rechaza la solicitud de alguien, merece una explicación clara. Cuando un recluta se registra a través de un enlace de invitación, la persona que lo reclutó debe enterarse.

Embajadores envía 5 correos electrónicos transaccionales que gestionan todo esto automáticamente. Se envían en respuesta a un evento específico, no desde una campaña de marketing que compones manualmente. Esta página documenta cada uno: cuándo se envía, a quién va, cómo es el cuerpo predeterminado, qué etiquetas inteligentes acepta y cómo personalizarlo o deshabilitarlo.

Los cinco correos electrónicos están habilitados por defecto.

¿Dónde encontrar estos correos de Embajadores?

Para editar el cuerpo o el asunto de cualquiera de ellos, ve a Caridad » Configuración » Correos electrónicos.

Desplázate para encontrar los correos electrónicos que necesitas. Puedes habilitar/deshabilitar estos correos aquí.

¿Cómo editar los correos de Embajadores?

Una vez habilitado, haz clic en el botón Configuración de correo electrónico para acceder al correo electrónico interior.

Se configura un correo electrónico predeterminado para ti.

Puedes cambiar la línea de asunto, el titular y el cuerpo para que se ajusten a tus requisitos.

También hay códigos cortos que puedes usar para obtener automáticamente información como la URL de tu sitio web, el nombre del equipo, el nombre del creador, etc.

Si algún correo electrónico se deshabilita accidentalmente, lo verás aparecer en tu banner Estado del correo electrónico.

Referencia Rápida

Correo electrónico	ID	Se dispara cuando	Destinatario
Campaña Aprobada	creator_campaign_approved	Una recaudación de fondos es aprobada por un moderador o aprobada automáticamente al enviarla.	El embajador.
Campaña Rechazada	creator_campaign_rejected	Una recaudación de fondos es rechazada por un moderador.	El embajador.
Campaña Requiere Revisión	creator_campaign_needs_revision	Un moderador solicita cambios.	El embajador.
Recluta Invitado Aprobado	inviter_recruit_approved	La primera recaudación de fondos de un embajador reclutado es aprobada.	El invitador (reclutador).
Nueva Campaña Requiere Acción	new_campaign_requires_action	Una nueva presentación de recaudación de fondos llega a Moderación Pendiente.	Administradores del sitio (cualquier usuario con manage_charitable_settings).

El lado técnico

Campaña Aprobada

ID: creator_campaign_approved
Para: El embajador (post_author de la recaudación de fondos)
Se dispara: Siempre que una recaudación de fondos pase a publicada desde cualquier otro estado. La acción Aprobar moderación la dispara, la aprobación automática al enviar la dispara y la publicación manual a través del editor de WP la dispara.

Asunto predeterminado

Your campaign is live

Cuerpo predeterminado

Dear [charitable_email show=campaign_creator],

Your campaign, "[charitable_email show=campaign_title]", has been approved and is now live!

You can view your campaign online at [charitable_email show=campaign_url].

If you would like to edit it, go to [charitable_email show=campaign_edit_url].

Etiquetas inteligentes disponibles

Etiqueta	Sustituciones
[charitable_email show=campaign_creator]	El nombre para mostrar del embajador.
[charitable_email show=campaign_title]	El título de la recaudación de fondos.
[charitable_email show=campaign_url]	La URL pública de la recaudación de fondos.
[charitable_email show=campaign_edit_url]	La URL del editor de la recaudación de fondos.
[charitable_email show=campaign_goal]	El importe del objetivo.
[charitable_email show=campaign_end_date]	La fecha de finalización de la recaudación de fondos.

Filtros de personalización

add_filter( 'charitable_email_creator_campaign_approved_default_subject', function ( $subject, $email ) {
    return "🎉 Your fundraiser is live: " . $email->get_field_value( 'campaign_title' );
}, 10, 2 );

add_filter( 'charitable_email_creator_campaign_approved_default_body', function ( $body, $email ) {
    return "
Welcome aboard!
" . $body . "
Reply to this email if you have any questions.
";
}, 10, 2 );

Suprimir por llamada

Al aprobar con la casilla Notificar desmarcada, el correo electrónico se suprime mediante:

add_filter( 'charitable_ambassadors_skip_creator_campaign_approved', '__return_true' );
// ...the approval runs...
remove_filter( 'charitable_ambassadors_skip_creator_campaign_approved', '__return_true' );

No utilice este filtro para la supresión en todo el sitio. Para eso, utilice la casilla Notificar predeterminada a través de moderation_default_notify_on_approve.

Campaña Rechazada

ID: creator_campaign_rejected
Para: El embajador
Se dispara: Cuando un moderador rechaza una recaudación de fondos a través de la cola de moderación.

Asunto predeterminado

Your campaign was not approved

Cuerpo predeterminado

Dear [charitable_email show=campaign_creator],

We've reviewed your campaign, "[charitable_email show=campaign_title]", and unfortunately it does not meet our guidelines.

Reason: [charitable_email show=rejection_reason]

If you'd like to discuss this further or submit a revised campaign, please reach out at [admin_email].

Etiquetas inteligentes disponibles

El mismo conjunto que Campaña aprobada, más:

Etiqueta	Sustituciones
[charitable_email show=rejection_reason]	El texto de la razón del modal Rechazar.

Filtros de personalización

add_filter( 'charitable_email_creator_campaign_rejected_default_subject', function ( $subject ) {
    return 'About your recent fundraiser submission';
} );

add_filter( 'charitable_email_creator_campaign_rejected_default_body', function ( $body ) {
    return $body . '
You can read our submission guidelines at our guidelines page.
';
} );

Campaña Requiere Revisión

ID: creator_campaign_needs_revision
Para: El embajador
Se dispara: Cuando un moderador utiliza la acción Solicitar cambios.

Asunto predeterminado

Updates needed to your campaign

Cuerpo predeterminado

Dear [charitable_email show=campaign_creator],

We've reviewed your campaign, "[charitable_email show=campaign_title]", and we'd like a few small updates before publishing.

Notes from our team: [charitable_email show=revision_notes]

You can edit your campaign at [charitable_email show=campaign_edit_url] and resubmit when you're ready.

Etiquetas inteligentes disponibles

El mismo conjunto que Campaña aprobada, más:

Etiqueta	Sustituciones
[charitable_email show=revision_notes]	Las notas del modal Solicitar cambios.
[charitable_email show=campaign_edit_url]	La URL del editor de la recaudación de fondos con un token de inicio de sesión automático de enlace mágico.

Filtros de personalización

add_filter( 'charitable_email_creator_campaign_needs_revision_default_body', function ( $body ) {
    return $body . '
Tip: reply to this email if you have questions about the requested changes.
';
} );

Recluta Invitado Aprobado

ID: inviter_recruit_approved
Para: El invitador (reclutador)
Se dispara: Cuando se aprueba la primera recaudación de fondos de un embajador reclutado, después de que la atribución haya vinculado al reclutado con el invitador. Solo se envía si la opción "Enviar correo electrónico al invitador al aprobar" está habilitada en la configuración de Invitaciones, y solo después de que la atribución haya vinculado al reclutado con el invitador.

Asunto predeterminado

[charitable_email show=recruit_name] just joined as a fundraiser thanks to you!

Cuerpo predeterminado

Hi [charitable_email show=inviter_first_name],

Great news! [charitable_email show=recruit_name] just had their fundraiser approved - and they signed up through your invite link.

Their fundraiser: [charitable_email show=recruit_campaign_url]

Thanks for spreading the word.

Etiquetas inteligentes disponibles

Etiqueta	Sustituciones
[charitable_email show=inviter_name]	El nombre para mostrar del invitador.
[charitable_email show=inviter_first_name]	El nombre de pila del invitador.
[charitable_email show=recruit_name]	El nombre para mostrar del reclutado.
[charitable_email show=recruit_campaign_title]	El título de la primera recaudación de fondos del reclutado.
[charitable_email show=recruit_campaign_url]	La URL de la primera recaudación de fondos del reclutado.
[charitable_email show=site_url]	La URL de tu sitio.

Filtros de personalización

add_filter( 'charitable_email_inviter_recruit_approved_default_subject', function ( $subject, $email ) {
    $recruit = $email->get_field_value( 'recruit_name' );
    return "🎉 Your friend {$recruit} is fundraising too!";
}, 10, 2 );

Desactivar en todo el sitio

Activa o desactiva la opción Enviar correo electrónico al invitador al aprobar en Charitable » Embajadores » Invitaciones.

Nueva Campaña Requiere Acción

ID: new_campaign_requires_action
Para: Administradores del sitio (cualquier usuario con manage_charitable_settings)
Se dispara: Cuando se envía una nueva recaudación de fondos y la aprobación automática está desactivada, lo que significa que va a Moderación Pendiente.

Asunto predeterminado

A new fundraiser needs your review

Cuerpo predeterminado

A new fundraiser was submitted and is awaiting review.

Title: [charitable_email show=campaign_title]
Ambassador: [charitable_email show=campaign_creator]
Submitted: [charitable_email show=submission_date]

Review it in the Moderation queue: [charitable_email show=moderation_url]

Etiquetas inteligentes disponibles

Etiqueta	Sustituciones
[charitable_email show=campaign_title]	El título de la recaudación de fondos.
[charitable_email show=campaign_creator]	El nombre para mostrar del embajador.
[charitable_email show=campaign_url]	La URL de la recaudación de fondos (vista previa si aún no es pública).
[charitable_email show=submission_date]	Marca de tiempo de envío.
[charitable_email show=moderation_url]	Enlace directo a la vista Pendiente en Moderación.

Filtros de personalización

add_filter( 'charitable_email_new_campaign_requires_action_default_subject', function () {
    return '🔔 [Charitable] Fundraiser awaiting review';
} );

Limitación

El correo electrónico del administrador se envía una vez por envío. Si tu equipo de moderación es pequeño y el volumen se vuelve ruidoso, considera usar Notificaciones (el panel con el icono de campana) en su lugar. Tiene límites de frecuencia y se puede descartar, lo que lo hace más adecuado para programas de alto volumen.

Lo que tienen en común los cinco correos electrónicos

Algunas convenciones se aplican a todos los correos electrónicos, lo que hace que personalizarlos sea coherente una vez que conoces el patrón.

IDs de correo electrónico

Las cadenas de ID (como creator_campaign_approved) son estables. Se utilizan como prefijo del filtro (charitable_email_<id>_default_subject, etc.) y como clave de opción para la configuración de activación/desactivación del correo electrónico de Charitable.

Filtros

Cada correo electrónico expone el mismo conjunto de filtros. Todos reciben el objeto $email como segundo argumento para que puedas llamar a get_field_value() para componer tu personalización:

charitable_email__default_subject
charitable_email__default_body
charitable_email__recipient_email
charitable_email__recipient_name
charitable_email__should_send

Filtro de Etiquetas Inteligentes

Añade nuevas etiquetas inteligentes conectando con el filtro de valor del campo de contenido, luego usa tu etiqueta en el cuerpo de cualquier correo electrónico:

add_filter( 'charitable_email_content_field_value_', function ( $value, $email ) {
    return 'Computed value';
}, 10, 2 );

// Then use [charitable_email show=your_tag] in any email body.

Dirección de Remitente

Los cinco correos electrónicos usan la dirección admin_email de WordPress por defecto. Anúlala globalmente a través de charitable_email_from_address o por correo electrónico a través de charitable_email_<id>_from_address.

HTML vs Texto Plano

Los cinco correos electrónicos son HTML por defecto. Los clientes de correo de los destinatarios recurrirán automáticamente a una representación en texto plano. Para forzar texto plano, devuelve un cuerpo despojado del filtro _default_body.

Consejos que vale la pena tener en cuenta

Algunas cosas que marcan una diferencia real en cómo estos correos electrónicos llegan a tus embajadores.

• Personaliza las líneas de asunto más que los cuerpos. Las líneas de asunto impulsan las tasas de apertura. Los cuerpos claros y directos casi siempre superan a los ingeniosos.
• Envía siempre una prueba antes de desplegar. Charitable Pro tiene un botón "Enviar prueba" en la página de configuración de cada correo electrónico. Úsalo cada vez que cambies un asunto o cuerpo, no solo en la configuración inicial.
• Usa etiquetas inteligentes libremente. Codificar el nombre del embajador significaría que cada recaudador de fondos recibe el mismo correo electrónico impersonal. Las etiquetas inteligentes hacen que cada mensaje parezca escrito específicamente para esa persona.
• Mantén corto el correo electrónico de "Nueva campaña requiere acción". Tu equipo de moderación lee esto muchas veces a la semana. Una línea con el título de la campaña y un enlace directo a la cola es más útil que un párrafo largo que omitirán.

Referencia del desarrollador

Jerarquía de Clases de Correo Electrónico

Charitable_Email                                                    # Pro base class
    └─ Charitable_Ambassadors_Email_Creator_Campaign_Submitted     # Base for creator-targeted emails
            ├─ Charitable_Ambassadors_Email_Creator_Campaign_Approved
            ├─ Charitable_Ambassadors_Email_Creator_Campaign_Rejected
            └─ Charitable_Ambassadors_Email_Creator_Campaign_Needs_Revision
    └─ Charitable_Ambassadors_Email_Inviter_Recruit_Approved        # For inviter-targeted
    └─ Charitable_Ambassadors_Email_New_Campaign_Requires_Action    # Admin-targeted

Cada clase hoja se encuentra en includes/emails/.

Ayudantes Estáticos

Para activación programática:

Charitable_Ambassadors_Email_Creator_Campaign_Approved::send_with_campaign_id( $campaign_id );
Charitable_Ambassadors_Email_Creator_Campaign_Rejected::send_with_campaign_id( $campaign_id, $reason );
Charitable_Ambassadors_Email_Creator_Campaign_Needs_Revision::send_with_campaign_id( $campaign_id, $notes );
Charitable_Ambassadors_Email_Inviter_Recruit_Approved::send_with_recruit_id( $recruit_user_id, $recruit_campaign_id, $inviter_user_id );
Charitable_Ambassadors_Email_New_Campaign_Requires_Action::send_with_campaign_id( $campaign_id );

Capacidades

El correo electrónico "Nueva campaña requiere acción" se envía a todos los usuarios con manage_charitable_settings. Para dirigirte a administradores específicos en su lugar, filtra la lista de destinatarios a través de charitable_email_new_campaign_requires_action_admin_recipients.

Conclusión

Eso cubre los cinco correos electrónicos transaccionales en Embajadores. Entre los correos de aprobación, rechazo y revisión que reciben tus embajadores, y la notificación al administrador que mantiene en movimiento tu cola de moderación, estos son los mensajes que mantienen tu programa funcionando sin problemas entre bastidores. Personaliza las líneas de asunto, añade la voz de tu marca a los cuerpos y usa etiquetas inteligentes para que cada correo electrónico se sienta personal.

Si encuentras algo que no se cubre aquí o necesitas ayuda con un correo electrónico específico, nuestro equipo de soporte estará encantado de ayudarte.

También te Puede Interesar Leer

Estos son los documentos más estrechamente conectados con los correos electrónicos transaccionales en Embajadores.

• Moderación – las acciones (aprobar, rechazar, solicitar cambios) que activan la mayoría de estos correos electrónicos.
• Estado del Correo Electrónico – el banner en la Descripción general que marca cualquiera de estos correos electrónicos cuando han sido deshabilitados accidentalmente.
• Notificaciones – el panel con icono de campana dentro de la administración que complementa estos correos electrónicos para tu equipo de moderación.
• Invitaciones – la función que activa el correo electrónico "Recluta Invitado Aprobado".
• Hooks y filtros en Embajadores – la referencia completa de filtros.