---
title: "O que é a Heartbeat API? | Seahawk"
description: "A Heartbeat API mantém o navegador e o servidor em contato enquanto alguém trabalha no painel do WordPress."
url: https://seahawkmedia.com/pt/glossario/heartbeat-api/
language: pt
---

[Home](https://seahawkmedia.com/) / [Glossário](https://seahawkmedia.com/pt/glossario/) / [WordPress](https://seahawkmedia.com/pt/glossario/wordpress/) /Heartbeat API

# Heartbeat API

May 21, 2025 Updated June 2, 2025 6 min read

Read in [English](https://seahawkmedia.com/glossary/heartbeat-api/) [العربية](https://seahawkmedia.com/ar/%D9%85%D8%B3%D8%B1%D8%AF-%D8%A7%D9%84%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA/heartbeat-api/) [Dansk](https://seahawkmedia.com/da/ordliste/heartbeat-api/) [Deutsch](https://seahawkmedia.com/de/glossar/heartbeat-api/) [Español](https://seahawkmedia.com/es/glosario/api-heartbeat/) [Français](https://seahawkmedia.com/fr/glossaire/api-heartbeat-wordpress/) [Italiano](https://seahawkmedia.com/it/glossario/api-heartbeat/) [日本語](https://seahawkmedia.com/ja/%E7%94%A8%E8%AA%9E%E9%9B%86/%E3%83%8F%E3%83%BC%E3%83%88%E3%83%93%E3%83%BC%E3%83%88api-wordpress/) [한국어](https://seahawkmedia.com/ko/%EC%9A%A9%EC%96%B4%EC%A7%91/heartbeat-api/) [Nederlands](https://seahawkmedia.com/nl/woordenlijst/heartbeat-api/) [Svenska](https://seahawkmedia.com/sv/ordlista/heartbeat-api-wordpress/)

Glossário: WordPressA Heartbeat API mantém o navegador e o servidor em contato enquanto alguém trabalha no painel do WordPress. Ela viabiliza o bloqueio de posts, as verificações de login e as atualizações ao vivo do painel.

Some links on this page are affiliate links. If you buy through them, Seahawk may earn a commission at no extra cost to you. [Affiliate disclosure](https://seahawkmedia.com/affiliate-disclosure/)

A API Heartbeat do WordPress funciona como o pulso do seu site: ela envia um pequeno sinal de "estou online" do seu navegador para o servidor a cada poucos segundos. Esse ciclo automático de requisição/resposta sincroniza os dados, posts e painel de controle do seu site, fornecendo atualizações em tempo real e funcionalidades essenciais para editores, plugins e administradores.

Neste artigo do glossário, você aprenderá exatamente como funciona a API Heartbeat do WordPress, por que ela é importante e como monitorá-la, controlá-la ou desativá-la caso ela cause alta demanda de CPU em sua hospedagem.

## Por que a API Heartbeat do WordPress é importante?

A API Heartbeat é a base de muitas das funcionalidades mais amigáveis ​​do WordPress, mantendo o navegador e o servidor em constante comunicação. Sem ela, você perderia recursos como salvamento automático, bloqueio colaborativo de posts e atualizações em tempo real do painel de controle.

- **Protege seu editor de posts:** Ao escrever ou editar um post no [editor do WordPress](https://seahawkmedia.com/pt/glossario/editor-no-wordpress/), o Heartbeat salva automaticamente suas alterações a cada 15 a 60 segundos, para que você nunca perca seu trabalho caso seu navegador ou conexão caia.

- **Bloqueio de usuários e notificações:** Se dois autores tentarem editar a mesma publicação simultaneamente, o Heartbeat envia notificações ("Seu membro da equipe está editando esta publicação") e aplica um mecanismo de bloqueio para evitar conflitos de conteúdo.

- **Widgets de painel de controle em tempo real:** Plugins de comércio eletrônico como [o WooCommerce](https://automattic.pxf.io/c/2010090/1946431/22744) usam a API para atualizar os dados de vendas no seu painel de controle sem a necessidade de recarregar a página inteira.

- **Alertas de tempo limite da sessão:** O Heartbeat pode alertá-lo se sua sessão de login expirou, solicitando que você faça login novamente antes de perder as edições não salvas.

## Como funciona a API Heartbeat: o básico

O Heartbeat funciona por meio de pequenas chamadas AJAX ao seu servidor, permitindo que o WordPress coordene os dados sem a necessidade de recarregar completamente a página. Esses pings frequentes otimizam a funcionalidade e [a segurança](https://seahawkmedia.com/pt/seguranca/guia-de-seguranca-do-wordpress/), garantindo que os editores vejam informações atualizadas e que as sessões permaneçam válidas.

- **O navegador envia admin-ajax.php Solicitar:** A cada pulso do Heartbeat, seu navegador envia uma pequena chamada AJAX para /wp-admin/admin-ajax.php.

- **Processamento da solicitação pelo servidor:** O WordPress executa quaisquer funções interceptadas, recupera novos dados e os envia de volta como uma resposta JSON.

- **O navegador recebe e age:** os eventos JavaScript do seu navegador capturam a resposta, atualizam a interface do usuário (por exemplo, salvamento automático, atualização de widgets) e preparam o sistema para o próximo intervalo.

_js_

_// Exemplo: Escutar o próximo pulso de pulsação no frontend
_ jQuery(document).on('heartbeat-tick', function(event, data) {
console.log('Resposta de pulsação recebida:', data);
});

- **Intervalo padrão**: Tela do editor (15 segundos) e Painel de controle e outras páginas administrativas (60 segundos).

## Hooks principais e exemplos de código

Os desenvolvedores aproveitam os recursos integrados do Heartbeat para adicionar funcionalidades personalizadas ou ajustar seu comportamento. Você pode adaptar a API para trocar os dados necessários utilizando esses eventos em JavaScript e PHP.

### Ganchos JavaScript

Abaixo estão dois principais hooks de JS que você pode usar para controle do front-end:

- **batimento cardíaco-enviar:** Anexe dados personalizados antes de cada solicitação.

- **batimento cardíaco-tique:** Aja de acordo com os dados recebidos após a conclusão da solicitação.

_js_

_// Anexar informações extras a cada evento heartbeat-send
_ jQuery(document).on('heartbeat-send', function(e, data) {
data.customValue = jQuery('#my-field').val();
});

### Ganchos PHP

No lado do servidor, esses hooks permitem modificar ou reagir às chamadas Heartbeat:

- **enviar batimento cardíaco:** Modifique os dados retornados pelo servidor.

- **batimento cardíaco recebido:** Execute uma ação quando o servidor receber um tick.

_php_

add_filter('heartbeat_send', 'my_heartbeat_send', 10, 2);
function my_heartbeat_send($response, $screen_id) {
if ($screen_id === 'post') {
$response['server_time'] = time();
}
return $response;
}

## Casos de uso comuns da API Heartbeat do WordPress

Os recursos em tempo real do Heartbeat são essenciais para muitas funcionalidades do WordPress. A sincronização entre servidor e navegador garante que painéis e editores permaneçam atualizados sem a necessidade de cliques manuais ou recarregamentos completos.

- **Salvamento automático e revisões:** o Heartbeat funciona perfeitamente no editor de pós-produção, criando backups a cada 15 segundos para que você possa recuperar conteúdo perdido.

- **Dados de vendas em tempo real:** os desenvolvedores de plugins de comércio eletrônico usam o Heartbeat para obter estatísticas de vendas atualizadas e exibi-las instantaneamente.

- **Avisos de expiração de sessão:** Quando sua sessão estiver perto de expirar, o Heartbeat exibirá um aviso: “Clique aqui para permanecer conectado”.

- **Alertas de Colaboração:** Você verá quem está editando qual postagem em sites com múltiplos autores, evitando conflitos de sobrescrita.

## Considerações sobre desempenho e alto uso da CPU

Embora indispensável para atualizações em tempo real, o Heartbeat pode consumir muitos recursos da CPU em sites com alto tráfego. Cada requisição AJAX frequente para admin-ajax.php utiliza tempo de processamento e memória, o que pode sobrecarregar contas de hospedagem compartilhada.

- **Carga elevada da CPU:** Chamadas frequentes à API Heartbeat podem aumentar significativamente o uso da CPU do seu servidor, especialmente em planos de hospedagem compartilhada, pois cada chamada requer que o PHP processe uma solicitação [AJAX](https://seahawkmedia.com/pt/glossario/ajax-wordpress/)

- **Resposta mais lenta da página:** À medida que o servidor processa mais dessas solicitações, o carregamento das páginas do front-end e as interações com o painel de administração podem ficar visivelmente mais lentos.

- **Risco de suspensão:** Se o volume de admin-ajax.php Se o número de solicitações sobrecarregar seu site além dos limites de CPU do seu provedor de hospedagem, sua conta poderá ser limitada ou suspensa até que o uso retorne a níveis aceitáveis.

## Como monitorar o tráfego de batimentos cardíacos?

Observar a atividade do servidor pode ajudar a diagnosticar gargalos de desempenho precocemente. Use logs do servidor e ferramentas do lado do cliente para monitorar a frequência de requisições e os tempos de resposta.

- **Registros e estatísticas do servidor:** Verifique os picos de uso da CPU no cPanel ou no painel de controle da sua hospedagem, concentrando-se em: entradas em /wp-admin/admin-ajax.php.

- **Ferramentas de desenvolvedor do navegador:** No Chrome ou Firefox, acesse as Ferramentas de desenvolvedor → guia Rede → filtre por “admin-ajax.php” → observe a frequência de requisições e o tempo de resposta.

- **Soluções com plugins:** Instale plugins de desempenho (por exemplo, Query Monitor) para visualizar chamadas de Heartbeat, uso de memória e tempo de execução diretamente no painel de administração.

## Controlando e limitando a API Heartbeat

Se o ritmo padrão do Heartbeat sobrecarregar seu servidor, você pode reduzi-lo ou desativá-lo seletivamente. Isso permite equilibrar recursos em tempo real com desempenho ideal e controle de recursos.

- **Via plugin:** Instale o Heartbeat Control ou use as configurações integradas do [WP Rocket](https://wp-rocket.me/) para ajustar os intervalos ou desativar o Heartbeat em telas específicas

- **Via código**

_php_

_// Reduzir a frequência do Heartbeat para uma vez a cada 60 segundos
_ add_filter('heartbeat_settings', function($settings) {
$settings['interval'] = 60;
return $settings;
});
_// Desativar completamente no front-end
_ add_action('init', function() {
if (!is_admin()) wp_deregister_script('heartbeat');
}, 1);

## Riscos de desativar a API Heartbeat

Desativar o Heartbeat pode aliviar a carga da CPU, mas isso tem o custo de várias funcionalidades importantes. Antes de desativá-lo em todo o site, entenda as vantagens e desvantagens em termos de experiência do usuário e segurança.

- Sem salvamento automático no Editor Clássico → é necessário clicar manualmente em “Salvar rascunho” para cada alteração.

- Possibilidade de perda de dados caso a conexão com a Internet seja interrompida durante a publicação/atualização.

- Os widgets e plugins do painel que dependem do Heartbeat deixarão de funcionar, reduzindo os relatórios e recursos em tempo real.

## Melhores práticas e resolução de problemas

Em vez de desativar completamente o Heartbeat, é mais sensato ajustar seu comportamento. Ao limitar ou registrar seletivamente as solicitações do Heartbeat, você preserva seus benefícios e mantém a integridade do servidor.

- **Controle, não desative**: em vez de desativá-lo completamente, aumente o intervalo de 15 para 30 ou 60 segundos.

- **Teste em ambiente de homologação**: Primeiro, aplique alterações de intervalo ou cancelamento de registro em um ambiente de homologação para detectar problemas.

- **Combine com o armazenamento em cache**: Utilize o cache de objetos ou páginas para compensar qualquer carga extra no servidor causada pelo Heartbeat.

- **Ativar registro de logs**: Conecte-se batimento cardíaco recebido Para registrar os pulsos de clock e depurar comportamentos inesperados.

## Considerações finais

A API Heartbeat do WordPress mantém seu site ativo e sincronizado. Ela salva rascunhos automaticamente, exibe dados em tempo real e evita conflitos de edição. Muitas requisições podem aumentar o uso da CPU. Você pode diminuir a velocidade ou desativá-la quando necessário. Teste as alterações em um ambiente de teste primeiro. Com o equilíbrio certo, o Heartbeat aumenta a funcionalidade sem prejudicar o desempenho.

Para obter mais termos do WordPress e explicações detalhadas, explore o Glossário da Seahawk Media.

WP Services

## WordPress services at revolutionary pricing.

Productized WordPress services, from builds to care, delivered by Seahawk and tracked in one app. For the WordPress lovers.

[Go to WP Services](https://wpservices.com/) [Free homepage rebuild](https://seahawkmedia.com/free-homepage-rebuild/)
