Criar uma automação

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

Crie uma automação enviando um account_id acessível, um name, um status e uma configuration completa. Os quatro campos são obrigatórios e nenhum outro campo é aceito. Sua chave de API precisa do escopo automations:write. Não existem identificadores de modelo na API v1. A configuração que você envia é a configuração que a automação executa.

Escolha o status inicial

status é um enum com dois valores:

Valor	Resultado
`draft`	A automação fica armazenada, mas não processa gatilhos.
`live`	A configuração é validada, publicada e passa a processar os gatilhos correspondentes.

Criar uma automação live exige o escopo automations:activate além de automations:write. Crie primeiro um draft quando quiser revisar a configuração armazenada antes que ela entre em operação. Uma requisição bem-sucedida retorna 201 com a automação armazenada.

Envie a configuração completa

configuration é um objeto tipado e completo. Não é uma mesclagem parcial e não conta com valores padrão do servidor. 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 PublicAutomationCreateV1 dele define o corpo completo da requisição. A API recusa propriedades desconhecidas e retorna 422 com api_automation_invalid_configuration e uma lista de problemas em error.details.issues. Use Listar mídias do Instagram para encontrar o id da mídia de um gatilho que observa uma publicação específica.

Exemplo de requisição

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

Comportamento em retentativas

Criar uma automação não é idempotente. Uma retentativa automática pode criar uma segunda automação.

Se a API retornar api_automation_committed_response_unavailable com committed: true e retryable: false, a automação foi criada, mas a API não conseguiu verificar a resposta. Não repita a chamada automaticamente. Liste as automações da conta antes de criar outra.

Mensagens em carrossel

Consulte Enviar mensagens em carrossel para cards com imagens, botões de link, uma requisição completa e uma mensagem posterior separada.

Exemplo de resposta de sucesso

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

Guias de criação

Autorizações

Authorization

string

header

obrigatório

Levios API key sent as a Bearer token.

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_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

Criar uma automação

Escolha o status inicial

Envie a configuração completa

Exemplo de requisição

Comportamento em retentativas

Mensagens em carrossel

Exemplo de resposta de sucesso

Guias de criação

Autorizações

Corpo

Resposta

​Escolha o status inicial

​Envie a configuração completa

​Exemplo de requisição

​Comportamento em retentativas

​Mensagens em carrossel

​Exemplo de resposta de sucesso

​Guias de criação

Autorizações

Corpo

Resposta

Escolha o status inicial

Envie a configuração completa

Exemplo de requisição

Comportamento em retentativas

Mensagens em carrossel

Exemplo de resposta de sucesso

Guias de criação