# Bac à sable

Simuler des messages reçus et des changements de statut, sans WhatsApp.

## Simuler un message reçu d’un client (clé sandbox uniquement). Déclenche le webhook `message.received`.

`POST /sandbox/simulate/inbound-message`

Authentification : clé API, ou session de la console avec X-Environment-Id · portée : messages:send

Corps (JSON) :

| Champ | Type | | Description |
|---|---|---|---|
| `phoneNumberId` | string | requis | Identifiant d'un numéro de l'environnement sandbox. |
| `from` | string | requis | Numéro de l'expéditeur simulé, format international avec « + ». |
| `text` | string | requis | Texte du message simulé. |

```bash
curl -X POST "$INBOX_API/sandbox/simulate/inbound-message" \
  -H "Authorization: Bearer $INBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumberId": "4d8e654e-d744-4bf3-8211-9ceffcccfe87",
    "from": "+237611111111",
    "text": "Bonjour, je voudrais déplacer mon rendez-vous"
  }'
```

Réponse 201 :

```json
{
  "messageId": "3f3baf5a-f93e-42e8-8263-ce62dc4aadd6",
  "from": "237611111111",
  "status": "received",
  "simulated": true
}
```

## Faire avancer le statut d’un message sortant (clé sandbox uniquement). Déclenche le webhook correspondant.

`POST /sandbox/simulate/message-status`

Authentification : clé API, ou session de la console avec X-Environment-Id · portée : messages:send

Corps (JSON) :

| Champ | Type | | Description |
|---|---|---|---|
| `messageId` | string | requis | Identifiant d'un message sortant de l'environnement sandbox. |
| `status` | string | requis | Nouveau statut : sent, delivered, read ou failed. Un statut ne recule jamais, comme chez Meta. |

```bash
curl -X POST "$INBOX_API/sandbox/simulate/message-status" \
  -H "Authorization: Bearer $INBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messageId": "d5ad1e3e-6ab9-4f7f-8e4e-b17104a7bd00",
    "status": "delivered"
  }'
```

Réponse 200 :

```json
{
  "messageId": "d5ad1e3e-6ab9-4f7f-8e4e-b17104a7bd00",
  "status": "delivered",
  "simulated": true
}
```