# Journal des changements

> L'historique des évolutions de l'API et de la documentation.

## 12 novembre 2026 — Console : connexions, messages, webhooks

- La console propose les pages **Connexions**, **Messages** et **Webhooks**, avec un sélecteur d'environnement (sandbox / production).
- Les routes à clé API acceptent **aussi la session de la console**, avec l'en-tête `X-Environment-Id` (voir [Authentification](/docs/authentication)).

## 12 novembre 2026 — Limite de numéros par entreprise

- Les plans limitent désormais le nombre de **numéros WhatsApp par entreprise connectée** (production seulement) : `402 plan_limit_reached` au-delà. Le contrôle a lieu **avant** l'échange du code d'inscription de Meta, qui n'est donc pas consommé par un refus.
- `GET /billing/overview` expose `plan.maxNumbersPerBusiness` (`null` = illimité).

## 12 novembre 2026 — API v1

Première version de l'API.

**Comptes et accès**
- Inscription, connexion, sessions révocables ; mots de passe hachés avec sel.
- Applications avec deux environnements, **sandbox** et **production**, strictement séparés.
- Clés API `pk_test_…` / `pk_live_…`, avec **portées**, révocation et date de dernière utilisation ; secret affiché une seule fois.

**Connexion WhatsApp**
- Entreprises connectées, finalisation de l'inscription intégrée de Meta, comptes et numéros, **mode coexistence**.
- Jetons Meta chiffrés, jamais renvoyés par l'API.
- Un compte WhatsApp ne peut être connecté qu'une fois sur toute la plateforme.

**Messages**
- Envoi asynchrone et **idempotent** de texte, images, vidéos, audios, documents, localisation et templates.
- Règle des 24 heures appliquée, reprises automatiques, régulation du débit par numéro.
- Statuts qui ne reculent jamais ; historique paginé.

**Templates**
- Création, liste, suppression, synchronisation ; refus immédiat d'un template non approuvé ; événement `template.status_updated`.

**Webhooks**
- Destinations par environnement, signature horodatée (HMAC-SHA256), 8 tentatives, historique de chaque tentative, rejeu, rotation du secret, désactivation automatique.
- Protection contre les destinations internes.

**Usage et facturation**
- Consommation par jour, catégorie, pays ou numéro ; coût Meta **estimé** et frais Bref Point Inbox sur des lignes séparées.
- Quotas et limites de plan en production ; le sandbox n'est ni limité ni facturé.

**Observabilité**
- Format d'erreur unique avec `requestId` ; journal des appels sans contenu ; maintenance planifiée (purge selon la rétention, reprise des envois perdus).
- **Simulateur de bac à sable** pour tester ses webhooks sans WhatsApp.

**À venir et limites connues**
- La validation contre la plateforme Meta réelle (inscription intégrée, envoi, templates) est en cours.
- Pas encore de téléversement ni de téléchargement de médias par l'API.
- Pas de SDK officiels : générez un client depuis la [spécification OpenAPI](/openapi.json).
- Le paiement en ligne des abonnements n'est pas encore disponible.
