Saltar al contenido principal

Mailchimp

¿Prefieres configuracion guiada con IA?

En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.

Descripción General​

Conecta tu cuenta de Mailchimp a Nirvai para gestionar campañas de email, audiencias y flujos de trabajo de automatización de marketing.

Métodos de Autenticación Soportados​

  • API Key - Clave de API estándar de Mailchimp

Requisitos Previos​

  • Una cuenta de Mailchimp (gratuita o de pago)
  • Rol de Admin o Manager en tu cuenta de Mailchimp

Instrucciones de Configuración​

Generar una API Key​

  1. Inicia sesión en tu cuenta de Mailchimp
  2. Haz clic en tu icono de perfil (abajo a la izquierda)
  3. Ve a Account & billing
  4. Navega a Extras > API keys
  5. En la sección "Your API keys", haz clic en Create A Key
  6. Dale a tu clave una etiqueta descriptiva (ej., "Integración Nirvai")
  7. Haz clic en Generate Key
  8. Copia la API key inmediatamente (formato: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-us1)
  9. En Nirvai, crea una nueva credencial de Mailchimp y pega la clave

Entender el Formato de la API Key​

Las API keys de Mailchimp tienen dos partes:

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-us1
|_______________________________|  |__|
        API Key                  Data Center

El sufijo (ej., us1, us2, eu1) indica tu centro de datos. Esto se extrae automáticamente de la clave para las llamadas a la API.

Permisos de API Key​

Las API keys tienen acceso completo a tu cuenta de Mailchimp. Para acceso limitado:

  • Considera usar OAuth2 para aplicaciones orientadas al usuario
  • Crea claves separadas para diferentes integraciones
  • Audita y revoca regularmente claves no utilizadas

Solución de Problemas​

Problemas Comunes​

  • 401 Unauthorized: La API key es inválida o fue revocada. Genera una nueva clave.
  • 403 Forbidden: La cuenta puede estar pausada o tener problemas de facturación.
  • Centro de datos incorrecto: Asegúrate de usar el endpoint de API correcto para el centro de datos de tu clave.
  • Límites de tasa: Mailchimp tiene límites de tasa; implementa backoff exponencial para reintentos.

Encontrar tu Centro de Datos​

Tu centro de datos está en el sufijo de la API key. También puedes encontrarlo:

  1. Inicia sesión en Mailchimp
  2. Mira la URL: https://us1.admin.mailchimp.com (us1 es tu centro de datos)

Límites de Tasa de API​

  • Máximo 10 conexiones simultáneas
  • Sin límite estricto de solicitudes, pero las solicitudes excesivas pueden ser limitadas
  • Usa endpoints de batch para operaciones masivas

Recursos Relacionados​

Adaptado para la plataforma Nirvai

Siguientes Pasos​

¿Ya tienes tu credencial? Conectala a un agente

Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.