Crie e edite pelo MCP

O MCP usa a mesma configuração tipada da API. Leia o guia de configuração, os exemplos de triggers e os exemplos de actions. Permissões OAuth e acesso à conta continuam sendo exigidos.

Consulte antes de escrever

Chame get_automation_guide para conhecer o fluxo de ativação da conexão. Use list_accounts para selecionar a conta e list_instagram_media ao vincular uma publicação ou story. Consulte os campos exatos com get_automation_schema, por exemplo:

{
  "section": "follow_up"
}

Valide e revise a configuração completa

Chame validate_automation_configuration com configuration_json contendo a configuração completa serializada como uma string JSON e language definido como en, pt-BR ou es. Em uma edição, inclua previous_configuration_json com a configuração completa anterior. Não envie o envelope de criação para esse validador.

{
  "configuration_json": "{\"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\"}}}",
  "language": "en"
}

O resultado contém valid, issues, preview_json, preview_markdown, comparison e account_capabilities_checked. Apresente a prévia completa e os caminhos alterados antes de escrever. Acrescente separadamente a conta verificada, nome, status solicitado e fluxo real de ativação. Um resultado válido é validação estrutural, não elegibilidade da conta, aprovação de ativação, verificação de mídia ou entrega.

Crie

Após a revisão, chame create_automation com os argumentos abaixo. Diferentemente da validação, a criação recebe configuration como objeto. Substitua o ID ilustrativo da conta.

{
  "account_id": "00000000-0000-4000-8000-000000000001",
  "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": {
      "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"
      }
    }
  }
}

Uma criação concluída retorna a automação em structuredContent.automation, com os campos de detalhe e a configuração completa mostrados na resposta do fluxo da API. Resultados MCP são resultados de ferramenta, não respostas HTTP 201. Consulte isError e qualquer confirmação pendente antes de afirmar que concluiu. A criação ativa e mudanças de estado usam o fluxo de confirmação exposto pela conexão; não invente argumentos de confirmação.

Edite e consulte o resultado

Chame get_automation com account_id e automation_id. Revise a configuração retornada, valide a substituição com a configuração anterior e chame update_automation. Uma renomeação usa estes argumentos:

{
  "account_id": "00000000-0000-4000-8000-000000000001",
  "automation_id": "00000000-0000-4000-8000-000000000002",
  "expected_updated_at": "2026-09-01T12:00:00.000000Z",
  "name": "Updated guide request"
}

Para editar o comportamento, inclua o objeto configuration inteiro. Use o updated_at atual exato como expected_updated_at. Consulte após escrever e verifique has_unpublished_changes; o rascunho de uma automação ativa não é publicado automaticamente. Use a ferramenta de ativação anunciada por tools/list para publicar após revisão e confirmação. Em conflito de versão, consulte e concilie antes de repetir. Em um resultado incerto de criação, liste e concilie para evitar duplicatas.

Visão geral

Skills de Agentes

Guias de configuração

Crie e edite pelo MCP

Consulte antes de escrever

Valide e revise a configuração completa

Crie

Edite e consulte o resultado

​Consulte antes de escrever

​Valide e revise a configuração completa

​Crie

​Edite e consulte o resultado

Consulte antes de escrever

Valide e revise a configuração completa

Crie

Edite e consulte o resultado