Guía

Integraciones y webhooks

Todo esto se configura en Ajustes, Integraciones y solo lo ven los dueños y administradores del espacio. Hay dos caminos: conectar Kit o Mailchimp directo, o avisar a Zapier, Make o a tu propio sistema con un webhook.

1. Kit y Mailchimp

Cada correo que te deja una persona (en la pregunta del correo de una automatización de DMs, o en el formulario de tu enlace en la bio) puede ir a tu lista de Kit o de Mailchimp. Cada persona se envía una sola vez por herramienta, sin importar cuántas veces vuelva a escribir.

1. En Kit: Settings, Developer, crea una llave de API V4. En Mailchimp: tu perfil, Extras, API keys, crea una llave (termina en algo como -us19, ahí va tu centro de datos).
2. Pégala en la tarjeta de la herramienta y toca Conectar. La probamos con una llamada de prueba y la guardamos cifrada. Nunca la volvemos a mostrar.
3. Elige el formulario de Kit (o la audiencia de Mailchimp), las etiquetas, y qué contactos van: los del enlace en la bio, todas las automatizaciones, solo algunas o ninguna.
4. Activa el envío y guarda. Desde ese momento cada correo nuevo se manda solo, con reintentos si la herramienta no responde.
5. Para los que ya tenías, toca Sincronizar los existentes. Es una acción tuya, con progreso a la vista, y no escribe a nadie en Instagram.

Permiso de las personas

Por defecto pedimos confirmación por correo (doble confirmación). En Mailchimp la persona entra como pendiente y Mailchimp le escribe. En Kit entra como no confirmada y es el formulario que elegiste el que manda el correo de confirmación, así que usa un formulario con la doble confirmación activada. Solo puedes apagarla si marcas que ya tienes el permiso de cada persona para recibir correos de marketing. Nunca volvemos a suscribir a alguien que se dio de baja en tu herramienta, y no enviamos a quien nos escribió STOP.

Si algo falla

La tarjeta muestra el último envío y el último problema en español. Si la llave dejó de servir, conecta de nuevo con una llave nueva y toca Reintentar los que fallaron. Las fallas de la herramienta (límite de pedidos, caída) se reintentan solas hasta cinco veces.

2. Webhooks de salida

Un webhook avisa a una dirección tuya cada vez que pasa algo. Se configura en Ajustes, Integraciones, abajo de Correo de marketing: la dirección (https), los eventos y un secreto para firmar. Cada aviso es un POST con un JSON así:

{
  "event": "data.captured",
  "createdAt": "2026-10-15T14:03:22.000Z",
  "data": {
    "campaign": { "id": "...", "name": "Guía por correo" },
    "field": "email",
    "value": "ana@ejemplo.com",
    "contact": { "id": "...", "username": "ana", "email": "ana@ejemplo.com", "phone": null, "source": null, "firstSeenAt": "..." }
  }
}

Los eventos que puedes elegir:

• contact.created Alguien interactúa contigo por primera vez, o se apunta en tu enlace en la bio.
• link.clicked Alguien abre un enlace que le mandamos.
• data.captured Alguien responde la pregunta del correo o del teléfono de una automatización.
• campaign.sent Una automatización manda un DM.
• contact.field_updated Alguien responde una de las preguntas de una automatización.
• publication.published Una publicación programada salió en todas las redes.
• publication.partial Una publicación programada salió en algunas redes y falló en otras.
• publication.failed Una publicación programada no pudo salir.
• comment.received Alguien comenta una de tus publicaciones de Instagram. El texto llega en untrusted_text.
• message.received Alguien te escribe un DM. El texto llega en untrusted_text.
• comment.replied Se respondió un comentario en público desde la bandeja, la API o tu agente (via dice cuál).
• message.sent Se mandó un DM a mano desde la bandeja, la API o tu agente (no las automatizaciones; esas son campaign.sent).
• email.opened Un contacto abre por primera vez uno de tus correos (de un envío o de una secuencia).
• email.clicked Un contacto toca un enlace de uno de tus correos. El enlace llega en link.
• email.unsubscribed Un contacto se da de baja de tus correos con el enlace de abajo del correo.
• email.bounced Uno de tus correos no se pudo entregar. bounce_type dice si fue permanente (la dirección no existe) o temporal.
• request.created Se agregó un pedido en Pedidos (tuyo, del asistente, de las pruebas, de una serie o de tu editor). Trae request con los mismos campos de GET /api/v1/requests/{id}.
• request.updated Un pedido cambió: su estado, quién lo tiene, una nota o los archivos que lo cumplen. Trae request completo.

Los avisos llevan las cabeceras X-MiMediaKit-Event, X-MiMediaKit-Delivery, X-MiMediaKit-Timestamp y X-MiMediaKit-Signature. La firma es sha256= más el HMAC SHA256 de timestamp.cuerpo con tu secreto. Respondemos a un error con hasta 5 intentos y guardamos los últimos 50 envíos en Ajustes. Zapier y Make no verifican la firma, y para la mayoría de los usos no hace falta: usa una dirección que solo tú conozcas.

Eventos de tus correos

email.opened, email.clicked, email.unsubscribed y email.bounced dicen qué pasó con los correos que mandas a tus contactos desde Correos, en un envío (campaign_id) o en una secuencia (step_id). Una apertura y un clic se avisan la primera vez de cada persona en cada correo; un clic en otro enlace del mismo correo se avisa otra vez, con su link. Las pruebas que te mandas a ti mismo nunca se avisan.

{
  "event": "email.clicked",
  "createdAt": "2026-10-15T14:03:22.000Z",
  "data": {
    "email": { "send_id": "...", "campaign_id": "...", "step_id": null, "kind": "message" },
    "contact": { "id": "...", "email": "ana@ejemplo.com" },
    "at": "2026-10-15T14:03:20.000Z",
    "link": "https://mimediakit.com/guia"
  }
}

• at es cuándo pasó, según el servicio de correo.
• email.clicked trae además link, el enlace que se tocó.
• email.bounced trae además bounce_type: Permanent (la dirección no existe, ya no se le escribe) o Transient (buzón lleno o el servidor no respondió).
• contact.id puede ser null si el contacto se borró.

3. Zapier y Make

Los dos reciben el aviso con un disparador de webhook y de ahí lo mandan a cualquier app.

• Zapier: crea un Zap con el disparador Webhooks by Zapier, evento Catch Hook, y copia la dirección que te da en la pestaña Test. Ese disparador está en los planes de pago de Zapier.
• Make: en un escenario agrega Webhooks, Custom webhook, toca Add, ponle un nombre y copia la dirección.
• Pega la dirección en Ajustes, Integraciones, elige los eventos, guarda y toca Enviar prueba. Zapier o Make van a detectar los campos del JSON y ya los puedes usar en los pasos siguientes.

4. Cómo llenar una hoja de Google Sheets (con Zapier)

No tenemos una conexión directa con Google Sheets. Con Zapier se hace en unos minutos, y cada fila nueva es un correo que alguien te dejó.

1. En Google Sheets crea una hoja y escribe en la primera fila los títulos: Fecha, Usuario, Correo, Teléfono, Automatización.
2. En Zapier crea un Zap con Webhooks by Zapier, Catch Hook, y copia la dirección.
3. En Mi Media Kit, Ajustes, Integraciones: pega la dirección, marca el evento data.captured (el correo o teléfono que responde una automatización) y guarda. Toca Enviar prueba, y en Zapier toca Test trigger.
4. Agrega el paso Google Sheets, Create Spreadsheet Row, conecta tu cuenta de Google y elige la hoja. Relaciona las columnas: Fecha con createdAt, Usuario con data contact username, Correo con data value (o data contact email), Teléfono con data contact phone y Automatización con data campaign name.
5. Prueba el paso y activa el Zap. Si quieres también a los que se apuntan en tu enlace en la bio, marca además contact.created y agrega en Zapier un filtro: sigue solo si data contact source es BIO_LINK.

En Make es igual: Webhooks, Custom webhook como primer módulo y Google Sheets, Add a Row como segundo.