Como enviar os dados do Conexão Saúde (Health Connect) para o meu próprio webhook em JSON?

O Life Dashboard para Android, um app de código aberto, lê o Conexão Saúde (Health Connect) conforme uma agenda e envia cada registro novo para as URLs que você informar, como um POST HTTPS com corpo em JSON. Cada payload traz os registros dos tipos que você ativou (34 ao todo, de passos e fases do sono a frequência cardíaca, peso e pressão arterial), cada um com um uuid estável e o app que o gravou, além de totais diários que contam uma caminhada uma vez só.

Com um segredo definido, toda requisição é assinada com HMAC-SHA256 em um cabeçalho X-Signature, e os payloads que não puderam ser entregues esperam em uma fila de saída no celular até a próxima sincronização. Qualquer receptor que aceite JSON serve, incluindo o n8n, o Node-RED, um script pequeno ou a stack Life Dashboard com Postgres e Grafana.

Por Owen Vogelaar, que mantém o Life Dashboard 8 min de leitura

Baixar o app para Android

Por que é preciso um app no celular

O Conexão Saúde não tem API web. Ele é um repositório no celular que os apps leem pelo Android, então alguma coisa no celular precisa ler os dados e mandá-los adiante. O app Life Dashboard faz isso e envia direto para a sua URL, sem serviço de nuvem nem conta do Google no caminho. Um único payload traz todas as fontes: o que o Samsung Health, o Google Health (Fitbit e Pixel Watch), o Garmin Connect, o Oura e o Withings gravam no Conexão Saúde, cada registro marcado com o app que o gravou. O caminho do Google pela nuvem, a Google Health API, exige um projeto no Google Cloud e um cliente OAuth, e só enxerga o que chega à sua conta do Google.

O que você precisa

  • Android 9 ou mais recente com o Conexão Saúde, e um app que grave nele, como o Samsung Health, o Garmin Connect ou o Google Health.
  • O Life Dashboard para Android, no Google Play por € 4,99 uma única vez, ou de graça pelo GitHub Releases, pelo Obtainium ou pelo F‑Droid. As opções de instalação mostram todos os caminhos.
  • Um servidor que aceite um POST com JSON por HTTPS, com limite de corpo de pelo menos 10 MB. HTTP sem criptografia na sua própria rede exige Permitir webhooks com HTTP sem criptografia em Mais > Avançado.

Envie o Conexão Saúde para o seu próprio servidor

  1. Na aba Saúde, toque em Adicionar destino (se ainda não houver nada configurado, Usar seu próprio servidor), cole a sua URL em URL do webhook e toque em Adicionar webhook. A aba Tempo de tela tem a sua própria lista.
  2. O endereço abre em uma página só dele. Opcional: adicione um cabeçalho Authorization ou uma chave de API em Cabeçalhos.
  3. Em Segredo de assinatura HMAC (opcional), toque em Gerar e coloque o mesmo valor no seu servidor. Cada endereço tem o seu próprio segredo, então um segundo servidor recebe o dele.
  4. Toque em Salvar no topo, abra de novo a linha do endereço na aba e toque em Enviar teste para conferir se o seu servidor aceita a requisição.
  5. Conceda as permissões do Conexão Saúde e toque em Sincronizar agora. Enviar histórico, em O que enviar, envia de 30 dias até 5 anos, ou Todo o histórico.
Um destino webhook no app para Android, com o segredo de assinatura HMAC e os cabeçalhos

Como é o POST

Toda requisição é um POST com Content-Type: application/json; charset=utf-8. Um payload de sincronização com passos e frequência cardíaca, resumido:

{
  "timestamp": "2026-10-04T07:15:02.481Z",
  "app_version": "1.23.0",
  "source": "health_connect",
  "sequence": 1842,
  "daily_totals": [
    {
      "date": "2026-10-04",
      "steps": 1204,
      "distance_meters": 911.6,
      "active_calories": 58.2,
      "total_calories": 702.9
    }
  ],
  "steps": [
    {
      "uuid": "eb52b2c4-e3f7-49f3-8f92-34ca86640305",
      "source": "com.fitbit.FitbitMobile",
      "count": 412,
      "start_time": "2026-10-04T06:00:00Z",
      "end_time": "2026-10-04T07:00:00Z"
    }
  ],
  "heart_rate": [
    {
      "uuid": "708a76cb-45d3-45ea-9f8b-26d6d55d2692#1791097080000",
      "source": "com.fitbit.FitbitMobile",
      "bpm": 61,
      "time": "2026-10-04T06:58:00Z"
    }
  ]
}

O source de um registro é o nome do pacote do app que o gravou. A referência do payload documenta todos os tipos, e um JSON Schema permite validar o que chega.

Confira a assinatura

Com um segredo definido, cada requisição traz X-Signature: sha256=<hex>, o HMAC-SHA256 do corpo bruto. Use o segredo como texto UTF-8, sem decodificá-lo, e calcule o HMAC sobre os bytes como chegaram, antes de interpretá-los. Compare em tempo constante e responda 401 quando não bater:

expected = "sha256=" + hmac.new(SECRET, body, hashlib.sha256).hexdigest()
valid = hmac.compare_digest(expected.encode(), presented.encode())

Para um proxy reverso que exige certificado de cliente, instale o certificado nas configurações do Android e escolha-o em Mais > Avançado > Certificado do cliente (mTLS).

Novas tentativas, fila de saída e exclusões

  • Novas tentativas. Qualquer 2xx conta como entregue. Um timeout, um erro de rede, um 408, um 429 ou um 5xx recebe 3 tentativas. Um 400, 413 ou 422 não é tentado de novo na hora: o app oferece esse payload outra vez a cada sincronização durante uma semana e depois o descarta, enquanto os payloads seguintes saem normalmente. O app espera no máximo 10 segundos, então responda primeiro e grave depois.
  • Fila de saída. Um payload que falhou fica no celular e sai primeiro na sincronização seguinte. A fila de saída guarda até 700 payloads do Conexão Saúde, uma semana de sincronizações a cada 15 minutos. Depois de um 401 ou 404, os payloads seguintes esperam até você corrigir a configuração e então chegam em ordem.
  • Duplicatas e payloads atrasados. Um registro pode chegar de novo depois de uma nova tentativa ou em um backfill (o envio de todo o histórico de uma vez), então grave os registros usando o uuid como chave. Um payload que esperou na fila de saída, ou um que o seu receptor recusou e recebe de novo mais tarde, pode chegar depois de um mais novo e ainda trazer registros que nenhum payload posterior repete: aplique esses registros também. Use sequence, que só aumenta, apenas para resolver conflitos: um registro que um payload de número maior citou em deleted_records continua excluído, e os daily_totals de uma data vêm do payload de número mais alto que trouxe essa data.
  • Exclusões. Um registro excluído no Conexão Saúde é citado em deleted_records no payload seguinte, com o type e o uuid. O acompanhamento começa quando o app sincroniza um tipo pela primeira vez, e um tipo pelo qual o celular não consegue responder em uma sincronização aparece em deletions_unavailable; acerte esses casos com um backfill.

Receptores que funcionam

  • A stack Life Dashboard. Imagens publicadas de um receptor que confere o X-Signature, Postgres e Grafana com seis dashboards, instalados com um único arquivo compose ou com um Helm chart. Escaneie o QR code de pareamento dela no app, ou aponte o app para http://<host>:8080/webhook/<label>. Veja a stack Life Dashboard.
  • n8n. Um nó Webhook com Raw Body ativado, uma verificação da assinatura e um nó Respond to Webhook que responde 204 ou 401. Conexão Saúde para o n8n traz o workflow inteiro, e a referência do payload tem os passos com um nó Crypto.
  • Node-RED. Um nó http in com Do not parse request body ativado (Node-RED 4.1 ou mais recente) entrega os bytes brutos para o HMAC.
  • Home Assistant. A integração Life Dashboard transforma o payload em sensores e estatísticas de longo prazo.
  • InfluxDB ou qualquer outra coisa. Não existe um receptor pronto para o InfluxDB, então escreva um script pequeno. A referência do payload tem um receptor em Python e um em Node.js para servir de ponto de partida.

Guarde no Postgres

Seja qual for o receptor do POST, o n8n ou um script, o padrão de armazenamento é o mesmo:

  • Faça upsert de cada registro pela chave dele no payload e pelo uuid, em uma coluna text. As amostras de frequência cardíaca e de temperatura da pele trazem um # e um horário depois do ID do registro, então isso não é um uuid do Postgres.
  • Guarde daily_totals como uma linha por data, substituída apenas por um payload com sequence maior: o total de hoje é um acumulado.
  • Exclua o que deleted_records citar, por type e uuid. Para um registro de frequência cardíaca ou de temperatura da pele, exclua todas as amostras cujo uuid comece com esse uuid e um #.

O receptor da stack Life Dashboard faz as três coisas, caso você prefira não construir isso, e devolve o resultado por uma API somente leitura. Com os dados no Postgres, um modelo que você escolher pode lê-los por um servidor MCP somente leitura: dados do Conexão Saúde via MCP trata do servidor da própria stack e de um para um Postgres seu.

O app para iPhone envia o mesmo payload

O Life Dashboard para iPhone envia os dados do Apple Health com as mesmas chaves, unidades e assinatura, e com "source": "healthkit_ios", então um único receptor atende os dois celulares. Ele envia o mesmo contador sequence, e a variabilidade da frequência cardíaca (VFC) dele é SDNN, enquanto o Android envia RMSSD, então mantenha as duas separadas. Está na App Store por € 6,99 uma única vez (US$ 5,99), sem assinatura. Compilar a partir do código-fonte com o Xcode não custa nada a mais se você já tem uma assinatura do Apple Developer Program. Veja como baixar o app.

Limites

  • Com várias URLs, um payload conta como entregue assim que uma delas o aceita, e as outras não o recebem de novo. A aba Logs mostra cada resultado.
  • Dados de mais de 30 dias antes de você dar acesso ao app pela primeira vez precisam da permissão de histórico do Conexão Saúde, que a página do backfill pede.

Life Dashboard

Instale o app, aponte para a sua URL e toque em Enviar teste. A referência do payload traz todos os campos e um receptor em Python e Node.js.

Disponível no Google Play

€ 4,99 uma única vez no Google Play: o jeito fácil, com atualizações automáticas, e ainda apoia o desenvolvimento.

Ou de graça, o mesmo app com a mesma chave de assinatura: APK no GitHub · Obtainium · F‑Droid

Baixar na App Store

€ 6,99 uma única vez na App Store, sem assinatura.

Compilar com o Xcode

Baixar o app para Android Referência do payload

Os apps de código aberto que este guia usa, para Android e iPhone. Sem conta e sem nuvem. Mais sobre o app para Android e para iPhone.

Perguntas frequentes

Posso usar a Google Health API no lugar?

Para os dados que estão na sua conta do Google, como os do Fitbit e do Pixel Watch, o Google oferece na nuvem a Google Health API, que exige um projeto no Google Cloud e um cliente OAuth. O Conexão Saúde em si não tem API web. O app Life Dashboard o lê no celular, então os dados do Samsung Health, do Garmin Connect, do Oura e do Withings chegam no mesmo payload, e nada passa por uma conta do Google no caminho.

Dá para ver um payload real antes de escrever um receptor?

Sim. Prévia do payload, em O que enviar na aba Saúde, mostra o que a próxima sincronização enviaria, e Mais > Exportar dados compartilha isso como CSV ou JSON.

Ele também envia o tempo de tela?

Sim, como um payload separado com "source": "screen_time", com os minutos por app por dia dos últimos 7 dias. Veja tempo de tela por app.

Como evito contar os passos duas vezes?

Use daily_totals para passos, distância e calorias. Somar os registros brutos conta uma caminhada uma vez para cada dispositivo que a registrou.

Existe exportação em CSV?

Sim. Mais > Exportar dados, na aba Saúde, compartilha o que a próxima sincronização enviaria como CSV ou JSON. Para o seu servidor, os dados de saúde saem do app em JSON, e o seu receptor os guarda no formato que quiser.