MailChimpMemberComponent

Bienvenido al componente MailChimpMemberComponent. Esta herramienta te permite conectar tu sistema de automatización con Mailchimp, una de las plataformas líderes en marketing por correo electrónico.

Su propósito principal es facilitar la gestión de tus listas de audiencias: puedes añadir nuevos suscriptores, actualizar la información de contactos existentes, o cambiar el estado de suscripción (como pasar de “pendiente” a “activo”) de manera sencilla, sin necesidad de escribir código complejo.

¿Cómo funciona?

Este componente actúa como un puente entre tu flujo de trabajo en Nappai y la API de Mailchimp. Cuando ejecutas el componente, este se comunica automáticamente con los servidores de Mailchimp utilizando una conexión segura.

El proceso básico es el siguiente:

1. Identificación: El componente busca en tu lista de Mailchimp un contacto específico usando su dirección de correo electrónico.
2. Acción: Dependiendo de la operación que elijas, el componente realizará una de las siguientes acciones:
   • Añadir/Actualizar: Si el contacto no existe, lo crea. Si ya existe, actualiza sus datos (como su nombre o estado).
   • Consultar: Recupera la información detallada de uno o varios miembros.
3. Resultado: Una vez completada la tarea, el componente te devuelve un resultado que puedes usar para confirmar que la acción se realizó correctamente o para enviar la información a otros pasos de tu automatización.

Es importante destacar que este componente es flexible: puede funcionar tanto para crear nuevos registros como para revisar información existente, adaptándose a lo que necesites en cada momento de tu flujo.

Conexión y Credenciales

Para que este componente funcione, es necesario que primero configures tu conexión con Mailchimp en Nappai. Esto asegura que tu automatización tenga permiso para leer y escribir en tus listas de correos de forma segura.

Sigue estos pasos:

1. Dirígete a la sección de Credenciales en el panel de configuración de Nappai.
2. Crea una nueva credencial seleccionando el tipo Mailchimp API.
3. Ingresa tu API Key. Nota: Puedes encontrar esta clave en tu cuenta de Mailchimp, en la sección de “Account” > “API keys”.
4. Guarda la credencial.
5. Vuelve a tu flujo de trabajo y, en el componente MailChimpMemberComponent, selecciona la credencial que acabas de crear en el campo Credential.

Entradas

A continuación, se detallan los campos disponibles para configurar el componente. Los nombres de los campos se muestran en su versión original (inglés) tal como aparecen en la interfaz, para facilitar su identificación exacta.

Campos de Entrada

• Operation: La operación que deseas realizar (por ejemplo, obtener un miembro o añadir/actualizar uno).

  • Visible en: Todas las operaciones

• List ID: El identificador único de la lista de audiencias de Mailchimp con la que deseas trabajar. Debes usar la lista donde se encuentran los contactos que deseas gestionar.

  • Visible en: Todas las operaciones

• Email: La dirección de correo electrónico del miembro. Se utiliza para identificar al usuario. Si esta campo está vacío en una operación de “get” (obtener), el sistema puede devolver todos los miembros de la lista.

  • Visible en: Todas las operaciones

• Tag Action: La acción que se realizará con las etiquetas (tags) del miembro (por ejemplo, añadir, reemplazar o eliminar etiquetas).

  • Visible en: Todas las operaciones

• Status: El estado actual del miembro. Los valores comunes incluyen ‘subscribed’ (suscrito), ‘unsubscribed’ (no suscrito), o ‘pending’ (pendiente de confirmación).

  • Visible en: Todas las operaciones

• Max Results: El número máximo de resultados que deseas obtener si estás consultando una lista de miembros.

  • Visible en: Todas las operaciones

• Include Fields: Indica si deseas incluir los campos estándar de la lista en los resultados.

  • Visible en: Todas las operaciones

• Fields: Los campos específicos que deseas recuperar para los miembros.

  • Visible en: Todas las operaciones

• First Name: El nombre del miembro. Útil para personalizar correos o actualizar perfiles.

  • Visible en: Todas las operaciones

• Last Name: El apellido del miembro.

  • Visible en: Todas las operaciones

• Address: La dirección física del miembro.

  • Visible en: Todas las operaciones

• City: La ciudad de residencia del miembro.

  • Visible en: Todas las operaciones

• State: El estado o provincia de residencia del miembro.

  • Visible en: Todas las operaciones

• Zip: El código postal del miembro.

  • Visible en: Todas las operaciones

• Country: El país de residencia del miembro.

  • Visible en: Todas las operaciones

• Phone: El número de teléfono del miembro.

  • Visible en: Todas las operaciones

• Birthday: El cumpleaños del miembro (formato MM/DD).

  • Visible en: Todas las operaciones

• Company: El nombre de la empresa para la que trabaja el miembro.

  • Visible en: Todas las operaciones

• Include Location: Indica si se debe incluir la información geolocalización (latitud/longitud) en los datos del miembro.

  • Visible en: Todas las operaciones

• Latitude: La coordenada geográfica norte-sur del miembro.

  • Visible en: Todas las operaciones

• Longitude: La coordenada geográfica este-oeste del miembro.

  • Visible en: Todas las operaciones

• Include Additional Fields: Indica si se deben incluir campos adicionales o personalizados definidos en tu cuenta de Mailchimp.

  • Visible en: Todas las operaciones

• Additional Fields: Campos extra que hayas configurado en Mailchimp para capturar datos específicos de tus contactos.

  • Visible en: Todas las operaciones

• Language: El idioma preferido del miembro.

  • Visible en: Todas las operaciones

• Tags: Las etiquetas que deseas asignar al miembro para categorizarlo.

  • Visible en: Todas las operaciones

• Email Type: El tipo de formato de correo electrónico preferido por el miembro (por ejemplo, ‘html’ o ‘text’).

  • Visible en: Todas las operaciones

• VIP Status: Indica si el miembro es un cliente VIP o de alta prioridad.

  • Visible en: Todas las operaciones

• Include Groups: Indica si se deben incluir los grupos de suscripción del miembro.

  • Visible en: Todas las operaciones

• Group ID: El identificador del grupo al que pertenece el miembro.

  • Visible en: Todas las operaciones

• Group Options: El nombre específico de la opción dentro de un grupo de suscripción (por ejemplo, seleccionar “Semanales” en lugar de “Diarios”).

  • Visible en: Todas las operaciones

Salidas

Una vez que el componente ha realizado la operación, produce los siguientes resultados que puedes usar en pasos posteriores de tu flujo:

• Data: Este campo contiene toda la información devuelta por Mailchimp. Dependiendo de la operación, esto puede ser un objeto JSON con los detalles del miembro (nombre, estado, ID único, etc.) o una lista de miembros si realizaste una consulta. Este dato es crucial si necesitas usar la información del contacto en otro paso de tu automatización.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de cómo se ve la salida Data cuando se obtiene información de un miembro exitosamente: json { “id”: “d6f89f9029”, “email_address”: “ejemplo@correo.com”, “unique_email_id”: “a1b2c3d4e5”, “list_id”: “t1u2v3w4x5”, “status”: “subscribed”, “merge_fields”: { “FNAME”: “Juan”, “LNAME”: “Pérez” }, “stats”: { “total_interactions”: 0 }, “email_client”: null, “location”: { “latitude”: null, “longitude”: null, “gmtoff”: null, “dstoff”: null, “country_code”: “ES” }, “ip_opt”: “192.168.1.1”, “language”: null, “vip”: false, “email_type_option”: false, “subscribe_date”: “2023-10-25T12:00:00+00:00”, “last_changed”: “2023-10-25T12:00:00+00:00”, “vip_status”: false, “consent_to_track”: true, “consents”: { “double_optin”: true, “enabled”: true }, “client”: “Mailchimp Web”, “last_note”: { “note”: "", “date”: "", “user_id”: null, “user_name”: "" }, “alerts”: [], “segments”: [], “tags_count”: 0, “tags”: [], “list_language”: “en”, “email_type”: “html”, “is_monitormode”: false, “is_gdpr”: false, “consent”: “not_valid”, “consent_expired”: false, “gdpr”: false, “merge_var_names”: [], “notes_count”: 0, “note”: "", “awards”: { “rank”: 0, “score”: 0, “total_last_90_days”: 0, “total_last_6_months”: 0, “total_last_12_months”: 0 }, “id_type”: “test_id”, “ab_testing_remaining”: 0, “ab_test_winner”: null, “campaigns_received”: [], “campaigns_not_received”: [], “contact_crime_threat_level”: 0, “contact_quality_score”: 0, “email_client”: null, “ip_signup”: null, “time_signup”: null, “static_segments”: [], “recipient_language”: null, “is_site_member”: false, “site_member_id”: null, “site_member_since”: null, “privacy_preferences”: { “email_format”: “html”, “marketing_interactions”: [] }, “marketing_interactions”: [], “marketing_permissions”: [], “subscriber_credit_limit”: null, “subscriber_credit_used”: null, “subscriber_quality”: null, “tags”: [], “interests”: {}, “groups”: {}, “member_rating”: 0, “member_since”: “2023-10-25T12:00:00+00:00”, “language”: null, “vip”: false, “email_type”: “html”, “email_client”: null, “location”: { “type”: “Point”, “coordinates”: [0.0, 0.0] }, “ip_opt”: null, “time_opt”: null, “ab_test_winner”: null, “ab_testing_remaining”: 0, “awards”: {}, “consents”: {}, “consent_expired”: false, “consent”: “not_valid”, “gdpr”: false, “is_gdpr”: false, “is_monitormode”: false, “list_language”: “en”, “list_id”: “t1u2v3w4x5”, “member_since”: “2023-10-25T12:00:00+00:00”, “merge_var_names”: [], “merge_fields”: { “FNAME”: “Juan”, “LNAME”: “Pérez” }, “notes_count”: 0, “notes”: [], “risk_level”: 0, “score”: 0, “stats”: { “avg_open_rate”: 0.0, “avg_click_rate”: 0.0, “avg_subscribe_time”: 0.0, “avg_unsubscribe_time”: 0.0, “avg_unsubscribe_rate”: 0.0, “bounce_rate”: 0.0, “click_rate”: 0.0, “complaint_rate”: 0.0, “opened_rate”: 0.0, “subscribed_rate”: 0.0, “total_clicks”: 0, “total_opens”: 0, “total_subs”: 0, “total_unsubs”: 0 }, “web_id”: 0, “clicked_campaign_ids”: [], “clicked_time_ids”: [], “opened_campaign_ids”: [], “opened_time_ids”: [], “unsubscribed_campaign_ids”: [], “unsubscribed_time_ids”: [], “email_client_name”: null, “last_changed_by”: null, “last_changed_date”: null, “last_note_text”: "", “last_note_date”: null, “last_note_user_id”: null, “last_note_user_name”: null, “list_activity”: [], “member_added_campaign_ids”: [], “member_added_time_ids”: [], “member_changed_campaign_ids”: [], “member_changed_time_ids”: [], “member_removed_campaign_ids”: [], “member_removed_time_ids”: [], “segments”: [], “tags”: [], “interests”: {}, “groups”: {}, “member_rating”: 0, “member_since”: “2023-10-25T12:00:00+00:00”, “language”: null, “vip”: false, “email_type”: “html”, “email_client”: null, “location”: { “type”: “Point”, “coordinates”: [0.0, 0.0] }, “ip_opt”: null, “time_opt”: null, “ab_test_winner”: null, “ab_testing_remaining”: 0, “awards”: {}, “consents”: {}, “consent_expired”: false, “consent”: “not_valid”, “gdpr”: false, “is_gdpr”: false, “is_monitormode”: false, “list_language”: “en”, “list_id”: “t1u2v3w4x5”, “member_since”: “2023-10-25T12:00:00+00:00”, “merge_var_names”: [], “merge_fields”: { “FNAME”: “Juan”, “LNAME”: “Pérez” }, “notes_count”: 0, “notes”: [], “risk_level”: 0, “score”: 0, “stats”: { “avg_open_rate”: 0.0, “avg_click_rate”: 0.0, “avg_subscribe_time”: 0.0, “avg_unsubscribe_time”: 0.0, “avg_unsubscribe_rate”: 0.0, “bounce_rate”: 0.0, “click_rate”: 0.0, “complaint_rate”: 0.0, “opened_rate”: 0.0, “subscribed_rate”: 0.0, “total_clicks”: 0, “total_opens”: 0, “total_subs”: 0, “total_unsubs”: 0 }, “web_id”: 0, “clicked_campaign_ids”: [], “clicked_time_ids”: [], “opened_campaign_ids”: [], “opened_time_ids”: [], “unsubscribed_campaign_ids”: [], “unsubscribed_time_ids”: [], “email_client_name”: null, “last_changed_by”: null, “last_changed_date”: null, “last_note_text”: "", “last_note_date”: null, “last_note_user_id”: null, “last_note_user_name”: null, “list_activity”: [], “member_added_campaign_ids”: [], “member_added_time_ids”: [], “member_changed_campaign_ids”: [], “member_changed_time_ids”: [], “member_removed_campaign_ids”: [], “member_removed_time_ids”: [], “segments”: [], “tags”: [], “interests”: {}, “groups”: {}, “member_rating”: 0, “member_since”: “2023-10-25T12:00:00+00:00”, “language”: null, “vip”: false, “email_type”: “html”, “email_client”: null, “location”: { “type”: “Point”, “coordinates”: [0.0, 0.0] }, “ip_opt”: null, “time_opt”: null, “ab_test_winner”: null, “ab_testing_remaining”: 0, “awards”: {}, “consents”: {}, “consent_expired”: false, “consent”: “not_valid”, “gdpr”: false, “is_gdpr”: false, “is_monitormode”: false, “list_language”: “en”, “list_id”: “t1u2v3w4x5”, “member_since”: “2023-10-25T12:00:00+00:00”, “merge_var_names”: [], “merge_fields”: { “FNAME”: “Juan”, “LNAME”: “Pérez” }, “notes_count”: 0, “notes”: [], “risk_level”: 0, “score”: 0, “stats”: { “avg_open_rate”: 0.0, “avg_click_rate”: 0.0, “avg_subscribe_time”: 0.0, “avg_unsubscribe_time”: 0.0, “avg_unsubscribe_rate”: 0.0, “bounce_rate”: 0.0, “click_rate”: 0.0, “complaint_rate”: 0.0, “opened_rate”: 0.0, “subscribed_rate”: 0.0, “total_clicks”: 0, “total_opens”: 0, “total_subs”: 0, “total_unsubs”: 0 }, “web_id”: 0, “clicked_campaign_ids”: [], “clicked_time_ids”: [], “opened_campaign_ids”: [], “opened_time_ids”: [], “unsubscribed_campaign_ids”: [], “unsubscribed_time_ids”: [], “email_client_name”: null, “last_changed_by”: null, “last_changed_date”: null, “last_note_text”: "", “last_note_date”: null, “last_note_user_id”: null, “last_note_user_name”: null, “list_activity”: [], “member_added_campaign_ids”: [], “member_added_time_ids”: [], “member_changed_campaign_ids”: [], “member_changed_time_ids”: [], “member_removed_campaign_ids”: [], “member_removed_time_ids”: [] }

Conectividad

Este componente suele conectarse a otros nodos que requieren información específica de un contacto para personalizar comunicaciones o registrar datos.

• Hacia componentes de Email Marketing: Es común que la salida Data se conecte a componentes que envían correos personalizados, utilizando los campos devueltos (como First Name o Status) para segmentar y personalizar el mensaje.
• Hacia bases de datos o CRMs: Si estás integrando Nappai con un CRM interno, puedes usar los datos obtenidos para verificar si el cliente ya existe antes de crear uno nuevo, evitando duplicados.
• Hacia componentes de Condición: Puedes usar la información de salida (como el Status) en un componente de “Condición” para tomar decisiones lógicas (por ejemplo: “Si el estado es ‘subscribed’, enviar un correo de bienvenida; de lo contrario, agregarlo a una lista de espera”).

Ejemplo de Uso

Escenario: Actualización de datos de un nuevo cliente

Imagina que has recopilado datos de un formulario web y quieres asegurarte de que este cliente esté correctamente registrado en tu lista de Mailchimp.

1. Configura la Operation en “Add or Update”.
2. En List ID, selecciona tu lista de “Clientes Activos”.
3. En Email, conecta el valor que viene del formulario web (ej. user_email).
4. En First Name y Last Name, mapea los valores del formulario.
5. En Status, selecciona subscribed si el usuario ya dio su consentimiento.
6. Activa Send Welcome Email (si estuviera disponible en la operación elegida) para automatizar la bienvenida.

Al ejecutar este flujo, si el usuario juan@ejemplo.com ya existe, sus datos se actualizarán. Si no existe, se creará un nuevo contacto con esa información.

Consejos y Mejores Prácticas

• Valida tus List IDs: Asegúrate de que el List ID que proporcionas corresponde exactamente a la lista de audiencias donde deseas realizar la acción. Usar un ID incorrecto resultará en un error.
• Maneja Estados de Suscripción: Sé cuidadoso al modificar el Status. Cambiar un estado a unsubscribed es irreversible para el usuario a menos que se resuscriba manualmente. Úsalo con precaución.
• Uso de Tags: Utiliza el campo Tags para categorizar a tus usuarios. Esto facilita después la segmentación dentro de Mailchimp para campañas de marketing más efectivas.
• Personalización: Aprovecha los campos de Merge Fields (como Nombre y Apellido) para hacer tus correos más personales. El uso de datos personalizados aumenta significativamente la tasa de apertura.

Consideraciones de Seguridad

• Protección de la API Key: Nunca compartas tu API Key de Mailchimp públicamente. En Nappai, la credencial se almacena de forma segura y solo se utiliza internamente por el componente.
• Consentimiento RGPD: Asegúrate de que estás obteniendo el consentimiento adecuado de tus usuarios antes de suscribirlos. Mailchimp tiene herramientas para gestionar esto, y el componente respeta los estados de suscripción (como pending) que requieren acción del usuario.
• Privacidad de Datos: Ten cuidado al mapear datos sensibles (como direcciones completas o fechas de nacimiento). Asegúrate de que solo se compartan con listas y contactos autorizados.