Atlas BFF – Dashboard de Marketing

API disponível em /api/v1/. Abaixo, tudo o que o frontend pode consumir.

Clientes

• GET /api/v1/clients – Lista clientes/contas.
  Tabela clientes. Retorna array de objetos com pelo menos id e name. Se a tabela não existir, retorna [].

Insights de mídia

• GET /api/v1/insights – Agregação de insights.
  Query: platform=meta|google|both, from=YYYY-MM-DD, to=YYYY-MM-DD. Hoje só Meta está implementado.
• GET /api/v1/insights/meta – Insights Meta diários.
  Query: from, to. Retorna [{ date, spend, impressions, clicks, campaign, account_id }].
• GET /api/v1/creatives/[campaign_id] – Criativos por campanha.

WhatsApp

• GET /api/v1/whatsapp – Estrutura de grupos e mensagens (mock/estrutura para front).

Operacional (ekyte_data)

• GET /api/v1/operational/workspaces – Lista de workspaces distintos para popular o dropdown. Retorna { workspaces: string[] }. Use para mostrar "Todos os workspaces" + todas as opções.
• GET /api/v1/operational/kpis – KPIs agregados.
  Query opcional: workspace, from, to. Retorna { totalTasks }.
• GET /api/v1/operational/charts – Série temporal para gráficos.
  Query opcional: workspace, from, to. Retorna [{ date: "YYYY-MM-DD", total: number }], pronto para Recharts.
• GET /api/v1/operational/tasks – Lista paginada de tarefas/registros.
  Query opcional: workspace, from, to, page (default 1), limit (default 20). Retorna { data, page, limit, total }.