# Changelog

## 2026-11-20 — Planos por ligações activas e o erro de limite de ligações


Os planos diferem agora apenas no número de **ligações activas** que uma empresa serve: Grátis até 10, depois 100, 250 e 500, com todas as funcionalidades e membros da equipa ilimitados em todos. Acima de 500 há um plano à medida. As ligações pendentes, suspensas, desligadas e retiradas não contam, e a factura mensal usa o número de ligações activas no dia em que é emitida.

Nenhum plano cobra ligações acima do limite. Em vez disso, quando a empresa está no limite, as duas acções que tornam uma ligação activa recusam a seguinte:

- `POST /connections/{id}/activate` (concluir uma instalação);
- `POST /connections/{id}/reconnect` (religar uma ligação suspensa ou desligada).

Ambas respondem `409` com `error_code` `subscription.connection_limit_reached` e os params `max`, `plan_code` e `next_plan_code` (`custom` no plano de 500). Criar pedidos e aprovar pedidos de serviço não muda: a ligação fica pendente.

### O que mudar na sua integração

Se activa ou religa ligações pela API, trate o novo `409`: mostre a mensagem e indique à empresa as definições da subscrição para mudar de plano. Veja [Erros da API](/docs/api/errors) e o artigo de ajuda sobre planos e limites de clientes.


## 2026-11-19 — Endpoints públicos de planos, conectores e pedidos de contacto


A API pública passou a disponibilizar três novos endpoints sem autenticação para integração directa com o site público:

- `GET $PUBLIC_API/plans`: devolve os planos publicados, ordenados por `display_order`, com limites, preços e capacidades.
- `GET $PUBLIC_API/connectors`: lista os drivers de conectores activos (pagamentos, mensagens, contadores) e respectivas capacidades.
- `POST $PUBLIC_API/contact-requests`: recebe pedidos de contacto com validação e limite de pedidos por IP e email.


## 2026-11-19 — Cabeçalhos normalizados de limite de pedidos (RateLimit-*)


Onde a limitação de taxa está activa, as respostas da API passam a incluir `RateLimit-Limit`, `RateLimit-Remaining` e `RateLimit-Reset`, além de `Retry-After` nas respostas `429 Too Many Requests`.


## 2026-11-19 — Request-Id em todas as respostas e idempotência nas criações


Todas as respostas da API incluem agora o cabeçalho `Request-Id`, e os corpos de erro `application/problem+json` incluem o campo correspondente `request_id` juntamente com `type` a apontar para a referência do código de erro.

O suporte a `Idempotency-Key` (com retenção de 24 horas e resposta `409` em caso de reutilização com corpo diferente) foi alargado às rotas de criação das APIs de negócio e de morador.


## 2026-11-19 — Conector de pagamentos simulado e avanço de sandbox


As novas contas criadas a partir da página de sandbox (`?next=sandbox`) entram directamente num ambiente sandbox pré-populado com clientes, ligações, contadores, leituras, rede e facturas de exemplo.

Foi também adicionado um **conector de pagamentos simulado** disponível apenas em ambientes sandbox, com valores mágicos nos dois últimos cêntimos do montante (`00` confirma, `02` falha, `05` expira e `09` fica pendente até executar o comando `sandbox advance` na CLI).


## 2026-11-19 — Cabeçalhos Standard Webhooks e segredos whsec_


As entregas de webhooks passaram a seguir a especificação **Standard Webhooks**. Os cabeçalhos proprietários anteriores foram substituídos por `webhook-id`, `webhook-timestamp` e `webhook-signature`, e os segredos de assinatura passaram a usar o prefixo `whsec_`. O cabeçalho `User-Agent` reflecte agora o nome curto configurado da marca.

### O que alterar na sua integração

Actualize o código de verificação para ler os novos cabeçalhos e calcular o HMAC-SHA256 sobre `"{webhook-id}.{webhook-timestamp}.{body}"` (ou utilize qualquer biblioteca Standard Webhooks).

#### Antes

```javascript
const sig = req.headers['x-signature']
const eventId = req.headers['x-event-id']
const valid = verifyHmac(secret, req.rawBody, sig)
```

#### Depois

```javascript
import { Webhook } from 'standardwebhooks'

const wh = new Webhook(process.env.WEBHOOK_SECRET) // whsec_...
const payload = wh.verify(req.rawBody, {
  'webhook-id': req.headers['webhook-id'],
  'webhook-timestamp': req.headers['webhook-timestamp'],
  'webhook-signature': req.headers['webhook-signature'],
})
```


