Saltearse al contenido
Nappai Documentation

Mailchimp Webhook

El componente Mailchimp Webhook funciona como un “portal de entrada” o un punto de escucha en tu sistema de automatización Nappai. Su principal función es mantenerse atento a los cambios que ocurren en tu cuenta de Mailchimp (como cuando un nuevo usuario se suscribe, un correo electrónico se envía o un usuario hace clic en un enlace).

En lugar de tener que verificar manualmente si hay nuevos datos, este componente recibe la información al instante y la transforma en un formato útil para que el resto de tu automatización pueda actuar sobre ella. Es ideal para conectar las campañas de marketing de Mailchimp con otras herramientas de gestión de datos o bases de datos dentro de Nappai.

¿Cómo funciona?

Imagina que este componente es un recepcionista inteligente que espera una llamada de Mailchimp. Cuando ocurre un evento (por ejemplo, alguien se inscribe en tu lista de correos), Mailchimp envía una notificación digital a tu sistema Nappai.

  1. Recepción: El componente detecta inmediatamente esta notificación entrante.
  2. Verificación de Seguridad: Antes de hacer nada, el sistema verifica que la notificación sea legítima y provenga realmente de Mailchimp, utilizando las claves de seguridad que has configurado.
  3. Procesamiento: Una vez confirmada la seguridad, el componente toma los datos crudos del evento (como el correo electrónico de la persona que se suscribió) y los organiza en un formato estructurado.
  4. Entrega: Finalmente, entrega esta información procesada a otros nodos de tu flujo de trabajo para que puedan realizar acciones automáticas, como guardar el dato en una base de datos o enviar una alerta al equipo de ventas.

Conexión y Credenciales

Para que este componente pueda “escuchar” los eventos de Mailchimp de forma segura y precisa, es necesario configurar correctamente la identidad de tu cuenta.

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo especificado para este componente y guarda los campos requeridos (claves de API, tokens, etc.).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada API Key de este nodo.

Entradas

Para que el componente funcione correctamente, debes proporcionarle la información de ubicación y seguridad de tu cuenta de Mailchimp.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente:

  • API Key: La contraseña de acceso secreta proporcionada por Mailchimp. Es necesaria para autenticar que tu sistema Nappai tiene permiso para recibir y procesar estos datos. Asegúrate de usar una clave con los permisos adecuados.
    • Visible en: Configuración general del componente
  • Data Center: El código específico de la región donde está alojada tu cuenta de Mailchimp (por ejemplo, “us1”, “us2”, “eu1”). Esto es crucial porque Mailchimp tiene servidores en diferentes partes del mundo; este campo asegura que la comunicación se realice con el servidor correcto.
    • Visible en: Configuración general del componente
  • Webhook Key: Un identificador único que representa a una lista de suscriptores específica. Indica al componente qué lista de contactos de Mailchimp debe monitorear para recibir las notificaciones.
    • Visible en: Configuración general del componente

Salidas

Cuando el componente recibe y procesa una notificación de Mailchimp, genera la siguiente información para ser utilizada por los siguientes pasos de tu automatización:

  • Message: Esta es la salida principal. Contiene toda la información del evento procesado en un formato estructurado (como un objeto o diccionario). Aquí encontrarás detalles como qué tipo de evento ocurrió, quién está involucrado, cuándo sucedió y otros metadatos relevantes. Esta salida se conecta a otros nodos para que estos puedan “leer” el evento y actuar en consecuencia.

Ejemplo de Respuesta JSON

Cuando se recibe una notificación exitosa (por ejemplo, una nueva suscripción), el campo Message tendrá una estructura similar a la siguiente: json { “event_type”: “subscribe”, “email”: “cliente.ejemplo@correo.com”, “timestamp”: “2023-10-27T10:15:00Z”, “list_id”: “1234567890”, “campaign_id”: null } Nota: Este es un ejemplo simplificado. La estructura exacta dependerá del tipo de evento que Mailchimp envíe (suscripción, desuscripción, clic, etc.).

Conectividad

Este componente actúa como un disparador inicial en tus flujos de automatización. Lógicamente, su salida (Message) debe conectarse a nodos que puedan “leer” datos, como:

  1. Nodos de Base de Datos / Gestión de Datos: Para guardar la información del evento (ej. guardar el nuevo correo electrónico en un CRM).
  2. Nodos de Lógica o IA: Para tomar decisiones basadas en el evento (ej. “Si alguien se suscribe, enviar una bienvenida”).
  3. Nodos de Notificación: Para alertar a un equipo humano sobre el cambio.

No se conecta normalmente con componentes que requieren datos de salida previos, ya que él es quien inicia el flujo de datos entrantes.

Ejemplo de Uso

Escenario: Guardar nuevos suscriptores en una lista interna

  1. Conecta un componente Mailchimp Webhook a tu flujo.
  2. Configura tu API Key y selecciona la Data Center correcta de tu cuenta.
  3. Conecta la salida Message del componente Mailchimp a un nodo de “Guardar en Base de Datos” o “Crear Registro”.
  4. Configura el nodo de base de datos para que extraiga el campo email del Message recibido y lo guarde como un nuevo contacto.

Ahora, cada vez que alguien se suscriba a tu boletín de Mailchimp, el sistema Nappai recibirá la notificación y automáticamente agregará ese contacto a tu base de datos interna sin intervención manual.

Consejos y Mejores Prácticas

  • Verifica tus Credenciales: Asegúrate de que la API Key tenga permisos de lectura/escritura si esperas procesar eventos complejos.
  • Identifica tu Data Center: El código de Data Center es crítico. Si usas el incorrecto, el componente no podrá validar las conexiones y rechazará los eventos entrantes. Puedes encontrar este código en la URL de tu panel de control de Mailchimp (suele ser una combinación de letras y números al final).
  • Monitoreo Continuo: Recuerda que este componente está diseñado para “escuchar” constantemente. Asegúrate de que tu flujo de trabajo esté activo y conectado para que no se pierdan eventos en tiempo real.

Consideraciones de Seguridad

El componente Mailchimp Webhook está diseñado para operar en un modo seguro de “escucha” continua.

  • Autenticación Obligatoria: El sistema valida automáticamente la procedencia de los datos. Nunca procesarás información a menos que la firma de seguridad de Mailchimp coincida con tus credenciales.
  • Manejo de Errores: Si la configuración es incorrecta o la validación falla, el componente generará un error estructurado en lugar de ejecutar acciones, protegiendo tu flujo de datos no válidos.
  • Privacidad de Datos: Asegúrate de tratar los datos recibidos (como correos electrónicos) conforme a las políticas de privacidad de tu organización y las regulaciones locales (como GDPR), ya que este componente actúa como un punto de entrada a datos personales.