Actualizar una automatización

PATCH

api

automations

{automationId}

{
  "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_automation_version_conflict",
    "message": "The automation changed after the supplied version.",
    "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>"
  }
}

Usa este endpoint para cambiar name, configuration o ambos. Tu clave de API necesita automations:write, y el cuerpo debe contener un account_id accesible y expected_updated_at. Debes enviar al menos uno entre name y configuration. Los cambios de estado no se aceptan aquí. Usa Activar una automatización o Desactivar una automatización.

Envía la configuración completa

configuration es una configuración de automatización tipada y completa. No es una fusión parcial. Cuando la incluyes, el objeto validado reemplaza por completo la configuración almacenada. Lee la automatización primero, modifica en local la configuration devuelta y envía el resultado completo. Omitir una sección no conserva su valor guardado antes, porque las 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 PublicAutomationUpdateV1 define el cuerpo completo de la solicitud y cubre:

La elección del disparador mediante type y los objetos publication, story, keywords y reactions que le pertenecen.
La entrega de apertura mediante direct_message, con delay_seconds, el text del mensaje y hasta tres botones de tipo start_follow_up o url.
Las respuestas públicas mediante public_reply, con messages, rotation, mention_mode y max_per_post.
Los pasos de seguimiento mediante actions, incluidos send_message, send_media, send_carousel, ask_to_follow, ask_for_email, ask_for_phone, add_contact_tag y finish.
La protección ante repeticiones mediante extras.cooldown.

Los campos llamados type, mode, match_mode, rotation o mention_mode son enums. Usa solo los valores que define ese documento. La API rechaza propiedades desconocidas y combinaciones inválidas con 422 y api_automation_invalid_configuration. Lee error.details.issues para conocer el path, el code y el message que fallaron. Usa Listar medios de Instagram para encontrar el id del medio de un disparador que vigila una publicación o una historia concreta.

Automatizaciones creadas antes del contrato público

Una automatización cuya configuración almacenada es anterior al contrato público se devuelve con authoring_compatibility igual a read_only_legacy y configuration igual a null. Todavía puedes renombrarla. Enviar una configuration completa reemplaza la configuración antigua y convierte la automatización al contrato público, algo que no se puede deshacer desde la API.

Protege los cambios concurrentes

Lee la automatización primero y envía su valor exacto de updated_at como expected_updated_at. Si otra solicitud cambió la automatización, la API devuelve 409 con api_automation_version_conflict. Lee la automatización de nuevo y arma una actualización nueva a partir del valor que devuelve.

Solicitud de ejemplo

curl --request PATCH \
  --url "https://levios.app/api/v1/automations/${LEVIOS_AUTOMATION_ID}" \
  --header "Authorization: Bearer ${LEVIOS_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data @- <<JSON
{
  "account_id": "${LEVIOS_ACCOUNT_ID}",
  "expected_updated_at": "${EXPECTED_UPDATED_AT}",
  "name": "Guide request",
  "configuration": {
    "contact_filter": "anyone",
    "trigger": {
      "type": "comment",
      "publication": {
        "mode": "specific",
        "reference": {
          "type": "url",
          "value": "https://www.instagram.com/p/ABC123/"
        }
      },
      "keywords": {
        "mode": "specific",
        "match_mode": "whole_word",
        "values": ["guide"]
      }
    },
    "opening": {
      "direct_message": {
        "delay_seconds": 0,
        "message": {
          "text": "Tap below to continue.",
          "buttons": [
            {
              "type": "start_follow_up",
              "title": "Continue"
            }
          ]
        }
      },
      "public_reply": {
        "enabled": true,
        "delay_seconds": 0,
        "max_per_post": 50,
        "mention_mode": "none",
        "rotation": "random",
        "messages": ["I sent it by DM."]
      }
    },
    "follow_up": {
      "actions": [
        {
          "type": "ask_for_email",
          "delay_seconds": 0,
          "message": "What is your best email address?",
          "retry_message": "Send a valid email address.",
          "max_attempts": 3,
          "expires_in_seconds": 86400,
          "retry_exhausted_action": "stop"
        },
        {
          "type": "send_message",
          "delay_seconds": 0,
          "text": "Here is your access link.",
          "buttons": [
            {
              "type": "url",
              "title": "Open content",
              "url": "https://example.com/content"
            }
          ]
        },
        {
          "type": "finish"
        }
      ]
    },
    "extras": {
      "cooldown": {
        "mode": "fixed",
        "seconds": 21600
      }
    }
  }
}
JSON

Si la API devuelve api_automation_committed_response_unavailable con committed: true y retryable: false, el cambio se aplicó, pero la API no pudo verificar la respuesta. No repitas la llamada automáticamente. Lee la automatización actual antes de decidir si hace falta otra actualización.

Ejemplo de respuesta correcta

ID, fechas y contenido ilustrativos. HTTP 200.

{
  "automation": {
    "id": "00000000-0000-4000-8000-000000000002",
    "account_id": "00000000-0000-4000-8000-000000000001",
    "name": "Updated 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:05: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.

Parámetros de ruta

automationId

string<uuid>

requerido

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_automation_version_conflict",
    "message": "The automation changed after the supplied version.",
    "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

Actualizar una automatización

Envía la configuración completa

Automatizaciones creadas antes del contrato público

Protege los cambios concurrentes

Solicitud de ejemplo

Ejemplo de respuesta correcta

Guías de creación

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Envía la configuración completa

​Automatizaciones creadas antes del contrato público

​Protege los cambios concurrentes

​Solicitud de ejemplo

​Ejemplo de respuesta correcta

​Guías de creación

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Envía la configuración completa

Automatizaciones creadas antes del contrato público

Protege los cambios concurrentes

Solicitud de ejemplo

Ejemplo de respuesta correcta

Guías de creación