Automatizaciones

Las automatizaciones le permiten crear secuencias de correo electrónico de múltiples pasos disparadas por eventos de suscriptores. Defina un disparador, construya una secuencia de pasos y MailLand ejecuta el flujo automáticamente cada vez que se activa el disparador.

Disparadores de automatizaciónCopiar enlace de la sección

Cada automatización comienza con un único disparador:

| Manual | 5 | Disparado manualmente vía API |

Estados de automatizaciónCopiar enlace de la sección

Tipos de pasosCopiar enlace de la sección

Cada automatización contiene una secuencia ordenada de pasos:

PersonalizaciónCopiar enlace de la sección

Los pasos de correo de automatización admiten etiquetas de fusión {{variable}}, sustituidas por destinatario a partir del propio registro del suscriptor inscrito.

<p>Hi {{firstName}}, here's what's new this month.</p>

Las grafías antiguas en snake_case ({{first_name}}, {{last_name}}, {{full_name}}, {{subscriber_id}}) siguen funcionando como alias.

Crear una automatizaciónCopiar enlace de la sección

POST https://api.mail.land/v1/marketing/automations

{
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": 0,
  "mailingListId": "7h3n5k8w2q9m1t",
  "campaignId": null,
  "steps": [
    {
      "type": 0,
      "order": 1,
      "templateId": "2p9x4k7m3q8n1z",
      "subject": "Welcome to our newsletter!"
    },
    {
      "type": 1,
      "order": 2,
      "delayMinutes": 1440
    },
    {
      "type": 0,
      "order": 3,
      "templateId": "9k4p2x7m1q3n8z"
    }
  ]
}

No existe un campo segmentId en una automatización: ese campo no existe aquí (los segmentos se usan en otro lugar, por ejemplo en las campañas). El contenido de un paso SendEmail proviene de templateId, no de htmlContent/textContent/fromName/fromEmail en línea.

Campos de los pasosCopiar enlace de la sección

Paso SendEmail (type: 0):

No existe htmlContent/textContent/fromName/fromEmail/replyTo en línea en un paso. El remitente está fijado a noreply@<primer dominio totalmente verificado>, mostrado con el nombre del espacio de trabajo, no es configurable por paso.

Paso Wait (type: 1):

Paso Condition (type: 2):

Un paso Condition es una puerta, no una bifurcación: una lista de pasos lineal no tiene un segundo camino. Cuando evalúa verdadero, la inscripción continúa al siguiente paso. Cuando evalúa falso, la inscripción termina ahí (Completed) y ningún paso posterior se ejecuta para ese suscriptor.

Las comparaciones son comparaciones de cadenas sin distinguir mayúsculas/minúsculas, los mismos operadores que ya ofrecen los segmentos. Se devuelve 400 VALIDATION_FAILED al crear/actualizar cuando conditionField es desconocido, conditionOperator no es uno de los valores anteriores, o falta conditionValue para un operador que lo requiere.

Pasos AddToList / RemoveFromList (type: 3, 4):

Paso UpdateSubscriber (type: 5):

Paso Webhook (type: 6):

Las solicitudes de los pasos Webhook se firman con un secreto del receptor del paso (X-MLND-Signature, se verifica como un webhook de cliente): cada URL de paso distinta tiene su propio secreto, así que ningún receptor puede firmar por otro. Léalos con GET /v1/marketing/automations/{id}/webhook-signing-secrets y renuévelos con POST /v1/marketing/automations/{id}/webhook-signing-secrets/regenerate, vea Versionado. Envíe { "webhookUrl": "…" } para renovar un solo receptor.

curl -X POST https://api.mail.land/v1/marketing/automations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Series",
    "trigger": 0,
    "mailingListId": "7h3n5k8w2q9m1t",
    "steps": [
      {
        "type": 0, "order": 1,
        "subject": "Welcome!",
        "templateId": "2p9x4k7m3q8n1z"
      },
      { "type": 1, "order": 2, "delayMinutes": 1440 },
      {
        "type": 0, "order": 3,
        "subject": "Getting started",
        "templateId": "9k4p2x7m1q3n8z"
      }
    ]
  }'

RespuestaCopiar enlace de la sección

{
  "id": "4f8k2m9p1q6z3s",
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": "subscriberJoins",
  "triggerName": "SubscriberJoins",
  "status": "draft",
  "statusName": "Draft",
  "mailingListId": "7h3n5k8w2q9m1t",
  "mailingListName": "Product Updates",
  "campaignId": null,
  "campaignName": null,
  "stepsCount": 3,
  "totalEnrolled": 0,
  "totalCompleted": 0,
  "activatedAt": null,
  "createdAt": "2026-02-17T12:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

No existe un campo segmentId/segmentName en una automatización, y los contadores de inscripción son totalEnrolled/totalCompleted (no totalEnrollments/activeEnrollments/completedEnrollments). La respuesta de detalle también agrega steps (la lista completa de pasos), completionRate y totalFailed: inscripciones que llegaron a un paso SendEmail sin plantilla en el tenant (ausente o eliminada desde entonces).

Listar automatizacionesCopiar enlace de la sección

GET https://api.mail.land/v1/marketing/automations

curl https://api.mail.land/v1/marketing/automations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Obtener detalles de la automatizaciónCopiar enlace de la sección

GET https://api.mail.land/v1/marketing/automations/{id}

Devuelve la automatización completa incluyendo todos los pasos:

curl https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "id": "4f8k2m9p1q6z3s",
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": "subscriberJoins",
  "triggerName": "SubscriberJoins",
  "status": "active",
  "statusName": "Active",
  "mailingListId": "7h3n5k8w2q9m1t",
  "mailingListName": "Product Updates",
  "campaignId": null,
  "campaignName": null,
  "stepsCount": 3,
  "totalEnrolled": 230,
  "totalCompleted": 200,
  "totalFailed": 4,
  "activatedAt": "2026-01-10T08:05:00Z",
  "steps": [
    {
      "order": 1,
      "type": "sendEmail",
      "typeName": "SendEmail",
      "delayMinutes": null,
      "templateId": "2p9x4k7m3q8n1z",
      "subject": "Welcome to our newsletter!",
      "settings": null
    },
    {
      "order": 2,
      "type": "wait",
      "typeName": "Wait",
      "delayMinutes": 1440,
      "templateId": null,
      "subject": null,
      "settings": null
    },
    {
      "order": 3,
      "type": "sendEmail",
      "typeName": "SendEmail",
      "delayMinutes": null,
      "templateId": "9k4p2x7m1q3n8z",
      "subject": "Getting started with MailLand",
      "settings": null
    }
  ],
  "completionRate": 86.96,
  "createdAt": "2026-01-10T08:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Actualizar una automatizaciónCopiar enlace de la sección

PUT https://api.mail.land/v1/marketing/automations/{id}

Se puede actualizar cualquier estado excepto Active (no solo Draft/Paused). El cuerpo de la solicitud es el mismo que el de creación.

curl -X PUT https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Series",
    "trigger": 0,
    "mailingListId": "7h3n5k8w2q9m1t",
    "steps": [
      {
        "type": 0, "order": 1,
        "subject": "Welcome!",
        "templateId": "2p9x4k7m3q8n1z"
      },
      { "type": 1, "order": 2, "delayMinutes": 1440 },
      {
        "type": 0, "order": 3,
        "subject": "Getting started",
        "templateId": "9k4p2x7m1q3n8z"
      }
    ]
  }'

Activar una automatizaciónCopiar enlace de la sección

POST https://api.mail.land/v1/marketing/automations/{id}/activate

Cambia el estado de la automatización de Draft o Paused a Active. Una vez activa, la automatización comienza a inscribir suscriptores cuando se activa el disparador.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/activate \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Pausar una automatizaciónCopiar enlace de la sección

POST https://api.mail.land/v1/marketing/automations/{id}/pause

Pausa la automatización. No se inscriben nuevos suscriptores, y los suscriptores que ya están en la secuencia dejan de avanzar: cada inscripción se detiene en su paso actual. Volver a activar la automatización reanuda cada inscripción detenida desde donde quedó, entregando todo lo que venció mientras estaba pausada.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/pause \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Archivar una automatizaciónCopiar enlace de la sección

POST https://api.mail.land/v1/marketing/automations/{id}/archive

Archiva la automatización, lo cual se puede hacer desde cualquier estado, incluido Active. Las automatizaciones archivadas se ocultan de las vistas de lista predeterminadas.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/archive \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Duplicar una automatizaciónCopiar enlace de la sección

POST https://api.mail.land/v1/marketing/automations/{id}/duplicate?name=Copy%20of%20Welcome%20Series

Crea una nueva automatización en Draft con los pasos y configuraciones clonados. El parámetro de consulta name es opcional.

curl -X POST "https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/duplicate?name=Copy%20of%20Welcome%20Series" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Disparar manualmenteCopiar enlace de la sección

POST https://api.mail.land/v1/marketing/automations/{id}/trigger

{
  "subscriberIds": ["3m8k1p9x4q7n2z", "6q2n9k4x1p8m3z", "1x7m3q8k2n9p4z"]
}

Inscriba manualmente suscriptores específicos en la automatización. La automatización debe estar en estado Active y su tipo de disparador debe ser Manual (5).

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/trigger \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"subscriberIds": ["3m8k1p9x4q7n2z", "6q2n9k4x1p8m3z", "1x7m3q8k2n9p4z"]}'

Seguimiento de inscripcionesCopiar enlace de la sección

El progreso de cada suscriptor a través de la automatización se rastrea como una inscripción:

No existe un estado de inscripción Cancelled. La respuesta de detalle de la automatización incluye conteos agregados de inscripciones como totalEnrolled y totalCompleted (no totalEnrollments/activeEnrollments/completedEnrollments/failedEnrollments).

Eliminar una automatizaciónCopiar enlace de la sección

DELETE https://api.mail.land/v1/marketing/automations/{id}

Elimina permanentemente la automatización, sus pasos y los datos de inscripción.

curl -X DELETE https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Respuestas de errorCopiar enlace de la sección

Los endpoints de automatizaciones nunca devuelven 422.

Próximos pasosCopiar enlace de la sección

• Campañas: envíe campañas de una sola vez
• Suscriptores: administre los contactos a los que se dirigen las automatizaciones
• Listas: organice suscriptores en listas para los disparadores