Crear una automatización

POST

api

automations

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_plan_limit",
    "message": "The account plan does not allow this automation.",
    "correlation_id": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_media_not_found",
    "message": "The referenced Instagram media was not found.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_follow_up_missing",
    "message": "A start_follow_up opening button requires a follow-up.",
    "correlation_id": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_committed_response_unavailable",
    "message": "The automation committed, but its response could not be verified. Do not retry automatically.",
    "correlation_id": "<string>",
    "details": {
      "committed": true,
      "retryable": false
    }
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Crea una automatización enviando un account_id accesible, un name, un status y una configuration completa. Los cuatro campos son obligatorios y no se acepta ningún otro. Tu clave de API necesita el alcance automations:write. No existen identificadores de plantilla en la API v1. La configuración que envías es la configuración que ejecuta la automatización.

Elige el estado inicial

status es un enum con dos valores:

Valor	Resultado
`draft`	La automatización queda almacenada, pero no procesa disparadores.
`live`	La configuración se valida, se publica y empieza a procesar los disparadores que coinciden.

Crear una automatización live exige el alcance automations:activate además de automations:write. Crea primero un draft cuando quieras revisar la configuración almacenada antes de que entre en funcionamiento. Una solicitud correcta devuelve 201 con la automatización almacenada.

Envía la configuración completa

configuration es un objeto tipado y completo. No es una fusión parcial y no cuenta con valores predeterminados del servidor. Cinco secciones son obligatorias:

Sección	Finalidad
`contact_filter`	A qué contactos puede responder la automatización.
`trigger`	Qué inicia la automatización y qué publicación o qué palabras clave vigila.
`opening`	El primer mensaje directo y la respuesta pública opcional.
`follow_up`	Las acciones ordenadas después del mensaje de apertura, o `null`.
`extras`	El comportamiento de espera entre disparadores repetidos.

El documento OpenAPI es la fuente de verdad de cada campo, enum, límite y forma de acción anidada. Su esquema PublicAutomationCreateV1 define el cuerpo completo de la solicitud. La API rechaza propiedades desconocidas y devuelve 422 con api_automation_invalid_configuration y una lista de problemas en error.details.issues. Usa Listar medios de Instagram para encontrar el id del medio de un disparador que vigila una publicación concreta.

Solicitud de ejemplo

curl --request POST \
  --url 'https://levios.app/api/v1/automations' \
  --header "Authorization: Bearer ${LEVIOS_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data @- <<JSON
{
  "account_id": "${LEVIOS_ACCOUNT_ID}",
  "name": "Guide request",
  "status": "draft",
  "configuration": {
    "contact_filter": "anyone",
    "trigger": {
      "type": "comment",
      "publication": {
        "mode": "all"
      },
      "keywords": {
        "mode": "specific",
        "match_mode": "whole_word",
        "values": ["guide"]
      }
    },
    "opening": {
      "direct_message": {
        "delay_seconds": 0,
        "message": {
          "text": "Here is the guide you asked for.",
          "buttons": [
            {
              "type": "url",
              "title": "Open the guide",
              "url": "https://example.com/guide"
            }
          ]
        }
      },
      "public_reply": {
        "enabled": false
      }
    },
    "follow_up": null,
    "extras": {
      "cooldown": {
        "mode": "none"
      }
    }
  }
}
JSON

Comportamiento ante reintentos

Crear una automatización no es idempotente. Un reintento automático puede crear una segunda automatización.

Si la API devuelve api_automation_committed_response_unavailable con committed: true y retryable: false, la automatización se creó, pero la API no pudo verificar la respuesta. No repitas la llamada automáticamente. Lista las automatizaciones de la cuenta antes de crear otra.

Mensajes en carrusel

Consulta Enviar mensajes en carrusel para tarjetas con imágenes, botones de enlace, una solicitud completa y un mensaje posterior separado.

Ejemplo de respuesta correcta

ID, fechas y contenido ilustrativos. HTTP 201.

{
  "automation": {
    "id": "00000000-0000-4000-8000-000000000002",
    "account_id": "00000000-0000-4000-8000-000000000001",
    "name": "Guide request",
    "status": "draft",
    "has_unpublished_changes": false,
    "draft_updated_at": null,
    "created_at": "2026-09-01T12:00:00.000000Z",
    "updated_at": "2026-09-01T12:00:00.000000Z",
    "trigger_type": "comment",
    "configuration": {
      "contact_filter": "anyone",
      "trigger": {
        "type": "comment",
        "publication": {
          "mode": "all"
        },
        "keywords": {
          "mode": "specific",
          "match_mode": "whole_word",
          "values": [
            "guide"
          ]
        }
      },
      "opening": {
        "public_reply": {
          "enabled": false
        },
        "direct_message": {
          "delay_seconds": 0,
          "message": {
            "text": "Here is the guide you asked for.",
            "buttons": [
              {
                "type": "url",
                "title": "Open the guide",
                "url": "https://example.com/guide"
              }
            ]
          }
        }
      },
      "follow_up": null,
      "extras": {
        "cooldown": {
          "mode": "none"
        }
      }
    },
    "authoring_compatibility": "public_v1"
  }
}

Guías de creación

Autorizaciones

Authorization

string

header

requerido

Levios API key sent as a Bearer token.

Cuerpo

application/json

The body is of type any.

Respuesta

Successful response.

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_plan_limit",
    "message": "The account plan does not allow this automation.",
    "correlation_id": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_media_not_found",
    "message": "The referenced Instagram media was not found.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_follow_up_missing",
    "message": "A start_follow_up opening button requires a follow-up.",
    "correlation_id": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_committed_response_unavailable",
    "message": "The automation committed, but its response could not be verified. Do not retry automatically.",
    "correlation_id": "<string>",
    "details": {
      "committed": true,
      "retryable": false
    }
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Referencia

Automatizaciones

Cuentas

Contactos

Etiquetas de contacto

Métricas

Crear una automatización

Elige el estado inicial

Envía la configuración completa

Solicitud de ejemplo

Comportamiento ante reintentos

Mensajes en carrusel

Ejemplo de respuesta correcta

Guías de creación

Autorizaciones

Cuerpo

Respuesta

​Elige el estado inicial

​Envía la configuración completa

​Solicitud de ejemplo

​Comportamiento ante reintentos

​Mensajes en carrusel

​Ejemplo de respuesta correcta

​Guías de creación

Autorizaciones

Cuerpo

Respuesta

Elige el estado inicial

Envía la configuración completa

Solicitud de ejemplo

Comportamiento ante reintentos

Mensajes en carrusel

Ejemplo de respuesta correcta

Guías de creación