# Enviar leads a Mailchimp

> Añade los leads nuevos a una audiencia, con sus respuestas como merge fields.

Source: https://welcomeai.dev/es/docs/mailchimp
Category: Destinos
Updated: 2026-09-11

---
## Que necesitas

Una **API key**: Mailchimp → tu avatar → Account & billing → Extras → API keys. La clave termina con
su datacenter, por ejemplo `-us21`, que es como sabemos con que servidor hablar.

## Conectar y enrutar

1. En **Destinos**, conecta Mailchimp con la clave.
2. Crea una ruta y elige la audiencia.
3. Mapea los campos. El email es obligatorio. Los merge fields de tu audiencia (`FNAME`, `LNAME` y
   los que hayas añadido) aparecen en la lista, y **Nuevo campo** crea uno si falta.

Puedes mapear un valor fijo al campo de etiquetas para marcar todo lo que venga del asistente.

## Una ruta por widget, y por tanto una por formulario

El alcance de una ruta es un widget. Déjalo en todos los widgets y la ruta toma todos los leads;
átalo a uno y toma solo los de ese widget.

Así es también como dos formularios llegan a dos sitios, porque un widget usa un formulario: su
captura de leads nombra el formulario que pregunta, así que elegir el widget elige el formulario. Un
formulario de contacto en un widget y una solicitud de demo en otro son dos rutas, cada una a su
destino. Dos formularios en el mismo widget no es algo que se pueda montar: si cambias el formulario
del widget, has cambiado qué formulario pregunta.

Elegir un widget hace algo más: la columna izquierda del mapeo muestra las preguntas de **ese**
formulario, en vez de todas las preguntas de todos los formularios del espacio de trabajo. Así una
ruta hecha para la demo no se mapea contra los campos del formulario de contacto, y las preguntas en
pantalla son las que de verdad se le van a hacer a un visitante. Si dejas la ruta en todos los
widgets las tienes todas, que es lo correcto: la ruta toma leads de todos.

Una consecuencia que conviene saber: un lead que el asistente capta en la conversación lleva el
widget del que vino, así que una ruta atada a un widget lo toma como cualquier otro. Un lead
empujado por la API sin widget lo toma solo una ruta sin widget.

## Estado de suscripción

Un contacto nuevo se añade como suscrito. A quien se dio de baja antes **no** se le vuelve a
suscribir: Mailchimp conserva su estado y nosotros nunca lo sobrescribimos. Es deliberado, y es lo
que te mantiene en regla.

## Compruébalo antes que un visitante

- **Comprobar conexión** vuelve a preguntarle a Mailchimp si la clave sigue funcionando y guarda la
  respuesta con la fecha de hoy.
- **Enviar lead de ejemplo** añade un contacto inventado a la audiencia a la que apunta esta ruta,
  para que veas exactamente qué llega. Usa el mismo mapeo que un lead real, y el registro de envíos lo
  marca como ejemplo: no se guarda como lead ni cuenta contra tu plan. Borra después el contacto de
  ejemplo de la audiencia si mantienes la lista limpia.

## Cuando falla

El registro de envíos muestra el mensaje del propio Mailchimp. Los tres que vas a encontrar de verdad:

**"ada@example.com looks fake or invalid, please enter a real email address."** Mailchimp filtra cada
dirección antes de aceptarla y rechaza dominios enteros que considera de relleno, `example.com` entre
ellos. El lead igual queda guardado en WelcomeAI; lo único que falló es el envío a Mailchimp. No hay
nada que arreglar de este lado: una visita que escribió una dirección descartable no va a llegar a una
audiencia.

**"A Merge Field with the tag BUDGETRANG already exists for this list."** Las etiquetas de Mailchimp
son de diez caracteres y nosotros la construimos desde el nombre del campo, así que dos nombres que
empiezan igual chocaban. Ahora esquivamos una etiqueta que la audiencia ya tenga (`BUDGETRAN2`), de
modo que no deberías ver esto salvo que hayas creado el campo en Mailchimp a mano. Los nombres
conservan sus acentos: *Dirección de envío* se convierte en `DIRECCIOND`.

**Un merge field que no existe en esa audiencia.** La ruta apunta a una etiqueta que la audiencia ya no
tiene. Abre la ruta, refresca la lista de campos y vuelve a asignarla, o deja que el constructor de
rutas cree el campo por ti.