Atualizar uma automação

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>"
  }
}

Use este endpoint para alterar name, configuration ou os dois. Sua chave de API precisa de automations:write, e o corpo precisa conter um account_id acessível e expected_updated_at. Você precisa enviar pelo menos um entre name e configuration. Mudanças de status não são aceitas aqui. Use Ativar uma automação ou Desativar uma automação.

Envie a configuração completa

configuration é uma configuração de automação tipada e completa. Não é uma mesclagem parcial. Quando você a inclui, o objeto validado substitui por inteiro a configuração armazenada. Leia a automação primeiro, altere localmente a configuration devolvida e envie o resultado completo. Omitir uma seção não preserva o valor armazenado antes, porque as cinco seções são obrigatórias:

Seção	Finalidade
`contact_filter`	Quais contatos a automação pode responder.
`trigger`	O que inicia a automação e qual publicação ou quais palavras-chave ela observa.
`opening`	A primeira mensagem direta e a resposta pública opcional.
`follow_up`	As ações ordenadas depois da mensagem de abertura, ou `null`.
`extras`	O comportamento de espera entre gatilhos repetidos.

O documento OpenAPI é a fonte de verdade de cada campo, enum, limite e formato de ação aninhada. O schema PublicAutomationUpdateV1 dele define o corpo completo da requisição e cobre:

A escolha do gatilho por type e os objetos publication, story, keywords e reactions que pertencem a ele.
A entrega de abertura por direct_message, com delay_seconds, o text da mensagem e até três botões do tipo start_follow_up ou url.
As respostas públicas por public_reply, com messages, rotation, mention_mode e max_per_post.
As etapas de acompanhamento por actions, incluindo send_message, send_media, send_carousel, ask_to_follow, ask_for_email, ask_for_phone, add_contact_tag e finish.
A proteção contra repetição por extras.cooldown.

Os campos chamados type, mode, match_mode, rotation ou mention_mode são enums. Use somente os valores que esse documento define. A API recusa propriedades desconhecidas e combinações inválidas com 422 e api_automation_invalid_configuration. Leia error.details.issues para descobrir o path, o code e a message que falharam. Use Listar mídias do Instagram para encontrar o id da mídia de um gatilho que observa uma publicação ou um story específico.

Automações criadas antes do contrato público

Uma automação cuja configuração armazenada é anterior ao contrato público volta com authoring_compatibility igual a read_only_legacy e configuration igual a null. Você ainda pode renomeá-la. Enviar uma configuration completa substitui a configuração antiga e converte a automação para o contrato público, o que não pode ser desfeito pela API.

Proteja as alterações concorrentes

Leia a automação primeiro e envie o valor exato de updated_at como expected_updated_at. Se outra requisição alterou a automação, a API retorna 409 com api_automation_version_conflict. Leia a automação de novo e monte uma nova atualização a partir do valor devolvido.

Exemplo de requisição

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

Se a API retornar api_automation_committed_response_unavailable com committed: true e retryable: false, a alteração foi aplicada, mas a API não conseguiu verificar a resposta. Não repita a chamada automaticamente. Leia a automação atual antes de decidir se outra atualização é necessária.

Exemplo de resposta de sucesso

IDs, horários e conteúdo 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"
  }
}

Guias de criação

Autorizações

Authorization

string

header

obrigatório

Levios API key sent as a Bearer token.

Parâmetros de caminho

automationId

string<uuid>

obrigatório

Corpo

application/json

The body is of type any.

Resposta

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>"
  }
}

Referência

Automações

Contas

Contatos

Tags de contato

Métricas

Atualizar uma automação

Envie a configuração completa

Automações criadas antes do contrato público

Proteja as alterações concorrentes

Exemplo de requisição

Exemplo de resposta de sucesso

Guias de criação

Autorizações

Parâmetros de caminho

Corpo

Resposta

​Envie a configuração completa

​Automações criadas antes do contrato público

​Proteja as alterações concorrentes

​Exemplo de requisição

​Exemplo de resposta de sucesso

​Guias de criação

Autorizações

Parâmetros de caminho

Corpo

Resposta

Envie a configuração completa

Automações criadas antes do contrato público

Proteja as alterações concorrentes

Exemplo de requisição

Exemplo de resposta de sucesso

Guias de criação