Automação

Registrar um gasto no momento em que ele acontece é o que separa um controle financeiro que funciona de um que você abandona em três semanas. Abrir o navegador, entrar no painel e preencher um formulário é atrito suficiente para você deixar para depois — e depois você não lembra.

O sistema aceita lançamentos por webhook: qualquer coisa capaz de fazer um POST com JSON consegue criar uma movimentação. No iPhone isso vira um atalho na tela de início ou um comando de voz.

É para cá que a automação envia. A senha mestre faz parte do endereço — é o que autentica a chamada, já que um atalho de celular não tem onde guardar cabeçalhos.

Este é o atalho que eu uso. Ele pergunta a descrição, o valor, a direção e o meio de pagamento, e envia para o sistema.

1. Abra este link no iPhone e toque em Adicionar Atalho:
   icloud.com/shortcuts/441b1631b7cc4e03bf0666cac68d1daa
2. Troque a URL — este é o passo que faz o atalho ser seu. No app Atalhos, toque no atalho → ícone de edição → encontre a ação Obter conteúdo de URL. O endereço que está lá aponta para a minha instância e não vai funcionar para você. Apague e cole a sua URL, copiada da seção acima.
3. Confira que o método é POST, que o Corpo da Solicitação está como JSON, e que os campos batem com a tabela mais abaixo.
4. Teste. Rode o atalho, lance um valor qualquer, e confira se ele apareceu em Finanças. Se apareceu, apague o lançamento de teste e está pronto.
5. Opcional: segure o atalho → Adicionar à Tela de Início, ou chame por voz com "E aí Siri, [nome do atalho]".

O formato de atalho do iOS não é portável, então não há um arquivo pronto. Mas o endpoint não se importa com quem chama: qualquer coisa que faça um POST com este JSON funciona. No Android, apps como Tasker, HTTP Shortcuts ou Automate dão conta; no computador, um curl resolve.

Sobre o formato: ele parece estranho de propósito. É o mesmo payload que a API do Notion aceita para criar uma página, porque o sistema nasceu migrando de lá e a automação existente precisou continuar funcionando trocando só a URL. Os campos parent e icon são ignorados — estão aí só para o payload não precisar mudar.

POST  <sua URL, a mesma da seção acima>
Content-Type: application/json

{
  "parent": { "database_id": "ignorado" },
  "properties": {
    "Name":  { "title": [{ "text": { "content": "Mercado" } }] },
    "Valor": { "number": 42.5 },
    "Tipo":  { "multi_select": [{ "name": "Saida" }, { "name": "Pix" }] },
    "Date":  { "date": { "start": "2026-09-21" } }
  }
}

Respostas: {"ok":true,"id":"…"} em caso de sucesso. 401 é senha errada na URL; 400 com invalid_tipo, invalid_valor, invalid_date ou invalid_name aponta qual campo está fora do contrato.