O gerenciamento individual de sites WordPress consome tempo. Para agências que lidam com dezenas ou até centenas de sites, tarefas como criar ambientes, limpar caches, adicionar domínios ou restaurar backups podem se acumular rapidamente. A equipe perde agilidade como resultado desse ciclo repetitivo.

E esse é o padrão típico de muitos:

  • Integração de um novo cliente → o desenvolvedor configura o WordPress manualmente, adiciona domínios e configura plugins
  • Alguém envia um deploy → a equipe precisa fazer login e limpar os caches manualmente
  • Um cliente relata um bug → a equipe de malware verifica os registros manualmente e, talvez, o site seja revertido por meio de um backup

Nenhuma dessas tarefas é difícil, mas executá-las repetidamente consome um tempo que deveria ser investido em trabalhos mais importantes.

É por isso que a Kinsta oferece não apenas um painel de controle limpo e intuitivo, mas também a API da Kinsta para automatizar as tarefas rotineiras que sua agência realiza todos os dias.

Vamos explorar algumas tarefas de gerenciamento do WordPress que as agências automatizam com a API da Kinsta.

Crie e clone sites WordPress

A instalação de um novo site WordPress é provavelmente a coisa mais comum que sua equipe faz. No estágio inicial de sua agência, isso não parecerá um grande problema, já que você pode estar criando apenas de cinco a 10 sites por semana. Mas, à medida que você cresce, isso muda. Você se depara com oportunidades como a Black Friday ou o lançamento de um grande cliente, em que precisa lançar dezenas de sites em poucos dias.

Nesse ponto, fazer isso manualmente não é escalável. Ou você desacelera, contrata e treina mais pessoas (o que custa tempo e dinheiro), ou você automatiza.

Com a API da Kinsta, você pode integrar isso à sua ferramenta ou painel interno, de modo que a criação de um novo site WordPress se torne tão simples quanto clicar em um botão.

Digamos que alguém se cadastre no site da sua agência e pague. Você poderia ter um script que pega os resultados do formulário de inscrição e chama a API para criar um novo site WordPress com seu tema base.

Isso não é teórico. A API já tem tudo o que você precisa:

Se você gerencia muitos sites, isso economizará horas do seu processo de configuração toda semana.

Gerencie domínios programaticamente

Essa é uma escolha óbvia se você lida com sites de clientes em escala.

As agências adicionam ou alteram domínios regularmente, talvez durante a integração ou uma reformulação completa da marca. Se você for uma agência grande, talvez queira reduzir o tempo necessário para clicar no MyKinsta para adicionar domínios, verificar o DNS e configurar o SSL.

Com a API da Kinsta, você pode mover tudo isso para um fluxo de trabalho automatizado.

Aqui está um cenário comum do mundo real: Um novo cliente se inscreve. Você já tem o nome de domínio e o DNS definidos em seu CRM. Seu sistema interno verifica se os registros de DNS apontam para a Kinsta (talvez usando uma pesquisa de DNS nos bastidores) e, no momento em que isso é confirmado, ele chama a API para:

  • Anexar o domínio
  • Definir como o domínio principal
  • Fazer upload do SSL personalizado, se necessário

Você pode até ter uma notificação do Slack que diz “✅ clientdomain.com foi anexado e o SSL está ativo”.

Outro cenário: Digamos que você esteja reformulando a marca de 20 sites de clientes em massa. Para atualizar cada ambiente com novos domínios, fazer a troca e aplicar o SSL automaticamente, coloque todas as alterações de domínio na fila e faça um loop pela API em vez de atualizar cada um manualmente.

Alguns dos endpoints que permitem isso são os seguintes:

Isso é mais do que apenas um recurso interessante. Esse tipo de automação literalmente economiza horas e elimina erros humanos para agências que executam essa tarefa de cinco a dez vezes por semana.

Se quiser ir além, você pode até expor esse controle em seu próprio painel interno. Clique em “Atribuir domínio”, escolha o site e o domínio, e seu aplicativo chamará a API da Kinsta.

Gerencie backups: liste, restaure ou baixe

Às vezes, uma implantação (deploy) pode falhar, os plugins podem se comportar mal ou um cliente pode relatar um problema no site ativo. Com o MyKinsta, você já tem backups confiáveis disponíveis. Mas quando você está gerenciando vários sites e precisa agir rapidamente, é útil ter o controle de backup conectado diretamente ao seu fluxo de trabalho.

É aí que entra a API. As agências estão conectando isso aos seus pipelines de implementação para que:

  • Um backup manual seja criado imediatamente antes de uma implementação
  • Se algo der errado, uma restauração é acionada automaticamente
  • As equipes não precisam sair do Slack ou do seu painel para reverter um site

Por exemplo, você pode configurar um comando do Slack como:

/restore site-name to yesterday

Isso chamaria seu serviço interno, que acionaria o endpoint de restauração. Ou imagine um botão de “Restauração rápida” com um clique em sua ferramenta interna, e a API traz o site de volta a um estado estável sem que você precise fazer login no MyKinsta.

Veja o que é possível fazer com os endpoints disponíveis:

A API oferece à sua equipe a opção de agir rapidamente, especialmente em momentos de alta pressão.

Atualize plugins e temas em massa

Escrevemos um guia que explica como você pode criar uma ferramenta simples usando a API da Kinsta para verificar e atualizar em massa plugins desatualizados em vários sites WordPress a partir de um único painel.

Mini aplicativo web criado para automatizar atualizações de plugins do WordPress usando a API Kinsta.
Mini aplicativo web criado para automatizar atualizações de plugins do WordPress usando a API Kinsta.

Essa mesma ideia ainda funciona, embora a Kinsta agora ofereça atualizações automáticas de plugins e temas como um complemento premium (que, a propósito, também executa testes visuais e retrocessos automáticos).

O complemento de Atualizações Automáticas de Plugins da Kinsta.
O complemento de Atualizações Automáticas de Plugins da Kinsta.

Mas se a sua equipe quiser um tipo diferente de controle, a API oferece essa liberdade. Você pode mostrar todos os plugins nos sites de seus clientes em uma única exibição, destacar os desatualizados e permitir que seus desenvolvedores escolham quais atualizar.

Talvez permitir que sua equipe de QA marque alguns para teste antes de enviar as atualizações para produção. Você também pode limpar o excesso de recursos filtrando plugins inativos e removendo-os diretamente.

O endpoint de plugins retorna detalhes reais como:

{
  "name": "akismet",
  "title": "Akismet Anti-Spam",
  "status": "active",
  "version": "1.0.0",
  "update": "available",
  "update_version": "1.0.1"
}

Com essas informações, você pode criar a lógica que quiser:

  • Mostrar a contagem de plugins por site
  • Detectar desvios de versão
  • Acionar atualizações em vários ambientes
  • Ou até mesmo criar um bot do Slack que responda com “este site tem 4 plugins desatualizados” e um botão para corrigi-lo

Portanto, embora o novo complemento resolva o gerenciamento de plugins para a maioria das equipes, a API abre um nível totalmente novo de visibilidade e automação personalizada que pode se adequar ao seu estilo de trabalho.

Limpar cache, reiniciar o PHP, Enviar para Produção

Os endpoints de limpar o cache e reiniciar o PHP estão entre os três mais usados na API da Kinsta, e é fácil ver por quê.

Painel de uso da API da Kinsta mostrando estatísticas de solicitações.
Painel de uso da API da Kinsta mostrando estatísticas de solicitações.

Logo após uma implantação (deploy), limpar os caches é geralmente o primeiro passo. O mesmo acontece com a reinicialização do PHP quando as coisas não funcionam como deveriam. Essas não são operações “sofisticadas”. São apenas o tipo de tarefa que sua equipe realiza com frequência. Portanto, elas também são o tipo de coisa que deve ser automatizada.

Se sua equipe já usa o Git por SSH para implantar na Kinsta, você pode integrar essas chamadas de API diretamente no seu pipeline de CI, talvez por meio do GitHub Actions. Sem que um usuário faça login no MyKinsta, tudo se redefine sozinho com um único push limpo.

Aqui está um exemplo de pipeline:

name: Deploy to Kinsta and clear cache

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Deploy through SSH
        uses: appleboy/[email protected]
        with:
          host: ${{ secrets.KINSTA_SERVER_IP }}
          username: ${{ secrets.KINSTA_USERNAME }}
          password: ${{ secrets.KINSTA_PASSWORD }}
          port: ${{ secrets.KINSTA_PORT }}
          script: |
            cd /www/your-site/public
            git fetch origin main
            git reset --hard origin/main

      - name: Clear Kinsta cache
        run: |
          curl -X POST https://api.kinsta.com/v2/environments/${{ secrets.KINSTA_ENV_ID }}/tools/clear-cache \
          -H "Authorization: Bearer ${{ secrets.KINSTA_API_KEY }}" \
          -H "Content-Type: application/json"

      - name: Restart PHP
        run: |
          curl -X POST https://api.kinsta.com/v2/environments/${{ secrets.KINSTA_ENV_ID }}/tools/restart-php \
          -H "Authorization: Bearer ${{ secrets.KINSTA_API_KEY }}" \
          -H "Content-Type: application/json"

Isso é simples, mas poderoso. Você pode ir ainda mais longe:

  • Adicione um botão “Limpar cache” ao seu painel de controle interno
  • Acione a limpeza do cache via Slack, usando um comando de bot como /cache-clear client-name
  • Inclua a limpeza do cache e a reinicialização do PHP como parte do fluxo de implantação do ambiente de teste para o de produção

E se você estiver usando o endpoint Mover para produção (Push to Live), as coisas ficarão ainda mais interessantes. Você não precisa mover tudo, pois a API é compatível com opção de mover seletivamente os arquivos usando push_files_option: 'SPECIFIC_FILES'.

Assim, você pode personalizar suas implantações para mover apenas alterações de plugins ou temas:

{
  "source_env_id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
  "target_env_id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
  "push_db": true,
  "push_files": true,
  "run_search_and_replace": true,
  "push_files_option": "SPECIFIC_FILES",
  "file_list": [
    "wp-content/plugins",
    "wp-content/themes",
    "wp-content/uploads"
  ]
}

Esse é o tipo de coisa que facilita a vida de seus desenvolvedores e mantém as coisas rápidas para seus clientes.

Acesse os registros de acesso para monitoramento ou depuração

Como agência, sua equipe gerencia muitos sites de clientes. Você já sabe que, quando um cliente diz: “O site está fora do ar”, geralmente ele já está quebrado há algum tempo.

É aí que entra o endpoint de registros. Em vez de esperar pelas reclamações dos clientes, você pode extrair registros diretamente pela API e exibi-los em seu painel interno. Melhor ainda, configure um sistema de alerta simples que avisa sua equipe no Slack ou por e-mail quando algo parece estar errado.

Você não precisa abrir o MyKinsta sempre que alguém relatar um erro 500. Basta buscar o erro mais recente ou acessar os registros, analisar a saída e exibir os resultados onde sua equipe já trabalha.

Você só precisa do ID do ambiente e do tipo de registro que deseja, como error, access ou kinsta-cache-perf. Você também pode limitar o número de linhas retornadas:

curl -i -X GET \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/logs?file_name=error&lines=1000' \
  -H 'Authorization: Bearer '

Você receberá de volta uma string simples do conteúdo do registro. A partir daí, você pode criar o que for adequado ao seu fluxo de trabalho:

  • Mostrar os registros de erro mais recentes de cada site de cliente no painel da agência
  • Destacar erros 500, consultas lentas ou cron jobs que falharam
  • Acionar alertas quando houver picos de erros
  • Permitir que seus desenvolvedores digitem /show-logs client-x no Slack e visualizem instantaneamente o resultado em tempo real

Esse é o tipo de visibilidade que te salva de momentos de “ops” durante as chamadas com clientes.

Exemplo real: Como a Sod usa a API para gerenciar mais de 400 sites

Se você está se perguntando se agências reais estão usando a API da Kinsta dessa forma, elas estão.

Veja o exemplo da Straight Out Digital (Sod), uma agência de serviço completo em Melbourne, Austrália, que gerencia mais de 400 sites WordPress. Quando sua lista de clientes explodiu, a maneira manual de fazer as coisas simplesmente não conseguia acompanhar. Então, eles construíram ferramentas internas sobre a API da Kinsta para automatizar tudo, desde o provisionamento de sites até as atualizações de plugins.

Eles a usam para:

  • Criar novos sites automaticamente ao integrar clientes
  • Clonar configurações existentes sem fazer login no painel
  • Executar verificações e atualizações de plugins em massa em todo o seu portfólio
  • Acionar alertas quando erros aparecem nos registros
  • Antecipar-se a problemas sem esperar por tickets de clientes

Eles ainda usam o MyKinsta diariamente, mas a API os ajuda a evitar o trabalho repetitivo. Em suas próprias palavras:

A API da Kinsta nos permitiu desenvolver ferramentas internas que automatizam processos cruciais como o provisionamento de sites e executam operações em massa em nossos sites, economizando tempo e esforço consideráveis”, diz Pete Brundle, Líder de Desenvolvimento da Sod.

Isso é a prova de que esses fluxos de trabalho não são teóricos. Agências como a Sod já os estão usando, e a empresa ultrapassou a marca de 400 sites por causa disso.

Resumo

Se você gerencia uma agência com vários sites WordPress, a API da Kinsta não é apenas um recurso interessante. É como você recupera seu tempo.

Seja para integrá-la ao seu pipeline de CI, acionar ações a partir de suas ferramentas internas ou apenas para facilitar a vida de seus desenvolvedores, as peças já estão lá. Você não precisa reconstruir seu processo do zero. Você só precisa integrar as partes que mais atrasam sua equipe.

E como vimos com agências como a Sod, o retorno se multiplica à medida que você cresce.

Explore a documentação da API da Kinsta para ver o que é possível, gere sua chave API no MyKinsta e verifique tutoriais passo a passo sobre a criação de bots do Slack, implantação via Git e muito mais!

Joel Olawanle Kinsta

Joel é um desenvolvedor Frontend que trabalha na Kinsta como Editor Técnico. Ele é um professor apaixonado com amor pelo código aberto e já escreveu mais de 200 artigos técnicos, principalmente sobre JavaScript e seus frameworks.