**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Campagnes de messages

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

Campagnes de messages (WhatsApp / SMS / Email et cascades de remplacement). Le brouillon (état INIT) est entièrement modifiable ; l’ENVOI est une action DISTINCTE, à risque plus élevé, protégée par `messages:send` (envoi massif réel : coût SMS, risque de blocage WhatsApp, RGPD). Prévisualisez l’audience avec GET /{id}/targets avant l’envoi. Autorisations : `messages:read` (inclut aussi numéros WhatsApp et configurations de messagerie), `messages:write` (inclut aussi téléversements), `messages:send`.

## Opérations

## GET /campaigns

Lister les campagnes

`list_campaigns`

Autorisation requise : `messages:read`. Liste les campagnes de l’organisation avec leurs statistiques de livraison. Résultats paginés. Filtrez avec `?state` (INIT|VALIDATE|FINISHED) ou `?type`.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "INIT",
      "VALIDATE",
      "FINISHED"
    ]
  }
}
```

```json
{
  "name": "type",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Campaign"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /campaigns

Créer une campagne (brouillon)

`create_campaign`

Autorisation requise : `messages:write`. Crée une campagne à l’état INIT (brouillon). N’effectue PAS l’envoi — utilisez POST /{id}/send. Le ciblage est exclusif (allContact | staredOnly | categories).

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_a64ca28f296f1c41c444"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## GET /campaigns/sms/available

Consulter le quota SMS restant

`get_sms_quota`

Autorisation requise : `messages:read`. Renvoie le nombre de crédits SMS restants de l’organisation (utile avant l’envoi d’une campagne SMS).

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "total": {
                "type": "integer"
              }
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /campaigns/{id}

Obtenir une campagne

`get_campaign`

Autorisation requise : `messages:read`. Campagne complète, avec ses statistiques de livraison.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /campaigns/{id}

Modifier une campagne en brouillon

`update_campaign`

Droit requis : `messages:write`. Modifier uniquement un brouillon INIT admis. Un journal privé durable et une protection de campagne commune précèdent les changements ; la réponse contient commandId. Lire get_campaign_update_receipt avec les mêmes campagne, commande et principal API après une réponse perdue ou incertaine. COMPLETED avec queueAdmission=NOT_STARTED acquitte uniquement la modification du brouillon ; aucun envoi. Ce PATCH historique n’a pas de clé d’idempotence client : ne jamais le répéter pour contourner une commande non résolue. Un état INIT actuel ne prouve pas qu’une commande antérieure est restée sans effet. Une modification prouvée survit à l’échec accessoire de lecture des statistiques. Les effets en attente ou incertains conservent la protection. Celle-ci ne sérialise pas les éditeurs internes. Pour revoir et envoyer une audience CRM enregistrée, utiliser preview_saved_campaign_dispatch et dispatch_saved_campaign_audience.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_eb7a1a258ea96fc9aa42"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "commandId"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "CAMPAIGN_NOT_EDITABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CAMPAIGN_NOT_EDITABLE"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Mutation historique incertaine. Conserver commandId et consulter son reçu dédié sans répéter l’effet.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## DELETE /campaigns/{id}

Supprimer une campagne

`delete_campaign`

Autorisation requise : `messages:write`. Supprime logiquement la campagne.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /campaigns/{id}/duplicate

Dupliquer une campagne

`duplicate_campaign`

Autorisation requise : `messages:write`. Duplique la campagne sous forme de nouveau brouillon INIT (nouvel identifiant, scheduledAt effacé, statistiques réinitialisées ; médias partagés par référence).

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## GET /campaigns/{id}/targets

Prévisualiser le nombre de destinataires

`preview_campaign_targets`

Autorisation requise : `messages:read`. Compte les destinataires correspondant au ciblage enregistré de la campagne, SANS créer de livraison. Renvoie 0 si aucun ciblage n’est défini.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/CampaignTargets"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /campaigns/{id}/send

Envoyer la campagne (envoi massif réel)

`send_campaign`

Required scope: `messages:send`. Real mass sending requires the user's explicit request for this campaign and audience. For legacy stored targeting, preview_campaign_targets is passive; saved CRM targeting instead uses preview_saved_campaign_dispatch and dispatch_saved_campaign_audience. Stored targeting, delivery references and hosted media are admitted before a durable private journal and the shared campaign fence. Native INIT-to-VALIDATE transition and positively acknowledged initial queue admission produce commandId, state and targets; neither queued nor finished proves recipient delivery. This can incur channel costs. Missing targeting returns CAMPAIGN_TARGETING_REQUIRED; invalid references, changed snapshots and existing send states are refused. There is no caller idempotency key on this legacy POST. After an uncertain or missing response, read get_campaign_send_receipt using the same campaign, command and principal; never send again, change UUID, duplicate the campaign or infer non-execution from INIT. DISPATCH_RESULT_UNKNOWN retains uncertainty and protections. An observed complete queue alone does not repair an unknown journal or acknowledgement. The external fence does not serialize internal senders. When the active SMS platform handles a primary or fallback SMS, this ordinary-audience command also requires messages:read, contacts:read and smsEstimateHash from preview_campaign_sms_usage. Ask the user to confirm the estimated maximum Unisoft units and the external-funded record count. Imported or annual-event SMS audiences require review in Unisoft.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:send",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Corps de la requête

```json
{
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "smsEstimateHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "Exact sms.estimateHash from preview_campaign_sms_usage when the SMS platform is active."
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Admission initiale en file native acquittée ; aucune preuve de livraison aux destinataires.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "commandId",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "state",
              "targets"
            ],
            "properties": {
              "state": {
                "type": "string",
                "enum": [
                  "VALIDATE"
                ]
              },
              "targets": {
                "type": "integer",
                "minimum": 0,
                "maximum": 2000
              }
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "CAMPAIGN_ALREADY_SENT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CAMPAIGN_ALREADY_SENT"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Mutation historique incertaine. Conserver commandId et consulter son reçu dédié sans répéter l’effet.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-conditional-scopes": [
    {
      "condition": "The active SMS platform handles this campaign’s primary or fallback SMS channel.",
      "scopes": [
        "messages:read",
        "contacts:read"
      ],
      "allRequired": true
    }
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "messages:send",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": false,
    "warn": true
  }
}
```

## POST /campaigns/{id}/test

Envoyer un test à un contact (brouillon uniquement)

`test_campaign`

Autorisation requise : `messages:send`. Envoie un seul message de test de la campagne à un contact (envoi réel à cette personne ; exclu des statistiques ; ignore la liste de désinscription). Autorisé UNIQUEMENT tant que la campagne est en brouillon (state INIT) — sinon renvoie 409. Corps : {contactId}.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:send",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "contactId": {
            "type": "string",
            "description": "Contact auquel envoyer le message de test."
          }
        },
        "required": [
          "contactId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "CAMPAIGN_NOT_DRAFT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CAMPAIGN_NOT_DRAFT"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:send",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": false,
    "warn": true
  }
}
```

## GET /campaigns/sms/wallet

Read the Unisoft SMS unit balance

`get_sms_wallet`

Requires messages:read. Reports whether the SMS platform is enabled and whether the organisation’s wallet has migrated. A migrated wallet reports committed available, reserved, consumed and granted Unisoft units. External credits are separate. Campaign-restricted keys cannot use this operation.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Read-only SMS observation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              },
              "wallet": {
                "type": "object",
                "properties": {
                  "migrated": {
                    "type": "boolean"
                  },
                  "available": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "reserved": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "consumed": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "granted": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "revision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "migrated"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "enabled",
              "wallet"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Invalid filter or request.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Missing scope or restricted organisation access.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /campaigns/sms/journal

Read SMS dispatch and unit consumption history

`get_sms_journal`

Requires messages:read and contacts:read in the same organisation and whole-organisation contact access. Lists new-platform SMS dispatch records with their funding, segments, unit consumption and delivery evidence. Each page has up to 25 rows. A provider acceptance is distinct from delivery. An uncertain outcome is never automatically retried. The response omits phone numbers, message content, provider identifiers and purchase costs. Date-only bounds are inclusive in UTC; an exact UTC to instant is exclusive.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "page",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100000
  }
}
```

```json
{
  "name": "funding",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "unisoft",
      "external"
    ]
  }
}
```

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PREPARED",
      "SENDING",
      "ACCEPTED",
      "REJECTED",
      "BLOCKED",
      "UNCERTAIN",
      "CANCELED",
      "SIMULATED"
    ]
  }
}
```

```json
{
  "name": "number",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^\\+[1-9][0-9]{1,14}$"
  }
}
```

```json
{
  "name": "campaign",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "contact",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "country",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[A-Z]{2}$"
  }
}
```

```json
{
  "name": "source",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "campaign",
      "reminder",
      "pledge",
      "automatic"
    ]
  }
}
```

```json
{
  "name": "from",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "to",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Read-only SMS observation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "page": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "pageSize": {
                "type": "integer",
                "enum": [
                  25
                ]
              },
              "unitsConsumed": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "entries": {
                "type": "array",
                "maxItems": 25,
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "country": {
                      "type": "string",
                      "nullable": true
                    },
                    "source": {
                      "type": "string",
                      "enum": [
                        "campaign",
                        "reminder",
                        "pledge",
                        "automatic"
                      ]
                    },
                    "campaign": {
                      "type": "string",
                      "nullable": true
                    },
                    "test": {
                      "type": "boolean"
                    },
                    "provider": {
                      "type": "string",
                      "nullable": true,
                      "description": "Unisoft-funded dispatches report unisoft. External dispatches report the connected provider."
                    },
                    "funding": {
                      "type": "string",
                      "enum": [
                        "unisoft",
                        "external"
                      ],
                      "nullable": true
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "PREPARED",
                        "SENDING",
                        "ACCEPTED",
                        "REJECTED",
                        "BLOCKED",
                        "UNCERTAIN",
                        "CANCELED",
                        "SIMULATED"
                      ]
                    },
                    "code": {
                      "type": "string",
                      "nullable": true
                    },
                    "encoding": {
                      "type": "string",
                      "nullable": true
                    },
                    "segments": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "coefficient": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "unitsEstimated": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "unitsConsumed": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "simulated": {
                      "type": "boolean",
                      "nullable": true
                    },
                    "delivery": {
                      "type": "string",
                      "nullable": true
                    },
                    "deliveryAt": {
                      "type": "string",
                      "format": "date-time",
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "at",
                    "source",
                    "test",
                    "state",
                    "unitsConsumed",
                    "delivery",
                    "deliveryAt"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "total",
              "page",
              "pageSize",
              "unitsConsumed",
              "entries"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "success",
          "data"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Invalid filter or request.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Missing scope or restricted organisation access.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-additional-scopes": [
    "contacts:read"
  ]
}
```

## POST /campaigns/{id}/rescheduling-preview

Prévisualiser le déplacement d’une file future non commencée

`preview_campaign_rescheduling`

Requiert messages:reschedule ET messages:read ET messages:send explicitement attribués. Les clés restreintes à des collectes sont refusées. Déplace la file native déjà matérialisée d’une campagne VALIDATE ; ne résout, ne rafraîchit, n’ajoute ni ne retire destinataires, contenu, canaux, tarifs ou réglages prestataire. Utiliser l’UUID de campagne, pas d’envoi/contact/commande. Appeler preview_campaign_rescheduling avec scheduledAt RFC3339 strict et fuseau, puis request_campaign_rescheduling avec exactement scheduledAt canonique, expectedRevision, idempotencyKey UUID stable et acknowledgeQueue:true. La campagne exige dispatchToken natif valide, targets positif correspondant à tous les envois hors tests et date BSON future ; chaque cible EMAIL/SMS/WHATSAPP reste INIT, partage cette date, possède une identité scalaire globalement unique et aucune trace d’essai/progression/prestataire/claim/erreur/annulation. Les tests sont exclus et jamais déplacés. Preuve de complétude absente, notification mobile, cible commencée/échue/ambiguë ou changement concurrent refusent le plan entier. Ancienne et nouvelle dates restent à plus de 60 secondes ; phase d’écriture bornée à 10 secondes. Cette marge ne garantit aucune heure de livraison. Au plus 2000 cibles hors tests et 2100 références groupe/source au total (tests compris), dans un snapshot source de 8 Mio, sont admises. L’aperçu lie par hash campagne/file destinataire exactes et instant proposé, avec seulement comptes/canaux, jamais destinataires, contenu privé ou secrets. La commande journalise durablement et prend la fence commune de campagne avant CAS BSON exacts sur chaque send.scheduledAt puis la campagne. Aucun expéditeur, daemon ou prestataire appelé. Les workers natifs gardent leurs propres règles ultérieures. La fence n’expire pas pour rejouer ; STOP peut demander une préemption vérifiée avant chaque effet externe suivant. Les writers/workers internes ne sont pas verrouillés transactionnellement. Crash, écriture partielle, ACK inconnu, réponse perdue ou état UNKNOWN gardent la protection et ne permettent ni rejeu automatique, autre clé ou contournement par envoi standard. Lire get_campaign_rescheduling_command avec commandId, principal et organisation d’origine. SCHEDULED prouve les dates futures enregistrées, jamais envoi, livraison ou synchronisation. PENDING/RUNNING peuvent être interrompus et changedDeliveryCount reste null hors SCHEDULED. fenceReleased:false peut accompagner SCHEDULED prouvé si le nettoyage reste incomplet ; cela n’annule pas la date ni n’autorise une autre action. Un résultat final prouvé ne devient pas inconnu à cause du nettoyage. Aucun rafraîchissement futur de l’audience implicite. Entrées déclarées seules, aucun query ni corps GET.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:reschedule",
  "additional": [
    "messages:read",
    "messages:send"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "scheduledAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "scheduledAt"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Plan de programmation exact ou état durable de commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignReschedulingPreview"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, instant strict ou entrée fermée invalide."
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise."
}
```

#### HTTP 403

```json
{
  "description": "Droits actuels manquants ou principal restreint à des collectes."
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande courante indisponible."
}
```

#### HTTP 409

```json
{
  "description": "Aperçu périmé, file commencée/ambiguë, complétude absente, arrêt ou fence occupée. Aucun contournement ni rafraîchissement d’audience."
}
```

#### HTTP 500

```json
{
  "description": "Résultat de programmation inconnu ; lire la commande d’origine sans rejeu."
}
```

#### HTTP 503

```json
{
  "description": "Acquittement du journal/fence indisponible ; conserver l’identité de commande initiale."
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:reschedule",
  "x-unisoft-additional-scopes": [
    "messages:read",
    "messages:send"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /campaigns/{id}/rescheduling-commands

Déplacer une file de campagne future non commencée

`request_campaign_rescheduling`

Requiert messages:reschedule ET messages:read ET messages:send explicitement attribués. Les clés restreintes à des collectes sont refusées. Déplace la file native déjà matérialisée d’une campagne VALIDATE ; ne résout, ne rafraîchit, n’ajoute ni ne retire destinataires, contenu, canaux, tarifs ou réglages prestataire. Utiliser l’UUID de campagne, pas d’envoi/contact/commande. Appeler preview_campaign_rescheduling avec scheduledAt RFC3339 strict et fuseau, puis request_campaign_rescheduling avec exactement scheduledAt canonique, expectedRevision, idempotencyKey UUID stable et acknowledgeQueue:true. La campagne exige dispatchToken natif valide, targets positif correspondant à tous les envois hors tests et date BSON future ; chaque cible EMAIL/SMS/WHATSAPP reste INIT, partage cette date, possède une identité scalaire globalement unique et aucune trace d’essai/progression/prestataire/claim/erreur/annulation. Les tests sont exclus et jamais déplacés. Preuve de complétude absente, notification mobile, cible commencée/échue/ambiguë ou changement concurrent refusent le plan entier. Ancienne et nouvelle dates restent à plus de 60 secondes ; phase d’écriture bornée à 10 secondes. Cette marge ne garantit aucune heure de livraison. Au plus 2000 cibles hors tests et 2100 références groupe/source au total (tests compris), dans un snapshot source de 8 Mio, sont admises. L’aperçu lie par hash campagne/file destinataire exactes et instant proposé, avec seulement comptes/canaux, jamais destinataires, contenu privé ou secrets. La commande journalise durablement et prend la fence commune de campagne avant CAS BSON exacts sur chaque send.scheduledAt puis la campagne. Aucun expéditeur, daemon ou prestataire appelé. Les workers natifs gardent leurs propres règles ultérieures. La fence n’expire pas pour rejouer ; STOP peut demander une préemption vérifiée avant chaque effet externe suivant. Les writers/workers internes ne sont pas verrouillés transactionnellement. Crash, écriture partielle, ACK inconnu, réponse perdue ou état UNKNOWN gardent la protection et ne permettent ni rejeu automatique, autre clé ou contournement par envoi standard. Lire get_campaign_rescheduling_command avec commandId, principal et organisation d’origine. SCHEDULED prouve les dates futures enregistrées, jamais envoi, livraison ou synchronisation. PENDING/RUNNING peuvent être interrompus et changedDeliveryCount reste null hors SCHEDULED. fenceReleased:false peut accompagner SCHEDULED prouvé si le nettoyage reste incomplet ; cela n’annule pas la date ni n’autorise une autre action. Un résultat final prouvé ne devient pas inconnu à cause du nettoyage. Aucun rafraîchissement futur de l’audience implicite. Entrées déclarées seules, aucun query ni corps GET.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:reschedule",
  "additional": [
    "messages:read",
    "messages:send"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "scheduledAt": {
            "type": "string",
            "format": "date-time"
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "acknowledgeQueue": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "scheduledAt",
          "idempotencyKey",
          "expectedRevision",
          "acknowledgeQueue"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Plan de programmation exact ou état durable de commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignReschedulingCommand"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, instant strict ou entrée fermée invalide."
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise."
}
```

#### HTTP 403

```json
{
  "description": "Droits actuels manquants ou principal restreint à des collectes."
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande courante indisponible."
}
```

#### HTTP 409

```json
{
  "description": "Aperçu périmé, file commencée/ambiguë, complétude absente, arrêt ou fence occupée. Aucun contournement ni rafraîchissement d’audience."
}
```

#### HTTP 500

```json
{
  "description": "Résultat de programmation inconnu ; lire la commande d’origine sans rejeu."
}
```

#### HTTP 503

```json
{
  "description": "Acquittement du journal/fence indisponible ; conserver l’identité de commande initiale."
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:reschedule",
  "x-unisoft-additional-scopes": [
    "messages:read",
    "messages:send"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /campaigns/{id}/rescheduling-commands/{commandId}

Lire une reprogrammation de campagne sans rejeu

`get_campaign_rescheduling_command`

Requiert messages:reschedule ET messages:read ET messages:send explicitement attribués. Les clés restreintes à des collectes sont refusées. Déplace la file native déjà matérialisée d’une campagne VALIDATE ; ne résout, ne rafraîchit, n’ajoute ni ne retire destinataires, contenu, canaux, tarifs ou réglages prestataire. Utiliser l’UUID de campagne, pas d’envoi/contact/commande. Appeler preview_campaign_rescheduling avec scheduledAt RFC3339 strict et fuseau, puis request_campaign_rescheduling avec exactement scheduledAt canonique, expectedRevision, idempotencyKey UUID stable et acknowledgeQueue:true. La campagne exige dispatchToken natif valide, targets positif correspondant à tous les envois hors tests et date BSON future ; chaque cible EMAIL/SMS/WHATSAPP reste INIT, partage cette date, possède une identité scalaire globalement unique et aucune trace d’essai/progression/prestataire/claim/erreur/annulation. Les tests sont exclus et jamais déplacés. Preuve de complétude absente, notification mobile, cible commencée/échue/ambiguë ou changement concurrent refusent le plan entier. Ancienne et nouvelle dates restent à plus de 60 secondes ; phase d’écriture bornée à 10 secondes. Cette marge ne garantit aucune heure de livraison. Au plus 2000 cibles hors tests et 2100 références groupe/source au total (tests compris), dans un snapshot source de 8 Mio, sont admises. L’aperçu lie par hash campagne/file destinataire exactes et instant proposé, avec seulement comptes/canaux, jamais destinataires, contenu privé ou secrets. La commande journalise durablement et prend la fence commune de campagne avant CAS BSON exacts sur chaque send.scheduledAt puis la campagne. Aucun expéditeur, daemon ou prestataire appelé. Les workers natifs gardent leurs propres règles ultérieures. La fence n’expire pas pour rejouer ; STOP peut demander une préemption vérifiée avant chaque effet externe suivant. Les writers/workers internes ne sont pas verrouillés transactionnellement. Crash, écriture partielle, ACK inconnu, réponse perdue ou état UNKNOWN gardent la protection et ne permettent ni rejeu automatique, autre clé ou contournement par envoi standard. Lire get_campaign_rescheduling_command avec commandId, principal et organisation d’origine. SCHEDULED prouve les dates futures enregistrées, jamais envoi, livraison ou synchronisation. PENDING/RUNNING peuvent être interrompus et changedDeliveryCount reste null hors SCHEDULED. fenceReleased:false peut accompagner SCHEDULED prouvé si le nettoyage reste incomplet ; cela n’annule pas la date ni n’autorise une autre action. Un résultat final prouvé ne devient pas inconnu à cause du nettoyage. Aucun rafraîchissement futur de l’audience implicite. Entrées déclarées seules, aucun query ni corps GET.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:reschedule",
  "additional": [
    "messages:read",
    "messages:send"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Plan de programmation exact ou état durable de commande.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignReschedulingCommand"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, instant strict ou entrée fermée invalide."
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise."
}
```

#### HTTP 403

```json
{
  "description": "Droits actuels manquants ou principal restreint à des collectes."
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande courante indisponible."
}
```

#### HTTP 409

```json
{
  "description": "Aperçu périmé, file commencée/ambiguë, complétude absente, arrêt ou fence occupée. Aucun contournement ni rafraîchissement d’audience."
}
```

#### HTTP 500

```json
{
  "description": "Résultat de programmation inconnu ; lire la commande d’origine sans rejeu."
}
```

#### HTTP 503

```json
{
  "description": "Acquittement du journal/fence indisponible ; conserver l’identité de commande initiale."
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:reschedule",
  "x-unisoft-additional-scopes": [
    "messages:read",
    "messages:send"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /campaigns/{id}/audience-dispatch-preview

Relire l’envoi réel d’une audience CRM sauvegardée

`preview_saved_campaign_dispatch`

Requires messages:read and contacts:read, plus every native CRM source scope implied by saved listIds/excludedListIds and email_templates:read when a saved emailTemplate is used. Campaign-restricted keys are refused. Reads re-admit the persisted current API/OAuth key, open organisation, exact campaign, current CRM contacts/parents, list generations and source references, previous-campaign exclusions, sender references and existing hosted media. Only a saved crmTarget with a matching crmAudienceHash on an unchanged INIT draft is admitted. No categories/all-contact/import/form/annual-event fallback or inline audience override is used. Native exclusions rely on recorded SUCCESS non-test rows, not proof of inbox arrival or reading. A prior non-test delivery for this campaign blocks another dispatch. Missing/ambiguous/scalar-array data fails closed. Preview does not reserve a source or a provider, check live sender readiness, fetch media URLs or write a queue. Native SMS selection remains the organisation single-config owner; smsConfig is not a monetary reservation or provider selection. Initial queue admission is bounded to 2000 records and 16777216 bytes, including rendered content. Read this preview after composing and saving the audience. expectedRevision covers the reviewed content, current rendering and source/sender references; audienceHash must still match the saved native audience. preparedRecordCount counts initial queue rows, not future fallback attempts. selectedContactCount is the native selected source-contact count before recipient substitution, exclusions and reachability. An existing BSON scheduledAt is copied to each native row; no new schedule is accepted here. Use these exact values only for an explicitly authorised real mass send. No query parameters or request body are accepted. When sms is present, its estimateHash is the approval token for the maximum Unisoft SMS units, including possible fallbacks. External funding consumes no Unisoft units. Check unavailableRecords before asking the user to approve the units.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Plan natif courant relu ; aucun journal, réservation, file ni fournisseur.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudienceDispatchPreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_AUDIENCE_DISPATCH_INPUT ou UNKNOWN_QUERY_PARAMETER : utiliser seulement les champs déclarés et valeurs exactes relues.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API ou jeton OAuth absent ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, CAMPAIGN_RESTRICTED_KEY ou INVALID_ORGANISATION_CONTEXT : tous les droits courants requis et une organisation ouverte exacte sont obligatoires.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "CAMPAIGN_NOT_FOUND ou DISPATCH_COMMAND_NOT_FOUND : campagne exacte ou commande du même principal indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "CAMPAIGN_CHANGED, SAVED_AUDIENCE_CHANGED, DISPATCH_AUDIENCE_EMPTY, CAMPAIGN_NOT_EDITABLE, CAMPAIGN_ALREADY_HAS_DELIVERIES ou conflit source/émetteur/média/fence. Relire commande et aperçu courant ; aucune nouvelle clé pour contourner une issue incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "DISPATCH_LIMIT_REACHED : au plus 2000 lignes initiales et 16777216 octets JSON de file ; restreindre et enregistrer l’audience avant une nouvelle revue.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "CAMPAIGN_DISPATCH_UNAVAILABLE : issue possiblement inconnue ; relire la même commande sans renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "DISPATCH_JOURNAL_UNCERTAIN, DISPATCH_SOURCE_UNAVAILABLE ou CAMPAIGN_FENCE_UNCERTAIN : observer la même commande ; réponse ou ACK absent n’autorise jamais un rejeu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-additional-scopes": [
    "contacts:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-conditional-scopes": [
    {
      "condition": "saved target list kind form",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved target list kind product",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved target list kind cagnotte",
      "scopes": [
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved target list kind event",
      "scopes": [
        "events:read",
        "forms:read",
        "forms_submit:read",
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved target list kind fundraising",
      "scopes": [
        "fundraising:read",
        "paiements:read",
        "abonnements:read",
        "promesses:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved emailTemplate is present",
      "scopes": [
        "email_templates:read"
      ],
      "allRequired": true
    }
  ]
}
```

## POST /campaigns/{id}/audience-dispatches

Mettre en file une audience CRM sauvegardée autorisée

`dispatch_saved_campaign_audience`

Requires messages:read and contacts:read, plus every native CRM source scope implied by saved listIds/excludedListIds and email_templates:read when a saved emailTemplate is used. Campaign-restricted keys are refused. Reads re-admit the persisted current API/OAuth key, open organisation, exact campaign, current CRM contacts/parents, list generations and source references, previous-campaign exclusions, sender references and existing hosted media. Only a saved crmTarget with a matching crmAudienceHash on an unchanged INIT draft is admitted. No categories/all-contact/import/form/annual-event fallback or inline audience override is used. Native exclusions rely on recorded SUCCESS non-test rows, not proof of inbox arrival or reading. A prior non-test delivery for this campaign blocks another dispatch. Missing/ambiguous/scalar-array data fails closed. Preview does not reserve a source or a provider, check live sender readiness, fetch media URLs or write a queue. Native SMS selection remains the organisation single-config owner; smsConfig is not a monetary reservation or provider selection. Initial queue admission is bounded to 2000 records and 16777216 bytes, including rendered content. Requires the separate messages:send opt-in and an explicit user-authorised mass send. First call preview_saved_campaign_dispatch. Pass its exact expectedRevision, audienceHash and preparedRecordCount as expectedRecordCount, a stable UUID idempotencyKey and acknowledgeMassSend:true. A durable journal and common campaign mutation fence precede the last native preflight and INIT→VALIDATE reservation with targets/dispatchToken. The exact native recipient IDs and rendered payload are frozen before one bounded insertMany. Queue UUIDs are preserved so native unsubscribe links reference the actual rows. Every ACK, inserted ID and count must agree. QUEUED/queueAdmission=CONFIRMED is initial queue admission only; it is not SMTP delivery or reading. PENDING/UNCERTAIN or partial/unavailable observations never authorize replay, a new key, duplication or a test. The same principal/key/input only observes its prior result; changed intent conflicts. Unknown effects retain the fence without timeout stealing. STOP is preemptive and pending rows are canceled when its marker/latch is observed, but provider calls already handed off cannot be recalled. Another internal writer or worker can change after point-in-time checks; no global transaction or source reservation is promised. Known queue admission remains CONFIRMED if a terminal journal annotation or stop/fence cleanup is uncertain; inspect journalState, reservationStatus and stopCleanup separately. No provider is called inline. When the preview includes sms, show the maximum Unisoft units and external-funded record count to the user. Include the exact sms.estimateHash as smsEstimateHash. A changed quote, unapproved tariff or insufficient wallet blocks this command before queue admission. The per-message quote is frozen with the queued record and remains checked when the SMS worker reaches it.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:send",
  "additional": [
    "messages:read",
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "audienceHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "expectedRecordCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2000
          },
          "acknowledgeMassSend": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "smsEstimateHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "audienceHash",
          "expectedRecordCount",
          "acknowledgeMassSend"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Admission et résultat enregistrés, avec preuves séparées de file, journal, fence et nettoyage STOP.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudienceDispatchCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "La commande enregistrée reste en attente ; aucun effet rejoué.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudienceDispatchCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_AUDIENCE_DISPATCH_INPUT ou UNKNOWN_QUERY_PARAMETER : utiliser seulement les champs déclarés et valeurs exactes relues.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API ou jeton OAuth absent ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, CAMPAIGN_RESTRICTED_KEY ou INVALID_ORGANISATION_CONTEXT : tous les droits courants requis et une organisation ouverte exacte sont obligatoires.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "CAMPAIGN_NOT_FOUND ou DISPATCH_COMMAND_NOT_FOUND : campagne exacte ou commande du même principal indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "CAMPAIGN_CHANGED, SAVED_AUDIENCE_CHANGED, DISPATCH_AUDIENCE_EMPTY, CAMPAIGN_NOT_EDITABLE, CAMPAIGN_ALREADY_HAS_DELIVERIES ou conflit source/émetteur/média/fence. Relire commande et aperçu courant ; aucune nouvelle clé pour contourner une issue incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "DISPATCH_LIMIT_REACHED : au plus 2000 lignes initiales et 16777216 octets JSON de file ; restreindre et enregistrer l’audience avant une nouvelle revue.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "CAMPAIGN_DISPATCH_UNAVAILABLE : issue possiblement inconnue ; relire la même commande sans renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "DISPATCH_JOURNAL_UNCERTAIN, DISPATCH_SOURCE_UNAVAILABLE ou CAMPAIGN_FENCE_UNCERTAIN : observer la même commande ; réponse ou ACK absent n’autorise jamais un rejeu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:send",
  "x-unisoft-additional-scopes": [
    "messages:read",
    "contacts:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-conditional-scopes": [
    {
      "condition": "saved target list kind form",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved target list kind product",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved target list kind cagnotte",
      "scopes": [
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved target list kind event",
      "scopes": [
        "events:read",
        "forms:read",
        "forms_submit:read",
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved target list kind fundraising",
      "scopes": [
        "fundraising:read",
        "paiements:read",
        "abonnements:read",
        "promesses:read"
      ],
      "allRequired": true
    },
    {
      "condition": "saved emailTemplate is present",
      "scopes": [
        "email_templates:read"
      ],
      "allRequired": true
    }
  ]
}
```

## GET /campaigns/{id}/audience-dispatches/{commandId}

Observer une commande d’envoi CRM sans rejeu

`get_campaign_audience_dispatch`

Nécessite messages:read et contacts:read courants dans la même organisation et sous le même principal API que la commande ; les clés limitées à des collectes sont refusées. Lire le commandId conservé après QUEUED, PENDING, UNCERTAIN, une erreur HTTP ou une réponse perdue. queueObservation/observedDeliveryCount inspectent seulement les UUID initiaux figés, sans futurs replis et sans remplacer le suivi des livraisons. COMPLETE ne répare pas un ACK inconnu et ne signifie pas livré. QUEUED et queueAdmission=CONFIRMED ne prouvent ni arrivée en boîte ni lecture. La lecture ne libère aucune fence incertaine, ne rend et n’envoie rien, n’appelle ni ne sonde aucun fournisseur. Les mutations historiques utilisent leurs lectures de reçus dédiées avec leurs droits d’origine. Aucun paramètre de requête ni corps HTTP accepté.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Commande enregistrée et preuve passive de ses UUID initiaux figés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudienceDispatchCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_AUDIENCE_DISPATCH_INPUT ou UNKNOWN_QUERY_PARAMETER : utiliser seulement les champs déclarés et valeurs exactes relues.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API ou jeton OAuth absent ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, CAMPAIGN_RESTRICTED_KEY ou INVALID_ORGANISATION_CONTEXT : tous les droits courants requis et une organisation ouverte exacte sont obligatoires.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "CAMPAIGN_NOT_FOUND ou DISPATCH_COMMAND_NOT_FOUND : campagne exacte ou commande du même principal indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "CAMPAIGN_CHANGED, SAVED_AUDIENCE_CHANGED, DISPATCH_AUDIENCE_EMPTY, CAMPAIGN_NOT_EDITABLE, CAMPAIGN_ALREADY_HAS_DELIVERIES ou conflit source/émetteur/média/fence. Relire commande et aperçu courant ; aucune nouvelle clé pour contourner une issue incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "DISPATCH_LIMIT_REACHED : au plus 2000 lignes initiales et 16777216 octets JSON de file ; restreindre et enregistrer l’audience avant une nouvelle revue.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "CAMPAIGN_DISPATCH_UNAVAILABLE : issue possiblement inconnue ; relire la même commande sans renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "DISPATCH_JOURNAL_UNCERTAIN, DISPATCH_SOURCE_UNAVAILABLE ou CAMPAIGN_FENCE_UNCERTAIN : observer la même commande ; réponse ou ACK absent n’autorise jamais un rejeu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-additional-scopes": [
    "contacts:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /campaigns/{id}/update-receipts/{commandId}

Observer le reçu d’une édition historique de campagne

`get_campaign_update_receipt`

Nécessite uniquement le droit courant messages:write, identique au droit de la mutation historique update. Lire le commandId rendu respectivement par PATCH /campaigns/{id} ou POST /campaigns/{id}/send. Le principal API courant, l’organisation ouverte, la campagne et le legacyAction=UPDATE persisté doivent correspondre exactement. Ce GET est passif malgré son scope de mutation : aucun journal, écriture native, réservation, libération de fence, file ou fournisseur n’est appelé. COMPLETED avec queueAdmission=NOT_STARTED acquitte uniquement une édition de brouillon. QUEUED avec queueAdmission=CONFIRMED acquitte l’admission initiale native, sans livraison ni lecture. UNCERTAIN/PENDING et une observation ultérieure complète n’autorisent aucune nouvelle mutation et ne réparent aucun ACK inconnu. Écriture native, journal terminal et fence restent des preuves distinctes ; une issue incertaine conserve la fence. Aucun contact, contenu, configuration d’émetteur, empreinte de journal ni jeton n’est retourné. Aucun paramètre de requête ni corps HTTP accepté.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu passif sous le droit historique exact d’origine.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudienceDispatchCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "La mutation historique enregistrée reste en attente ; aucune reprise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudienceDispatchCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_AUDIENCE_DISPATCH_INPUT ou UNKNOWN_QUERY_PARAMETER : utiliser seulement les champs déclarés et valeurs exactes relues.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API ou jeton OAuth absent ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, CAMPAIGN_RESTRICTED_KEY ou INVALID_ORGANISATION_CONTEXT : tous les droits courants requis et une organisation ouverte exacte sont obligatoires.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "CAMPAIGN_NOT_FOUND ou DISPATCH_COMMAND_NOT_FOUND : campagne exacte ou commande du même principal indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "CAMPAIGN_CHANGED, SAVED_AUDIENCE_CHANGED, DISPATCH_AUDIENCE_EMPTY, CAMPAIGN_NOT_EDITABLE, CAMPAIGN_ALREADY_HAS_DELIVERIES ou conflit source/émetteur/média/fence. Relire commande et aperçu courant ; aucune nouvelle clé pour contourner une issue incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "DISPATCH_LIMIT_REACHED : au plus 2000 lignes initiales et 16777216 octets JSON de file ; restreindre et enregistrer l’audience avant une nouvelle revue.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "CAMPAIGN_DISPATCH_UNAVAILABLE : issue possiblement inconnue ; relire la même commande sans renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "DISPATCH_JOURNAL_UNCERTAIN, DISPATCH_SOURCE_UNAVAILABLE ou CAMPAIGN_FENCE_UNCERTAIN : observer la même commande ; réponse ou ACK absent n’autorise jamais un rejeu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /campaigns/{id}/send-receipts/{commandId}

Observer le reçu d’un envoi historique de campagne

`get_campaign_send_receipt`

Nécessite uniquement le droit courant messages:send, identique au droit de la mutation historique send. Lire le commandId rendu respectivement par PATCH /campaigns/{id} ou POST /campaigns/{id}/send. Le principal API courant, l’organisation ouverte, la campagne et le legacyAction=DISPATCH persisté doivent correspondre exactement. Ce GET est passif malgré son scope de mutation : aucun journal, écriture native, réservation, libération de fence, file ou fournisseur n’est appelé. COMPLETED avec queueAdmission=NOT_STARTED acquitte uniquement une édition de brouillon. QUEUED avec queueAdmission=CONFIRMED acquitte l’admission initiale native, sans livraison ni lecture. UNCERTAIN/PENDING et une observation ultérieure complète n’autorisent aucune nouvelle mutation et ne réparent aucun ACK inconnu. Écriture native, journal terminal et fence restent des preuves distinctes ; une issue incertaine conserve la fence. Aucun contact, contenu, configuration d’émetteur, empreinte de journal ni jeton n’est retourné. Aucun paramètre de requête ni corps HTTP accepté.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:send",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu passif sous le droit historique exact d’origine.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudienceDispatchCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "La mutation historique enregistrée reste en attente ; aucune reprise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudienceDispatchCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_AUDIENCE_DISPATCH_INPUT ou UNKNOWN_QUERY_PARAMETER : utiliser seulement les champs déclarés et valeurs exactes relues.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API ou jeton OAuth absent ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, CAMPAIGN_RESTRICTED_KEY ou INVALID_ORGANISATION_CONTEXT : tous les droits courants requis et une organisation ouverte exacte sont obligatoires.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "CAMPAIGN_NOT_FOUND ou DISPATCH_COMMAND_NOT_FOUND : campagne exacte ou commande du même principal indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "CAMPAIGN_CHANGED, SAVED_AUDIENCE_CHANGED, DISPATCH_AUDIENCE_EMPTY, CAMPAIGN_NOT_EDITABLE, CAMPAIGN_ALREADY_HAS_DELIVERIES ou conflit source/émetteur/média/fence. Relire commande et aperçu courant ; aucune nouvelle clé pour contourner une issue incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "DISPATCH_LIMIT_REACHED : au plus 2000 lignes initiales et 16777216 octets JSON de file ; restreindre et enregistrer l’audience avant une nouvelle revue.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "CAMPAIGN_DISPATCH_UNAVAILABLE : issue possiblement inconnue ; relire la même commande sans renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "DISPATCH_JOURNAL_UNCERTAIN, DISPATCH_SOURCE_UNAVAILABLE ou CAMPAIGN_FENCE_UNCERTAIN : observer la même commande ; réponse ou ACK absent n’autorise jamais un rejeu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:send",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /campaigns/{id}/delivery-progress

Lire l’avancement enregistré d’une campagne par canal

`get_campaign_delivery_progress`

Nécessite messages:read. Lire l’UUID d’une campagne de messages dans l’organisation authentifiée ; elle est distincte d’une collecte financière. Aucun paramètre de requête ni corps HTTP n’est accepté. L’appartenance de la campagne et send.organisation/groupe exigent des chaînes scalaires exactes sous collation binaire. Seules les lignes send existantes sont observées : les tests true sont exclus ; les marqueurs test invalides sont comptés séparément et exclus des totaux hors test. channels contient uniquement les groupes par canal hors test observés, avec UNKNOWN pour les canaux historiques invalides ou non pris en charge. recordCount compte des lignes d’envoi, pas des personnes : les tentatives de repli créent des lignes supplémentaires et les replis futurs n’existent pas encore. initialTargetCount est le compteur initial de dispatch enregistré ou null, jamais une prévisualisation d’audience ni une preuve de file complète. pendingCount compte INIT ; scheduledPendingCount est INIT avec une date BSON strictement après source.observedAt, readyOrInFlightCount est INIT sans date, avec null ou une date échue, et unknownSchedulePendingCount conserve les dates invalides. Aucun état actif persistant commun fiable n’existe : inProgressCount vaut toujours null, jamais zéro ; readyOrInFlightCount ne doit pas être présenté comme des envois actuellement actifs. successCount est SUCCESS enregistré, ce qui peut être une simple acceptation SMTP pour l’email, sans livraison en boîte ni lecture. failureCount comprend ERROR avec une issue incertaine. canceledCount comprend CANCELED/CANCELLED, simulations comprises. Les états inconnus restent dans unknownStateCount. deliveryUncertainCount et simulationCount sont des surcouches, sans résultats disjoints supplémentaires ; l’absence de marqueur d’incertitude ne prouve pas qu’un nouvel essai est sûr. FINISHED et 100% de succès enregistré ne prouvent ni la livraison ni l’exhaustivité de la file. source.readAt date cette lecture, computedAt vaut null et des mises à jour concurrentes sont possibles. Des channels/totaux vides décrivent l’absence de lignes hors test observées, sans audience prévue nulle. Aucun calcul d’audience, mise en file, appel fournisseur, nouvel essai, arrêt, rapprochement ou écriture métier n’a lieu ; l’authentification peut journaliser l’usage de la clé. Une campagne absente, supprimée ou étrangère donne 404. PROGRESS_LIMIT_REACHED (503) signifie que l’observation bornée en base n’a pas pu aboutir : répéter la lecture plus tard, sans renvoyer la campagne pour le résoudre. Utiliser la référence delivery-and-audiences pour l’interprétation et la reprise prise en charge ; un dispatch incertain n’autorise jamais de renvoi ou duplication automatique.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID d’une campagne de messages existante appartenant à l’organisation, sans être une collecte financière.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Avancement enregistré qualifié ; les appels actifs et l’exhaustivité de la file restent explicitement inconnus.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryProgressResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID invalide, paramètre de requête inconnu ou corps inattendu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Le droit messages:read est obligatoire.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne absente, supprimée ou hors de l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "L’avancement n’a pas pu être lu ; aucune action d’envoi n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "PROGRESS_LIMIT_REACHED : répéter la lecture plus tard ; ne pas renvoyer ni dupliquer la campagne.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /campaigns/{id}/deliveries

Lister les envois enregistrés et les instantanés des destinataires

`list_campaign_deliveries`

Nécessite messages:read et contacts:read. Lire les lignes send existantes hors test d’une campagne de messages appartenant à l’organisation ; les références organisation/groupe de la campagne et des envois exigent des chaînes scalaires exactes. Les tests true et les marqueurs test invalides sont exclus. Chaque ligne est une tentative d’envoi, sans destinataire unique ; un repli peut créer une autre ligne. INIT peut être en attente, programmé ou pendant un appel fournisseur. SUCCESS est le résultat de transport enregistré, sans garantie de livraison en boîte ni de lecture. Pour l’email, ACCEPTED signifie que le SMTP a accepté ; DELIVERED est un rapport positif de livraison enregistré. Les accusés WhatsApp sont uniquement des observations conservées. Les dates sont des instants ISO issus de dates BSON, sinon null. Les champs recipient sont les instantanés historiques de l’envoi. Un UUID de contact enregistré est réadmis contre un contact actuel non supprimé de cette organisation avant restitution de son identité ; les références invalides, supprimées ou étrangères masquent tous les champs d’identité avec UNAVAILABLE. Une référence absente donne SNAPSHOT_ONLY, sans nouveau rapprochement CRM déduit. Les coordonnées historiques n’autorisent pas un nouvel envoi. reasonCode est uniquement un code de la liste blanche : les motifs inconnus restent null, sans errorMessage brut, champs SMTP, jetons privés ni identifiants fournisseur. deliveryUncertain:true est une preuve explicite ; null ne prouve pas qu’un nouvel essai soit sûr. CANCELED/CANCELLED sont normalisés en CANCELED, les états/canaux historiques non pris en charge deviennent UNKNOWN et aucun fournisseur n’est interrogé. Aucune mise en file, reprise, rapprochement ou écriture métier n’a lieu ; l’authentification peut journaliser l’usage de la clé. Des changements concurrents sont possibles entre les lectures. Une campagne absente, supprimée ou étrangère, ou un contact/envoi demandé indisponible donne 404. Répéter une lecture après PROGRESS_LIMIT_REACHED (503) ; ne jamais renvoyer ni dupliquer pour résoudre une incertitude. Les filtres facultatifs channel, state et contactId se combinent. contactId doit actuellement appartenir à cette organisation. limit vaut 1–200, avec 50 par défaut. cursor est opaque et lié à l’organisation, la campagne et les filtres ; il suit l’ordre binaire des UUID d’envoi, sans ordre chronologique. Conserver les filtres pour poursuivre. Chaque source filtrée est bornée à 10000 lignes ; au-delà, 422 DELIVERY_SOURCE_LIMIT_EXCEEDED est renvoyé sans lignes partielles : réduire les filtres ou lire un UUID d’envoi connu. Les UUID d’envoi sélectionnés invalides ou dupliqués donnent 409 DELIVERY_HISTORY_REVIEW_REQUIRED, y compris sur continuation. Les paramètres inconnus, valeurs répétées et corps HTTP sont refusés.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID d’une campagne de messages existante appartenant à l’organisation, sans être une collecte financière.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "channel",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "EMAIL",
      "SMS",
      "WHATSAPP",
      "NOTIFICATION",
      "APPMOBILE_NOTIFICATION",
      "UNKNOWN"
    ]
  }
}
```

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "INIT",
      "SUCCESS",
      "ERROR",
      "CANCELED",
      "UNKNOWN"
    ]
  }
}
```

```json
{
  "name": "contactId",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 1024
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observations d’envoi par destinataire enregistrées, avec identité non autorisée masquée et inconnues explicites.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID invalide, filtre non pris en charge, curseur invalide, paramètre inconnu ou corps inattendu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les deux droits messages:read et contacts:read sont obligatoires.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne, envoi demandé ou contact demandé absent, supprimé ou hors de l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "DELIVERY_HISTORY_REVIEW_REQUIRED : des identifiants d’envoi invalides ou dupliqués exigent une revue par le parcours opérateur pris en charge ; aucun identifiant inventé ni page partielle n’est renvoyé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "DELIVERY_SOURCE_LIMIT_EXCEEDED : sélectionner un canal, un état ou un contact pour réduire la source sous 10000 lignes.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Les observations d’envoi n’ont pas pu être lues ; aucune action d’envoi n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "PROGRESS_LIMIT_REACHED : répéter la lecture plus tard ; ne pas renvoyer ni dupliquer la campagne.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-additional-scopes": [
    "contacts:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /campaigns/{id}/deliveries/{deliveryId}

Lire un envoi enregistré d’une campagne

`get_campaign_delivery`

Nécessite messages:read et contacts:read. Lire les lignes send existantes hors test d’une campagne de messages appartenant à l’organisation ; les références organisation/groupe de la campagne et des envois exigent des chaînes scalaires exactes. Les tests true et les marqueurs test invalides sont exclus. Chaque ligne est une tentative d’envoi, sans destinataire unique ; un repli peut créer une autre ligne. INIT peut être en attente, programmé ou pendant un appel fournisseur. SUCCESS est le résultat de transport enregistré, sans garantie de livraison en boîte ni de lecture. Pour l’email, ACCEPTED signifie que le SMTP a accepté ; DELIVERED est un rapport positif de livraison enregistré. Les accusés WhatsApp sont uniquement des observations conservées. Les dates sont des instants ISO issus de dates BSON, sinon null. Les champs recipient sont les instantanés historiques de l’envoi. Un UUID de contact enregistré est réadmis contre un contact actuel non supprimé de cette organisation avant restitution de son identité ; les références invalides, supprimées ou étrangères masquent tous les champs d’identité avec UNAVAILABLE. Une référence absente donne SNAPSHOT_ONLY, sans nouveau rapprochement CRM déduit. Les coordonnées historiques n’autorisent pas un nouvel envoi. reasonCode est uniquement un code de la liste blanche : les motifs inconnus restent null, sans errorMessage brut, champs SMTP, jetons privés ni identifiants fournisseur. deliveryUncertain:true est une preuve explicite ; null ne prouve pas qu’un nouvel essai soit sûr. CANCELED/CANCELLED sont normalisés en CANCELED, les états/canaux historiques non pris en charge deviennent UNKNOWN et aucun fournisseur n’est interrogé. Aucune mise en file, reprise, rapprochement ou écriture métier n’a lieu ; l’authentification peut journaliser l’usage de la clé. Des changements concurrents sont possibles entre les lectures. Une campagne absente, supprimée ou étrangère, ou un contact/envoi demandé indisponible donne 404. Répéter une lecture après PROGRESS_LIMIT_REACHED (503) ; ne jamais renvoyer ni dupliquer pour résoudre une incertitude. deliveryId est l’UUID exact de l’envoi enregistré sous cette campagne. Aucun paramètre de requête ni corps HTTP n’est accepté. Un UUID d’envoi dupliqué donne 409 DELIVERY_HISTORY_REVIEW_REQUIRED sans choix arbitraire d’une ligne. Cette opération n’interroge pas les accusés et ne renvoie aucun message.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID d’une campagne de messages existante appartenant à l’organisation, sans être une collecte financière.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "deliveryId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observations d’envoi par destinataire enregistrées, avec identité non autorisée masquée et inconnues explicites.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryRecordResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID invalide, filtre non pris en charge, curseur invalide, paramètre inconnu ou corps inattendu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les deux droits messages:read et contacts:read sont obligatoires.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne, envoi demandé ou contact demandé absent, supprimé ou hors de l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "DELIVERY_HISTORY_REVIEW_REQUIRED : des identifiants d’envoi invalides ou dupliqués exigent une revue par le parcours opérateur pris en charge ; aucun identifiant inventé ni page partielle n’est renvoyé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "DELIVERY_SOURCE_LIMIT_EXCEEDED : sélectionner un canal, un état ou un contact pour réduire la source sous 10000 lignes.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Les observations d’envoi n’ont pas pu être lues ; aucune action d’envoi n’a été tentée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "PROGRESS_LIMIT_REACHED : répéter la lecture plus tard ; ne pas renvoyer ni dupliquer la campagne.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-additional-scopes": [
    "contacts:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /campaigns/{id}/stop-preview

Vérifier les préconditions enregistrées de l’arrêt d’une campagne

`preview_campaign_stop`

Nécessite messages:read. Lire une campagne de l’organisation avec identité scalaire exacte et compter les lignes INIT actuellement enregistrées, tests compris, sans écriture métier. Retourne la révision requise par stop_campaign, le marqueur d’arrêt et pendingRecordCount. INIT peut inclure un appel fournisseur en cours : activeProviderCalls reste UNKNOWN et aucun rappel n’est garanti. Un brouillon INIT peut aussi être clôturé par un arrêt explicitement autorisé. La lecture ne réserve aucune ligne ; des changements concurrents peuvent modifier compte ou révision. Cette prévisualisation sous messages:read seul n’évalue pas la replanification : rescheduleAvailable vaut null. Utiliser preview_campaign_rescheduling avec ses propres capacités messages:reschedule, messages:read et messages:send pour la file future bornée ; modifier seulement la date de campagne ne replanifie pas les lignes existantes. Aucun paramètre de requête ni corps HTTP accepté. Campagne absente, supprimée ou étrangère : 404 ; état non pris en charge ou historique ambigu : 409. Cette lecture n’arrête et n’envoie aucun message.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Préconditions et révision courantes de l’arrêt ; aucune annulation effectuée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignStopPreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "COMMAND_JOURNAL_UNAVAILABLE : l’issue peut nécessiter la lecture de la même commande ; aucun nouvel envoi ni duplication n’est autorisé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /campaigns/{id}/stop

Arrêter une campagne et marquer les lignes restantes en file comme annulées

`stop_campaign`

Nécessite messages:send et messages:read ainsi qu’une demande explicite d’arrêt de cette campagne. Lire preview_campaign_stop puis fournir sa révision exacte, une idempotencyKey stable de 8 à 128 caractères et acknowledgeInFlight:true. La mutation reprend le contrat natif sous comparaisons scalaires exactes organisation/ID/groupe/état : enregistrer FINISHED, dispatchStopped:true, stoppedAt/stoppedBy et USER_EMERGENCY_STOP avant d’annuler les seuls INIT avec CANCELED, canceledAt et le même motif. Les tests sont inclus, SUCCESS et ERROR sont conservés. Un fournisseur déjà appelé peut terminer et son résultat réel peut remplacer l’observation annulée ; aucun rappel ni compte garanti d’envois empêchés. canceledRecordCount compte les lignes modifiées par cette observation ; remainingPendingRecordCount est une lecture ultérieure susceptible de changer. Le journal propre positivement acquitté précède toute mutation et le verrou STOP monotone commun. STOP préempte un autre propriétaire retenu sans le voler. Un ACK propre absent ou contradictoire interdit verrou et effet natif ; un 503 ne signifie jamais file annulée. Après admission propre, une panne du verrou ne supprime pas la tentative native et reste qualifiée séparément. Répéter la même clé/intention retourne le reçu sans effet ; une intention différente donne 409 IDEMPOTENCY_CONFLICT. COMPLETED signifie opérations acquittées et aucun INIT restant à l’observation ; PARTIAL indique des INIT résiduels ou un verrou incertain ; REJECTED indique un refus préalable ; RUNNING/ADMITTING reste inachevé ; UNKNOWN conserve un effet ou contrôle incertain. stopRecorded:true prouve un marqueur, sans rappel fournisseur. Après réponse perdue, lire get_campaign_delivery_command ; aucun renvoi ni duplication. Aucun paramètre query, replanification, fournisseur, facturation ou enqueue ; l’authentification peut enregistrer l’usage de la clé.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:send",
  "additional": [
    "messages:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 8,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9._:-]{8,128}$"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "acknowledgeInFlight": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "acknowledgeInFlight"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu durable de commande d’arrêt ; vérifier l’état et l’incertitude, pas seulement success.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "La même commande durable est encore admise ou en cours ; aucun effet n’a été rejoué.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "COMMAND_JOURNAL_UNAVAILABLE : l’issue peut nécessiter la lecture de la même commande ; aucun nouvel envoi ni duplication n’est autorisé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:send",
  "x-unisoft-additional-scopes": [
    "messages:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /campaigns/{id}/delivery-commands/{commandId}

Lire un reçu durable de commande de livraison d’une campagne

`get_campaign_delivery_command`

Nécessite messages:read. Lire l’UUID d’une commande existante sous cette campagne exacte appartenant à l’organisation. Les références de campagne et de journal sont réadmises comme valeurs scalaires exactes. Retourne uniquement le résultat enregistré ; ADMITTING/RUNNING/UNKNOWN ne doit pas être traité comme un échec ni une autorisation de nouvel envoi. stopRecorded et les compteurs d’annulation ne prouvent pas le rappel d’appels fournisseur déjà en vol. La lecture ne reprend et ne répète aucun effet et n’interroge jamais un fournisseur. Une campagne ou commande absente, supprimée ou étrangère donne 404. Aucun paramètre de requête ni corps HTTP n’est accepté.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu durable enregistré de commande ; aucune action n’a été rejouée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "COMMAND_JOURNAL_UNAVAILABLE : l’issue peut nécessiter la lecture de la même commande ; aucun nouvel envoi ni duplication n’est autorisé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /campaigns/{id}/audience-preview

Prévisualiser une audience CRM et les exclusions de campagnes antérieures

`preview_campaign_audience`

target.allContact:true explicitly starts from all visible non-deleted contacts; listIds/categories must be empty and operator must be union, while excludedListIds/excludedCategories refine that base. Omit allContact for the existing positive list/category mode. Requires messages:read and contacts:read. Resolve a proposed CRM-list/category audience for an INIT message draft through the native audience owner, without sending or creating queue rows. target.version is 1; choose union/intersection of nonempty listIds and/or categories, with optional excludedListIds/excludedCategories. Exact category labels are case-sensitive. Resolve exact list IDs using list_contact_lists and require availableForSearch:true. Canonical CRM list IDs are: form:<form UUID>, product:<form UUID>:<product UUID>, cagnotte:<caisse UUID>, event:<session UUID> or fundraising:<fundraising UUID>. Never guess the UUIDs; a known source UUID alone does not prove its list is published in the current generation. Source scopes are additional and checked before reads: form/product require forms:read + forms_submit:read; cagnotte requires caisses:read + paiements:read; event requires events:read + forms:read + forms_submit:read + caisses:read + paiements:read; fundraising requires fundraising:read + paiements:read + abonnements:read + promesses:read. The owner receives only API_KEY capabilities derived from those granted scopes, never ADMIN or all. Campaign-restricted keys are refused rather than widening unrelated source access. Current source ownership, generation, list identity, contact/parent references and previous campaign references are re-admitted; malformed history gives an explicit refusal, never an empty or widened audience. Each source read is bounded to 20000 rows and 10000 ms. Previous-campaign exclusions match recorded non-test SUCCESS rows and stored coordinates/contact references, not confirmed inbox delivery. A deleted previous campaign keeps its exclusion significance. An unavailable exclusion blocks rather than silently reincluding recipients. Contacts, parent substitution, reachable channels, unsubscribes, deduplication and fallbacks use the native owner; preparedRecordCount is prepared recipient rows at this observation, not guaranteed deliveries, money cost or future fallback count. No recipient PII is returned. A zero preview is valid but cannot be saved as a ready audience. Imported, submission-guided or annual-event audiences are preserved and refused rather than silently replaced. The response gives the current draft revision and audienceHash for save_campaign_audience. It does not reserve that population. After saving the audience, explicitly authorised mass dispatch uses preview_saved_campaign_dispatch and dispatch_saved_campaign_audience with messages:send and their own current preflight. Existing send_campaign still refuses CRM-list drafts. No provider call or business write occurs during preview; authentication may record key usage. No query parameters are accepted.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "target": {
            "$ref": "#/components/schemas/UnisoftRequest_46ebc7072c9dc383fded"
          },
          "excludedCampaignIds": {
            "type": "array",
            "maxItems": 100,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "required": [
          "target"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Prévisualisation qualifiée courante de l’audience ; aucun destinataire mis en file.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignAudiencePreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "AUDIENCE_SOURCE_LIMIT : réduire la sélection de sources ; aucune audience partielle n’est retournée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "AUDIENCE_SOURCE_UNAVAILABLE : répéter la lecture bornée plus tard ; ne pas envoyer pour récupérer une prévisualisation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-additional-scopes": [
    "contacts:read"
  ],
  "x-unisoft-conditional-scopes": [
    {
      "condition": "target list kind form",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind product",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind cagnotte",
      "scopes": [
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind event",
      "scopes": [
        "events:read",
        "forms:read",
        "forms_submit:read",
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind fundraising",
      "scopes": [
        "fundraising:read",
        "paiements:read",
        "abonnements:read",
        "promesses:read"
      ],
      "allRequired": true
    }
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /campaigns/{id}/audience

Enregistrer une audience CRM revue sur un brouillon sans envoyer

`save_campaign_audience`

target.allContact:true explicitly starts from all visible non-deleted contacts; listIds/categories must be empty and operator must be union, while excludedListIds/excludedCategories refine that base. Omit allContact for the existing positive list/category mode. Requires messages:read and contacts:read. Resolve a proposed CRM-list/category audience for an INIT message draft through the native audience owner, without sending or creating queue rows. target.version is 1; choose union/intersection of nonempty listIds and/or categories, with optional excludedListIds/excludedCategories. Exact category labels are case-sensitive. Resolve exact list IDs using list_contact_lists and require availableForSearch:true. Canonical CRM list IDs are: form:<form UUID>, product:<form UUID>:<product UUID>, cagnotte:<caisse UUID>, event:<session UUID> or fundraising:<fundraising UUID>. Never guess the UUIDs; a known source UUID alone does not prove its list is published in the current generation. Source scopes are additional and checked before reads: form/product require forms:read + forms_submit:read; cagnotte requires caisses:read + paiements:read; event requires events:read + forms:read + forms_submit:read + caisses:read + paiements:read; fundraising requires fundraising:read + paiements:read + abonnements:read + promesses:read. The owner receives only API_KEY capabilities derived from those granted scopes, never ADMIN or all. Campaign-restricted keys are refused rather than widening unrelated source access. Current source ownership, generation, list identity, contact/parent references and previous campaign references are re-admitted; malformed history gives an explicit refusal, never an empty or widened audience. Each source read is bounded to 20000 rows and 10000 ms. Previous-campaign exclusions match recorded non-test SUCCESS rows and stored coordinates/contact references, not confirmed inbox delivery. A deleted previous campaign keeps its exclusion significance. An unavailable exclusion blocks rather than silently reincluding recipients. Contacts, parent substitution, reachable channels, unsubscribes, deduplication and fallbacks use the native owner; preparedRecordCount is prepared recipient rows at this observation, not guaranteed deliveries, money cost or future fallback count. No recipient PII is returned. A zero preview is valid but cannot be saved as a ready audience. Imported, submission-guided or annual-event audiences are preserved and refused rather than silently replaced. The response gives the current draft revision and audienceHash for save_campaign_audience. It does not reserve that population. After saving the audience, explicitly authorised mass dispatch uses preview_saved_campaign_dispatch and dispatch_saved_campaign_audience with messages:send and their own current preflight. Existing send_campaign still refuses CRM-list drafts. No provider call or business write occurs during preview; authentication may record key usage. No query parameters are accepted. Saving additionally requires messages:write. First obtain a preview, then provide its exact expectedRevision and audienceHash with the same target/exclusions and a stable idempotencyKey. The owner resolves the audience again immediately before the CAS write. A changed revision/hash or empty population gives a durable REJECTED receipt. COMPLETED with selectionSaved:true means only the CRM target, exclusions and summary were saved on the unchanged INIT draft; no message was sent. The same key returns its recorded receipt without another write; UNKNOWN preserves a lost write result. Read get_campaign_delivery_command after a lost response. Preserve unrelated content and specialised audiences. The common campaign mutation fence coordinates audience save, update, dispatch and future rescheduling. Only a positive native write plus a positive terminal journal permits release; an uncertain result retains the fence. To send the saved CRM audience, obtain preview_saved_campaign_dispatch and explicitly authorise dispatch_saved_campaign_audience. Do not clear crmTarget or call legacy send_campaign to bypass that review.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": [
    "messages:read",
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "target": {
            "$ref": "#/components/schemas/UnisoftRequest_46ebc7072c9dc383fded"
          },
          "excludedCampaignIds": {
            "type": "array",
            "maxItems": 100,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "audienceHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 8,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9._:-]{8,128}$"
          }
        },
        "required": [
          "target",
          "expectedRevision",
          "audienceHash",
          "idempotencyKey"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu durable d’enregistrement d’audience ; aucun dispatch n’a eu lieu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "La même commande d’audience est encore admise ou en cours ; aucune écriture n’a été rejouée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "AUDIENCE_SOURCE_LIMIT : réduire la sélection de sources ; aucune audience partielle n’est retournée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "COMMAND_JOURNAL_UNAVAILABLE : l’issue peut nécessiter la lecture de la même commande ; aucun nouvel envoi ni duplication n’est autorisé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-additional-scopes": [
    "messages:read",
    "contacts:read"
  ],
  "x-unisoft-conditional-scopes": [
    {
      "condition": "target list kind form",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind product",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind cagnotte",
      "scopes": [
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind event",
      "scopes": [
        "events:read",
        "forms:read",
        "forms_submit:read",
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind fundraising",
      "scopes": [
        "fundraising:read",
        "paiements:read",
        "abonnements:read",
        "promesses:read"
      ],
      "allRequired": true
    }
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /campaigns/{id}/sms-preview

Estimer les segments SMS d’un brouillon et observer le quota restant

`preview_campaign_sms_usage`

Requires messages:read and contacts:read. Read an unchanged INIT message draft with a saved explicit ordinary audience (allContact, starred or categories) or saved crmTarget. Special imported/form/annual-event audiences are not broadened to perform this estimate. A saved CRM target also needs the source scopes described by preview_campaign_audience; restricted campaign keys are refused. Supply an empty JSON object, no query parameters. The native audience resolver, parent substitution, unsubscribe handling, deduplication and fallback preparation are reused without saving or creating send rows. primaryRecordCount/primarySegments count eligible INIT primary SMS rows; ineligibleSmsRecordCount counts SMS rows already prepared ERROR and excluded from the estimate. possibleFallbackRecordCount/possibleFallbackSegments describe only the potential SMS fallback of eligible primary rows on another channel, not promised dispatch or additional guaranteed consumption. Do not add them to primarySegments and call that a binding quote. Each personalised stored preparation text is stripped with the worker messageRemoveWhatsappTags and measured with the same gsm package; groups split GSM_03_38 and UNICODE. Texts total at most 16 MiB and source reads at most 20000 rows/10000 ms. Provider-added content, future edits, availability and actual billing can change consumption; source.estimateOnly is true and no provider is queried. quota.remainingCredits is a qualified legacy CRM.getNbSMSAvailable observation in SMS_SEGMENT_CREDIT, not money or a reservation. Sources are preflighted for exact ownership and safe types; unreadable/invalid/oversized quota history or a failed quota owner yields null without hiding a usable segment estimate. The legacy getter has known provider-adjustment projection limitations, so sufficientForPrimaryEstimate compares only that observation with the primary estimate and never guarantees capacity. Negative observed credits remain negative. No canonical monetary tariff is available: pricing.amountMinor and currency remain null, not zero/free. No send, debit, quota reservation, campaign edit or reconciliation occurs; authentication may record key usage. SMS_AUDIENCE_REQUIRED asks for an explicit supported saved selection; do not send to discover cost. A limit refusal requires narrowing/reviewing the selection, never partial totals or an automatic send. When the SMS platform is active, the optional sms object is the applicable estimate in Unisoft units. It includes maximum units if every potential SMS fallback is used, rows on external funding, unavailable rows and the observed wallet. No recipient coordinates or message content are returned. For send_campaign on an ordinary draft, confirm the units with the user and pass sms.estimateHash as smsEstimateHash. For a saved CRM audience, obtain the dispatch-specific hash from preview_saved_campaign_dispatch; the segment-only and legacy quota fields here are for observation.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Estimation qualifiée des segments et observation historique nullable du quota ; aucune réservation ni devis monétaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignSmsPreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "SMS_PREVIEW_SOURCE_LIMIT ou AUDIENCE_SOURCE_LIMIT : réduire la sélection ; aucune estimation partielle retournée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "COMMAND_JOURNAL_UNAVAILABLE : l’issue peut nécessiter la lecture de la même commande ; aucun nouvel envoi ni duplication n’est autorisé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-additional-scopes": [
    "contacts:read"
  ],
  "x-unisoft-conditional-scopes": [
    {
      "condition": "target list kind form",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind product",
      "scopes": [
        "forms:read",
        "forms_submit:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind cagnotte",
      "scopes": [
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind event",
      "scopes": [
        "events:read",
        "forms:read",
        "forms_submit:read",
        "caisses:read",
        "paiements:read"
      ],
      "allRequired": true
    },
    {
      "condition": "target list kind fundraising",
      "scopes": [
        "fundraising:read",
        "paiements:read",
        "abonnements:read",
        "promesses:read"
      ],
      "allRequired": true
    }
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /campaigns/{id}/template-send-preview

Vérifier un email individuel indépendant par modèle avant envoi

`preview_template_message_send`

Nécessite messages:read, contacts:read et email_templates:read. Préparer un EMAIL individuel indépendant à un contact CRM courant non décédé de l’organisation depuis un modèle local courant de cette organisation. Cette capacité couvre uniquement l’email, sans envoi de modèles WhatsApp/SMS. L’UUID d’un brouillon INIT existant sert uniquement de contexte de commande ; sa population de masse, son contenu et son état ne sont pas envoyés ni changés. Les contextes arrêtés ou lancés sont refusés. Fournir contactId, templateId et un subject non vide exacts, avec un emailConfigId de l’organisation facultatif. L’email destinataire est normalisé depuis le contact courant, jamais depuis une adresse brute fournie par le demandeur. Les désabonnements courants sont contrôlés et ne peuvent pas être contournés. L’appartenance scalaire exacte et les références dupliquées ou ambiguës sont contrôlées avant le propriétaire natif. La prévisualisation retourne recipientEmail et une révision liée au contact/modèle/objet/contexte courants. Lire le modèle sélectionné par son opération de lecture lorsque son contenu importe. Il n’est pas figé : le propriétaire natif recharge son HTML courant à la mise en file et la configuration peut changer avant livraison par le worker. Aucun appel fournisseur ni message test n’a lieu pendant la prévisualisation. Une demande de brouillon ou cette prévisualisation n’autorise pas l’envoi réel. Les clés restreintes à des collectes sont refusées ; les champs corps/requête inconnus et références invalides sont rejetés.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read",
    "email_templates:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "contactId": {
            "type": "string",
            "format": "uuid"
          },
          "templateId": {
            "type": "string",
            "format": "uuid"
          },
          "subject": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "emailConfigId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "contactId",
          "templateId",
          "subject"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Intention et révision courantes d’email individuel ; aucune mise en file ni appel fournisseur.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignTemplateSendPreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "COMMAND_JOURNAL_UNAVAILABLE : l’issue peut nécessiter la lecture de la même commande ; aucun nouvel envoi ni duplication n’est autorisé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "contacts:read",
    "email_templates:read"
  ]
}
```

## POST /campaigns/{id}/template-sends

Mettre en file un email individuel indépendant par modèle autorisé

`send_template_message`

Nécessite messages:read, contacts:read et email_templates:read. Préparer un EMAIL individuel indépendant à un contact CRM courant non décédé de l’organisation depuis un modèle local courant de cette organisation. Cette capacité couvre uniquement l’email, sans envoi de modèles WhatsApp/SMS. L’UUID d’un brouillon INIT existant sert uniquement de contexte de commande ; sa population de masse, son contenu et son état ne sont pas envoyés ni changés. Les contextes arrêtés ou lancés sont refusés. Fournir contactId, templateId et un subject non vide exacts, avec un emailConfigId de l’organisation facultatif. L’email destinataire est normalisé depuis le contact courant, jamais depuis une adresse brute fournie par le demandeur. Les désabonnements courants sont contrôlés et ne peuvent pas être contournés. L’appartenance scalaire exacte et les références dupliquées ou ambiguës sont contrôlées avant le propriétaire natif. La prévisualisation retourne recipientEmail et une révision liée au contact/modèle/objet/contexte courants. Lire le modèle sélectionné par son opération de lecture lorsque son contenu importe. Il n’est pas figé : le propriétaire natif recharge son HTML courant à la mise en file et la configuration peut changer avant livraison par le worker. Aucun appel fournisseur ni message test n’a lieu pendant la prévisualisation. Une demande de brouillon ou cette prévisualisation n’autorise pas l’envoi réel. Les clés restreintes à des collectes sont refusées ; les champs corps/requête inconnus et références invalides sont rejetés. L’envoi exige aussi messages:send et une demande explicite pour ce modèle, cet objet et ce destinataire uniques. Obtenir d’abord preview_template_message_send ; fournir la même intention, expectedRevision exact, idempotencyKey stable et acknowledgeIndependentSend:true. Le journal durable et la source globale unique sont écrits avant l’appel unique de sendMailOrg natif. Son absence d’ID de retour n’est pas interprétée comme un échec : l’adaptateur relit toujours cette source exacte dans la même organisation, même après une exception du propriétaire. QUEUED avec deliveryId signifie qu’une ligne email correspondante a été observée, jamais livraison, acceptation SMTP, lecture ou réponse. Une ligne absente, ambiguë ou illisible laisse UNKNOWN ; ne jamais réessayer automatiquement avec une autre clé ni créer un envoi de remplacement. Une clé identique retourne le même reçu sans nouvel appel ; une intention modifiée donne IDEMPOTENCY_CONFLICT. Lire get_campaign_delivery_command et get_template_message_delivery après une réponse perdue. La ligne individuelle n’a pas de groupe de diffusion : elle n’apparaît pas dans les progrès/comptes de campagne et n’arrête ni ne clôture ce brouillon ; c’est un email réel distinct, pas test_campaign. La configuration email de l’organisation est préférée par le propriétaire natif avec son repli habituel. Aucun appel fournisseur synchrone n’a lieu ici, mais le worker enverra un email réel. L’opération ne réserve ni modèle ni configuration SMTP.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:send",
  "additional": [
    "messages:read",
    "contacts:read",
    "email_templates:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "contactId": {
            "type": "string",
            "format": "uuid"
          },
          "templateId": {
            "type": "string",
            "format": "uuid"
          },
          "subject": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "emailConfigId": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 8,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9._:-]{8,128}$"
          },
          "acknowledgeIndependentSend": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "contactId",
          "templateId",
          "subject",
          "expectedRevision",
          "idempotencyKey",
          "acknowledgeIndependentSend"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Reçu durable de commande de mise en file : vérifier QUEUED, REJECTED ou UNKNOWN ; mis en file ne signifie pas livré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryCommandResponse"
      }
    }
  }
}
```

#### HTTP 202

```json
{
  "description": "La même commande durable d’envoi par modèle est encore admise/en cours ; aucun appel propriétaire rejoué.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignDeliveryCommandResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "COMMAND_JOURNAL_UNAVAILABLE : l’issue peut nécessiter la lecture de la même commande ; aucun nouvel envoi ni duplication n’est autorisé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:send",
  "x-unisoft-additional-scopes": [
    "messages:read",
    "contacts:read",
    "email_templates:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /campaigns/{id}/template-sends/{commandId}/delivery

Lire le résultat enregistré d’un email individuel indépendant par modèle

`get_template_message_delivery`

Nécessite messages:read et contacts:read. Lire la ligne send exacte liée à une commande SEND_TEMPLATE existante sous ce contexte de campagne de l’organisation. Elle peut établir une preuve de file apparue ultérieurement même si le reçu reste UNKNOWN ; elle ne reprend et ne renvoie rien. La source est recalculée depuis l’identité de commande et contrôlée avec appartenance exacte organisation/source/canal/destination ; une preuve de file absente ou ambiguë donne TEMPLATE_DELIVERY_UNAVAILABLE (409), pas non-livraison. La référence de contact courante est réadmise avant publication de l’email historique ; une référence supprimée ou étrangère masque l’identité. État, dates, motif sûr et statut d’accusé email suivent la sémantique de get_campaign_delivery. SUCCESS peut être une acceptation SMTP ; DELIVERED est un rapport enregistré, sans placement en boîte ni lecture. Aucune interrogation fournisseur, diagnostic brut, HTML de modèle, secret ou champ SMTP n’est exposé. Aucun paramètre de requête ni corps HTTP n’est accepté.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": [
    "contacts:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "description": "UUID de la campagne de messages appartenant à l’organisation.",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "commandId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation enregistrée d’email individuel, avec preuve d’accusé qualifiée et réadmission courante de l’identité.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignTemplateDeliveryResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID ou enveloppe invalide, champ de requête/corps inconnu, révision ou clé d’idempotence invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Les droits requis sur les campagnes sont absents.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Campagne ou commande indisponible dans l’organisation authentifiée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de révision/idempotence ou historique enregistré de campagne non pris en charge ou ambigu. Lire l’état courant ; ne pas renvoyer.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "La requête n’a pas pu aboutir. Lire la commande et la campagne existantes avant toute autre action.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "COMMAND_JOURNAL_UNAVAILABLE : l’issue peut nécessiter la lecture de la même commande ; aucun nouvel envoi ni duplication n’est autorisé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "contacts:read"
  ]
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "Campaign": {
        "type": "object",
        "description": "Campagne de messages (collection messages) : envoi groupé WhatsApp/SMS/Email. Cycle de vie INIT (brouillon) → VALIDATE (envoyée) → FINISHED (terminée). `targets`/`percentSuccess`/`percentError` sont calculés à partir des livraisons.",
        "properties": {
          "crmTarget": {
            "type": "object",
            "readOnly": true,
            "description": "Ciblage versionné des listes/catégories de contacts. Union par défaut ; les exclusions sont prioritaires sur les inclusions. Relecture du back-office requise avant toute modification, prévisualisation ou envoi."
          },
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "WHATSAPP",
              "SMS",
              "EMAIL",
              "WHATSAPP_OU_SMS",
              "WHATSAPP_OU_EMAIL",
              "WHATSAPP_OU_SMS_OU_EMAIL",
              "SMS_OU_EMAIL"
            ],
            "description": "Canal ou cascade de remplacement."
          },
          "state": {
            "type": "string",
            "enum": [
              "INIT",
              "VALIDATE",
              "FINISHED"
            ],
            "readOnly": true,
            "description": "INIT = brouillon (modifiable) ; VALIDATE = envoi en cours/envoyée ; FINISHED = terminée."
          },
          "subject": {
            "type": "string",
            "description": "Objet de l’email (canaux EMAIL)."
          },
          "message": {
            "type": "string",
            "description": "Corps du message (texte, avec interpolation {{firstname}}/{{lastname}}/{{hebrewname}} ; les alias historiques {{prenom}}/{{nom}}/{{prenomHE}} restent pris en charge)."
          },
          "emailContent": {
            "type": "string",
            "description": "Corps complet de l’email HTML (alternative à emailTemplate)."
          },
          "emailTemplate": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’un modèle d’email (son HTML est chargé dans emailContent au moment de l’envoi)."
          },
          "emailConfig": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant de la configuration d’envoi d’email à utiliser (voir GET /messaging-configs)."
          },
          "smsConfig": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’une configuration SMS — accepté pour compatibilité, mais IGNORÉ par le processus SMS (configuration unique par organisation)."
          },
          "whatsappAccountId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant du numéro WhatsApp émetteur (obligatoire lorsque type contient WHATSAPP)."
          },
          "allContact": {
            "type": "boolean",
            "description": "Ciblage : tous les contacts."
          },
          "staredOnly": {
            "type": "boolean",
            "description": "Ciblage : contacts locaux/épinglés (module Proximité)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Ciblage : contacts appartenant à l’une de ces catégories."
          },
          "excludedCategories": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400
            },
            "description": "Exclude contacts in ANY named category from all/local/category targeting. Exclusions apply before resolving children and again to parent recipients. Exact category names; no contacts are deleted. Not supported for imports, forms, anonymous push or crmTarget (use crmTarget.excludedCategories there)."
          },
          "familles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Champ historique, enregistré mais NON utilisé pour le ciblage."
          },
          "docs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignMedia"
            }
          },
          "videos": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignMedia"
            }
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignLink"
            }
          },
          "prefix": {
            "type": "string"
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Heure d’envoi (null = immédiatement après l’envoi de la commande)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "targets": {
            "type": "integer",
            "readOnly": true,
            "description": "Nombre de livraisons (après l’envoi)."
          },
          "percentSuccess": {
            "type": "string",
            "readOnly": true
          },
          "percentError": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "CampaignMedia": {
        "type": "object",
        "description": "Élément de média de campagne. `doc` est une URL http(s) (réhébergée à l’écriture) ou un nom de fichier déjà hébergé (par ex. renvoyé par POST /uploads).",
        "properties": {
          "name": {
            "type": "string",
            "description": "Libellé d’affichage."
          },
          "doc": {
            "type": "string",
            "description": "URL http(s) (réhébergée) ou nom de fichier hébergé."
          }
        }
      },
      "CampaignLink": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "UnisoftRequest_a64ca28f296f1c41c444": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "WHATSAPP",
              "SMS",
              "EMAIL",
              "WHATSAPP_OU_SMS",
              "WHATSAPP_OU_EMAIL",
              "WHATSAPP_OU_SMS_OU_EMAIL",
              "SMS_OU_EMAIL"
            ],
            "description": "Obligatoire à la création."
          },
          "whatsappAccountId": {
            "type": "string",
            "description": "Obligatoire lorsque type contient WHATSAPP."
          },
          "subject": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "emailContent": {
            "type": "string"
          },
          "emailTemplate": {
            "type": "string",
            "description": "Identifiant d’un modèle d’email existant."
          },
          "emailConfig": {
            "type": "string",
            "description": "Identifiant d’une configuration email existante (GET /messaging-configs)."
          },
          "smsConfig": {
            "type": "string",
            "description": "Identifiant d’une configuration SMS (accepté mais ignoré par le processus)."
          },
          "allContact": {
            "type": "boolean"
          },
          "staredOnly": {
            "type": "boolean"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "excludedCategories": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400
            },
            "description": "Optional category exclusions for allContact, staredOnly or categories audiences. A match in any category excludes the source contact and final parent recipient. Exact category names, case-sensitive. Omit on update to preserve; [] clears. For crmTarget use its own excludedCategories via the audience command. Does not send or delete contacts."
          },
          "familles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "docs": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Libellé d’affichage."
                },
                "doc": {
                  "type": "string",
                  "description": "URL http(s) (réhébergée) ou nom de fichier hébergé."
                }
              },
              "additionalProperties": false,
              "description": "Élément de média de campagne. `doc` est une URL http(s) (réhébergée à l’écriture) ou un nom de fichier déjà hébergé (par ex. renvoyé par POST /uploads)."
            }
          },
          "videos": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Libellé d’affichage."
                },
                "doc": {
                  "type": "string",
                  "description": "URL http(s) (réhébergée) ou nom de fichier hébergé."
                }
              },
              "additionalProperties": false,
              "description": "Élément de média de campagne. `doc` est une URL http(s) (réhébergée à l’écriture) ou un nom de fichier déjà hébergé (par ex. renvoyé par POST /uploads)."
            }
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "additionalProperties": false
            }
          },
          "prefix": {
            "type": "string"
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false,
        "description": "Les campagnes ciblant des listes de contacts exposent crmTarget en lecture ; leur modification, l’aperçu des destinataires et l’envoi nécessitent une revue du back-office (CONTACT_LIST_REVIEW_REQUIRED). Cette API refuse toute nouvelle valeur crmTarget. Créez ou modifiez une campagne de messages. Le ciblage est EXCLUSIF : définissez exactement l’un de `allContact`, `staredOnly` ou `categories`.\nLorsque `type` contient WHATSAPP, `whatsappAccountId` est OBLIGATOIRE et doit correspondre à un numéro connecté (voir GET /whatsapp-accounts).\nMédias (`docs`/`videos`) : le champ `doc` de chaque élément peut être une URL http(s) (réhébergée) ou un nom de fichier renvoyé par POST /uploads.\nUne campagne est créée dans l’état INIT (brouillon) ; elle ne peut être modifiée que dans cet état. L’envoi est une action distincte (POST /{id}/send, scope messages:send)."
      },
      "UnisoftRequest_eb7a1a258ea96fc9aa42": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "WHATSAPP",
              "SMS",
              "EMAIL",
              "WHATSAPP_OU_SMS",
              "WHATSAPP_OU_EMAIL",
              "WHATSAPP_OU_SMS_OU_EMAIL",
              "SMS_OU_EMAIL"
            ],
            "description": "Obligatoire à la création."
          },
          "whatsappAccountId": {
            "type": "string",
            "description": "Obligatoire lorsque type contient WHATSAPP."
          },
          "subject": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "emailContent": {
            "type": "string"
          },
          "emailTemplate": {
            "type": "string",
            "description": "Identifiant d’un modèle d’email existant."
          },
          "emailConfig": {
            "type": "string",
            "description": "Identifiant d’une configuration email existante (GET /messaging-configs)."
          },
          "smsConfig": {
            "type": "string",
            "description": "Identifiant d’une configuration SMS (accepté mais ignoré par le processus)."
          },
          "allContact": {
            "type": "boolean"
          },
          "staredOnly": {
            "type": "boolean"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "excludedCategories": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400
            },
            "description": "Optional category exclusions for allContact, staredOnly or categories audiences. A match in any category excludes the source contact and final parent recipient. Exact category names, case-sensitive. Omit on update to preserve; [] clears. For crmTarget use its own excludedCategories via the audience command. Does not send or delete contacts."
          },
          "familles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "docs": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Libellé d’affichage."
                },
                "doc": {
                  "type": "string",
                  "description": "URL http(s) (réhébergée) ou nom de fichier hébergé."
                }
              },
              "additionalProperties": false,
              "description": "Élément de média de campagne. `doc` est une URL http(s) (réhébergée à l’écriture) ou un nom de fichier déjà hébergé (par ex. renvoyé par POST /uploads)."
            }
          },
          "videos": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Libellé d’affichage."
                },
                "doc": {
                  "type": "string",
                  "description": "URL http(s) (réhébergée) ou nom de fichier hébergé."
                }
              },
              "additionalProperties": false,
              "description": "Élément de média de campagne. `doc` est une URL http(s) (réhébergée à l’écriture) ou un nom de fichier déjà hébergé (par ex. renvoyé par POST /uploads)."
            }
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "additionalProperties": false
            }
          },
          "prefix": {
            "type": "string"
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Les campagnes ciblant des listes de contacts exposent crmTarget en lecture ; leur modification, l’aperçu des destinataires et l’envoi nécessitent une revue du back-office (CONTACT_LIST_REVIEW_REQUIRED). Cette API refuse toute nouvelle valeur crmTarget. Créez ou modifiez une campagne de messages. Le ciblage est EXCLUSIF : définissez exactement l’un de `allContact`, `staredOnly` ou `categories`.\nLorsque `type` contient WHATSAPP, `whatsappAccountId` est OBLIGATOIRE et doit correspondre à un numéro connecté (voir GET /whatsapp-accounts).\nMédias (`docs`/`videos`) : le champ `doc` de chaque élément peut être une URL http(s) (réhébergée) ou un nom de fichier renvoyé par POST /uploads.\nUne campagne est créée dans l’état INIT (brouillon) ; elle ne peut être modifiée que dans cet état. L’envoi est une action distincte (POST /{id}/send, scope messages:send)."
      },
      "CampaignTargets": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "description": "Nombre de destinataires correspondant au ciblage."
          }
        }
      },
      "CampaignReschedulingPreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "campaignId",
          "expectedRevision",
          "previousScheduledAt",
          "scheduledAt",
          "targetCount",
          "excludedTestCount",
          "channels",
          "minimumFutureSeconds",
          "audienceChanged",
          "contentChanged",
          "source",
          "providerChecked"
        ],
        "properties": {
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "previousScheduledAt": {
            "type": "string",
            "format": "date-time"
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time"
          },
          "targetCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2000
          },
          "excludedTestCount": {
            "type": "integer",
            "minimum": 0
          },
          "channels": {
            "type": "array",
            "maxItems": 3,
            "items": {
              "type": "string",
              "enum": [
                "EMAIL",
                "SMS",
                "WHATSAPP"
              ]
            }
          },
          "minimumFutureSeconds": {
            "type": "integer",
            "enum": [
              60
            ]
          },
          "audienceChanged": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "contentChanged": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "source": {
            "type": "string",
            "enum": [
              "NATIVE_MATERIALIZED_SEND_QUEUE"
            ]
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "CampaignReschedulingCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "commandId",
          "campaignId",
          "state",
          "scheduledAt",
          "previousScheduledAt",
          "targetCount",
          "changedDeliveryCount",
          "reason",
          "startedAt",
          "finishedAt",
          "fenceReleased",
          "audienceChanged",
          "contentChanged",
          "providerChecked"
        ],
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "PENDING",
              "RUNNING",
              "SCHEDULED",
              "REJECTED",
              "UNKNOWN"
            ]
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time"
          },
          "previousScheduledAt": {
            "type": "string",
            "format": "date-time"
          },
          "targetCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2000
          },
          "changedDeliveryCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2000,
            "nullable": true
          },
          "reason": {
            "type": "string",
            "nullable": true
          },
          "startedAt": {
            "type": "string",
            "format": "date-time"
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "fenceReleased": {
            "type": "boolean"
          },
          "audienceChanged": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "contentChanged": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "CampaignAudienceDispatchPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignAudienceDispatchPreview"
          }
        }
      },
      "CampaignAudienceDispatchPreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "campaignId",
          "expectedRevision",
          "audienceHash",
          "preparedRecordCount",
          "selectedContactCount",
          "channels",
          "scheduledAt",
          "maxRecords",
          "maxQueueBytes",
          "queueCreated",
          "providerChecked",
          "readAt"
        ],
        "properties": {
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "audienceHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "preparedRecordCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2000
          },
          "selectedContactCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20000
          },
          "channels": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "channel",
                "recordCount"
              ],
              "properties": {
                "channel": {
                  "type": "string",
                  "enum": [
                    "EMAIL",
                    "SMS",
                    "WHATSAPP"
                  ]
                },
                "recordCount": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 2000
                }
              }
            }
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "maxRecords": {
            "type": "integer",
            "enum": [
              2000
            ]
          },
          "maxQueueBytes": {
            "type": "integer",
            "enum": [
              16777216
            ]
          },
          "queueCreated": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "sms": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "estimateHash",
              "catalogueVersion",
              "records",
              "unisoftUnits",
              "externalRecords",
              "unavailableRecords",
              "availableUnits",
              "remainingUnits"
            ],
            "properties": {
              "estimateHash": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "catalogueVersion": {
                "type": "string",
                "nullable": true
              },
              "records": {
                "type": "integer",
                "minimum": 0,
                "maximum": 2000
              },
              "unisoftUnits": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "externalRecords": {
                "type": "integer",
                "minimum": 0,
                "maximum": 2000
              },
              "unavailableRecords": {
                "type": "integer",
                "minimum": 0,
                "maximum": 2000
              },
              "availableUnits": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "remainingUnits": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "nullable": true
              }
            }
          }
        }
      },
      "CampaignAudienceDispatchCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignAudienceDispatchCommand"
          }
        }
      },
      "CampaignAudienceDispatchCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "commandId",
          "campaignId",
          "status",
          "preparedRecordCount",
          "queuedRecordCount",
          "queueAdmission",
          "campaignReserved",
          "reservationStatus",
          "journalState",
          "retryable",
          "errorCode",
          "startedAt",
          "finishedAt",
          "stopCleanup",
          "queueObservation",
          "observedDeliveryCount",
          "providerChecked",
          "canRecallHandedOff"
        ],
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "QUEUED",
              "COMPLETED",
              "REJECTED",
              "UNCERTAIN"
            ]
          },
          "preparedRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2000,
            "nullable": true
          },
          "queuedRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2000,
            "nullable": true
          },
          "queueAdmission": {
            "type": "string",
            "enum": [
              "NOT_STARTED",
              "CONFIRMED",
              "UNKNOWN"
            ]
          },
          "campaignReserved": {
            "type": "boolean",
            "nullable": true
          },
          "reservationStatus": {
            "type": "string",
            "enum": [
              "HELD",
              "RELEASED",
              "STOP_REQUESTED",
              "UNKNOWN"
            ]
          },
          "journalState": {
            "type": "string",
            "enum": [
              "RECORDED",
              "UNCONFIRMED"
            ]
          },
          "retryable": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "errorCode": {
            "type": "string",
            "nullable": true,
            "enum": [
              "CAMPAIGN_CHANGED",
              "SAVED_AUDIENCE_CHANGED",
              "CAMPAIGN_ALREADY_HAS_DELIVERIES",
              "CAMPAIGN_STOP_REQUESTED",
              "CAMPAIGN_OPERATION_BUSY",
              "CAMPAIGN_FENCE_UNCERTAIN",
              "CAMPAIGN_FENCE_LOST",
              "DISPATCH_RESULT_UNKNOWN",
              "DISPATCH_SOURCE_UNAVAILABLE",
              "DISPATCH_SENDER_UNAVAILABLE",
              "DISPATCH_MEDIA_UNAVAILABLE",
              "DISPATCH_LIMIT_REACHED",
              "SMS_ESTIMATE_CHANGED",
              "SMS_QUOTA_INSUFFICIENT",
              null
            ]
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "stopCleanup": {
            "type": "string",
            "enum": [
              "NOT_OBSERVED",
              "NOT_NEEDED",
              "CANCELED_PENDING",
              "UNCONFIRMED"
            ]
          },
          "queueObservation": {
            "type": "string",
            "enum": [
              "COMPLETE",
              "PARTIAL",
              "UNAVAILABLE"
            ]
          },
          "observedDeliveryCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2000,
            "nullable": true
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "canRecallHandedOff": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "CampaignDeliveryProgressResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignDeliveryProgress"
          }
        }
      },
      "CampaignDeliveryProgress": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "campaignId",
          "state",
          "configuredChannel",
          "initialTargetCount",
          "scheduledAt",
          "dispatchStopped",
          "totals",
          "channels",
          "unclassifiedTestRecordCount",
          "source"
        ],
        "properties": {
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "nullable": true,
            "enum": [
              "INIT",
              "VALIDATE",
              "FINISHED",
              null
            ],
            "description": "Cycle de vie enregistré de la campagne. FINISHED peut suivre un arrêt d’urgence et ne prouve ni l’exhaustivité de la file ni la livraison. Un état historique non pris en charge vaut null."
          },
          "configuredChannel": {
            "type": "string",
            "nullable": true,
            "enum": [
              "EMAIL",
              "SMS",
              "WHATSAPP",
              "WHATSAPP_OU_SMS",
              "WHATSAPP_OU_EMAIL",
              "WHATSAPP_OU_SMS_OU_EMAIL",
              "SMS_OU_EMAIL",
              "APPMOBILE_NOTIFICATION",
              null
            ]
          },
          "initialTargetCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "description": "Valeur messages.targets enregistrée lorsqu’il s’agit d’un entier sûr positif ou nul, sinon null. Il s’agit du compteur initial de dispatch, sans résolution actuelle d’audience ni projection par canal. Les lignes de repli peuvent rendre recordCount supérieur."
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Date BSON enregistrée de la campagne sous forme d’instant ISO ; null si absente ou invalide. Les dates de chaque ligne déterminent le classement de la file."
          },
          "dispatchStopped": {
            "type": "boolean",
            "nullable": true,
            "description": "Marqueur d’arrêt explicitement enregistré ; null si absent ou invalide. Cette lecture n’effectue aucun arrêt ni annulation."
          },
          "totals": {
            "$ref": "#/components/schemas/CampaignDeliveryProgressCounts"
          },
          "channels": {
            "type": "array",
            "maxItems": 6,
            "items": {
              "$ref": "#/components/schemas/CampaignDeliveryProgressChannel"
            }
          },
          "unclassifiedTestRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes dont le marqueur test est invalide. Elles sont exclues de tous les totaux hors test et compteurs par canal car leur nature de test est inconnue ; les tests explicitement true sont entièrement exclus."
          },
          "source": {
            "$ref": "#/components/schemas/CampaignDeliveryProgressSource"
          }
        }
      },
      "CampaignDeliveryProgressCounts": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "recordCount",
          "pendingCount",
          "scheduledPendingCount",
          "readyOrInFlightCount",
          "unknownSchedulePendingCount",
          "successCount",
          "failureCount",
          "canceledCount",
          "unknownStateCount",
          "deliveryUncertainCount",
          "simulationCount",
          "inProgressCount"
        ],
        "properties": {
          "recordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes d’envoi hors test enregistrées dans ce groupe, replis compris. Ce ne sont ni des destinataires uniques, ni la taille de l’audience prévue, ni des livraisons confirmées."
          },
          "pendingCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes INIT enregistrées ; comprend les envois programmés, prêts et éventuellement un appel fournisseur actif."
          },
          "scheduledPendingCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes INIT dont scheduledAt est une date BSON strictement après source.observedAt. Il s’agit d’envois programmés dans la file, sans projection d’audience."
          },
          "readyOrInFlightCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes INIT sans scheduledAt, avec scheduledAt null ou avec une date BSON au plus tard à source.observedAt. L’attente et un appel fournisseur actif ne peuvent pas être distingués."
          },
          "unknownSchedulePendingCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes INIT dont la date enregistrée a un type non pris en charge. Elles ne sont pas supposées prêtes ou programmées."
          },
          "successCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes enregistrées SUCCESS. Pour l’email, SUCCESS peut indiquer uniquement une acceptation SMTP ; aucune livraison en boîte, lecture ou vérification du statut fournisseur n’est établie."
          },
          "failureCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes enregistrées ERROR, y compris les résultats explicitement incertains. Cela n’autorise pas de nouvel essai et ne prouve pas que le fournisseur n’a rien reçu."
          },
          "canceledCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes enregistrées CANCELED ou CANCELLED, dont les annulations de simulation. Les messages déjà transmis ne peuvent pas être rappelés."
          },
          "unknownStateCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes dont l’état enregistré est absent, invalide ou non pris en charge. Aucune valeur historique brute n’est exposée ou transformée en succès."
          },
          "deliveryUncertainCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Surcouche des lignes deliveryUncertain:true ou portant le code exact MAILER_DELIVERY_UNCERTAIN. Les autres lignes ne sont pas pour autant prouvées certaines ; ne jamais ajouter cette surcouche aux compteurs d’état."
          },
          "simulationCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Surcouche des lignes simulation:true, sans livraison réelle réussie. Ne jamais ajouter cette surcouche aux compteurs d’état."
          },
          "inProgressCount": {
            "type": "integer",
            "nullable": true,
            "enum": [
              null
            ],
            "description": "Toujours null : les workers ne disposent pas d’un état actif persistant commun fiable. Ne jamais présenter null comme zéro."
          }
        }
      },
      "CampaignDeliveryProgressChannel": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "channel",
          "recordCount",
          "pendingCount",
          "scheduledPendingCount",
          "readyOrInFlightCount",
          "unknownSchedulePendingCount",
          "successCount",
          "failureCount",
          "canceledCount",
          "unknownStateCount",
          "deliveryUncertainCount",
          "simulationCount",
          "inProgressCount"
        ],
        "properties": {
          "channel": {
            "type": "string",
            "enum": [
              "EMAIL",
              "SMS",
              "WHATSAPP",
              "NOTIFICATION",
              "APPMOBILE_NOTIFICATION",
              "UNKNOWN"
            ],
            "description": "Canal exact enregistré lorsqu’il est pris en charge ; UNKNOWN regroupe les canaux absents, invalides ou non pris en charge sans exposer leurs valeurs brutes."
          },
          "recordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes d’envoi hors test enregistrées dans ce groupe, replis compris. Ce ne sont ni des destinataires uniques, ni la taille de l’audience prévue, ni des livraisons confirmées."
          },
          "pendingCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes INIT enregistrées ; comprend les envois programmés, prêts et éventuellement un appel fournisseur actif."
          },
          "scheduledPendingCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes INIT dont scheduledAt est une date BSON strictement après source.observedAt. Il s’agit d’envois programmés dans la file, sans projection d’audience."
          },
          "readyOrInFlightCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes INIT sans scheduledAt, avec scheduledAt null ou avec une date BSON au plus tard à source.observedAt. L’attente et un appel fournisseur actif ne peuvent pas être distingués."
          },
          "unknownSchedulePendingCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes INIT dont la date enregistrée a un type non pris en charge. Elles ne sont pas supposées prêtes ou programmées."
          },
          "successCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes enregistrées SUCCESS. Pour l’email, SUCCESS peut indiquer uniquement une acceptation SMTP ; aucune livraison en boîte, lecture ou vérification du statut fournisseur n’est établie."
          },
          "failureCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes enregistrées ERROR, y compris les résultats explicitement incertains. Cela n’autorise pas de nouvel essai et ne prouve pas que le fournisseur n’a rien reçu."
          },
          "canceledCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes enregistrées CANCELED ou CANCELLED, dont les annulations de simulation. Les messages déjà transmis ne peuvent pas être rappelés."
          },
          "unknownStateCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Lignes dont l’état enregistré est absent, invalide ou non pris en charge. Aucune valeur historique brute n’est exposée ou transformée en succès."
          },
          "deliveryUncertainCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Surcouche des lignes deliveryUncertain:true ou portant le code exact MAILER_DELIVERY_UNCERTAIN. Les autres lignes ne sont pas pour autant prouvées certaines ; ne jamais ajouter cette surcouche aux compteurs d’état."
          },
          "simulationCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Surcouche des lignes simulation:true, sans livraison réelle réussie. Ne jamais ajouter cette surcouche aux compteurs d’état."
          },
          "inProgressCount": {
            "type": "integer",
            "nullable": true,
            "enum": [
              null
            ],
            "description": "Toujours null : les workers ne disposent pas d’un état actif persistant commun fiable. Ne jamais présenter null comme zéro."
          }
        }
      },
      "CampaignDeliveryProgressSource": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "collection",
          "scope",
          "observedAt",
          "readAt",
          "computedAt",
          "inProgressAvailability",
          "audienceResolved",
          "queueCompleteness",
          "providerChecked"
        ],
        "properties": {
          "collection": {
            "type": "string",
            "enum": [
              "send"
            ]
          },
          "scope": {
            "type": "string",
            "enum": [
              "STORED_CAMPAIGN_DELIVERY_RECORDS"
            ]
          },
          "observedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Début de l’observation de la file et instant fixe utilisé pour classer les lignes INIT programmées."
          },
          "readAt": {
            "type": "string",
            "format": "date-time",
            "description": "Fin de cette lecture en base ; des écritures concurrentes sont possibles. Il ne s’agit ni d’une vérification fournisseur ni de la date d’un instantané immuable."
          },
          "computedAt": {
            "type": "string",
            "nullable": true,
            "enum": [
              null
            ]
          },
          "inProgressAvailability": {
            "type": "string",
            "enum": [
              "UNAVAILABLE_NO_COMMON_PERSISTED_IN_FLIGHT_STATE"
            ]
          },
          "audienceResolved": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "queueCompleteness": {
            "type": "string",
            "enum": [
              "UNKNOWN"
            ]
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "CampaignDeliveryListResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta",
          "source"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/CampaignDeliveryRecord"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/CampaignDeliveryListMeta"
          },
          "source": {
            "$ref": "#/components/schemas/CampaignDeliveryListSource"
          }
        }
      },
      "CampaignDeliveryRecord": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "deliveryId",
          "channel",
          "state",
          "recipient",
          "createdAt",
          "attemptedAt",
          "scheduledAt",
          "canceledAt",
          "smtpAcceptedAt",
          "deliveredReportAt",
          "deliveryUpdatedAt",
          "deliveryStatus",
          "whatsappAck",
          "whatsappAckAt",
          "reasonCode",
          "reasonAvailability",
          "deliveryUncertain",
          "simulation"
        ],
        "properties": {
          "deliveryId": {
            "type": "string",
            "format": "uuid"
          },
          "channel": {
            "type": "string",
            "enum": [
              "EMAIL",
              "SMS",
              "WHATSAPP",
              "NOTIFICATION",
              "APPMOBILE_NOTIFICATION",
              "UNKNOWN"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "INIT",
              "SUCCESS",
              "ERROR",
              "CANCELED",
              "UNKNOWN"
            ]
          },
          "recipient": {
            "$ref": "#/components/schemas/CampaignDeliveryRecipient"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "attemptedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "canceledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "smtpAcceptedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "deliveredReportAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "deliveryUpdatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "deliveryStatus": {
            "type": "string",
            "nullable": true,
            "enum": [
              "ACCEPTED",
              "DELIVERED",
              "RELAYED",
              "EXPANDED",
              "DELAYED",
              "ERROR",
              "UNKNOWN",
              null
            ],
            "description": "Statut email enregistré uniquement, sans interrogation fournisseur. ACCEPTED est une acceptation SMTP ; DELIVERED est un rapport positif de livraison conservé, sans preuve de placement en boîte ni de lecture. null signifie absent, invalide ou ligne hors email."
          },
          "whatsappAck": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4,
            "nullable": true,
            "description": "Accusé WhatsApp enregistré uniquement : le consommateur courant interprète 1 comme envoyé, 2 comme reçu et 3 ou plus comme lu. Aucun nouvel accusé n’est demandé ; null signifie indisponible ou non pris en charge."
          },
          "whatsappAckAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "reasonCode": {
            "type": "string",
            "nullable": true,
            "enum": [
              "API_PHONE_BAD_COUNTRY",
              "API_PHONE_BAD_FORMAT",
              "API_EMAIL_BAD_FORMAT",
              "API_EMAIL_UNSUBSCRIBE",
              "MAILER_BAD_CONFIG",
              "MAILER_INVALID_RETRY",
              "MAILER_MAX_ATTEMPTS",
              "MAILER_INVALID_ID",
              "MAILER_DELIVERY_UNCERTAIN",
              "DELIVERY_REPORT_FAILED",
              "USER_EMERGENCY_STOP",
              "SMS_TEST_MODE",
              "SMS_CONFIGURATION_ERROR",
              "INVALID_PHONE_NUMBER",
              "SMS_NOT_AVAILABLE",
              "EMPTY_MESSAGE",
              "SMS_QUOTA_EXCEEDED",
              "WHATSAPP_SEND_ERROR",
              "INVALID_WHATSAPP_NUMBER",
              "WHATSAPP_NUMBER_BLOCKED",
              "WHATSAPP_ACCOUNT_NOT_READY",
              "WHATSAPP_NO_ACCOUNT",
              "WHATSAPP_MEDIA_FAILED",
              "WHATSAPP_TEXT_FAILED",
              null
            ],
            "description": "Uniquement errorCode ou stopReason enregistré et présent dans la liste blanche. null indique l’absence de motif connu publiable, sans signifier absence d’échec. Les diagnostics fournisseur bruts, réponses SMTP et errorMessage ne sont jamais exposés."
          },
          "reasonAvailability": {
            "type": "string",
            "enum": [
              "KNOWN_CODE",
              "UNAVAILABLE"
            ]
          },
          "deliveryUncertain": {
            "type": "boolean",
            "nullable": true,
            "enum": [
              true,
              null
            ],
            "description": "true lorsqu’un marqueur explicite d’incertitude ou MAILER_DELIVERY_UNCERTAIN est enregistré. Sinon null ; son absence ne prouve ni la non-livraison ni qu’un nouvel essai soit sûr."
          },
          "simulation": {
            "type": "boolean",
            "nullable": true
          }
        }
      },
      "CampaignDeliveryRecipient": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "contactId",
          "identityStatus",
          "firstName",
          "lastName",
          "email",
          "phone"
        ],
        "properties": {
          "contactId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "identityStatus": {
            "type": "string",
            "enum": [
              "CURRENT_CONTACT_REFERENCE",
              "SNAPSHOT_ONLY",
              "UNAVAILABLE"
            ],
            "description": "CURRENT_CONTACT_REFERENCE signifie que l’UUID de contact enregistré a été réadmis dans l’organisation courante. SNAPSHOT_ONLY indique qu’aucune référence de contact n’était enregistrée. UNAVAILABLE masque l’identité lorsqu’une référence est invalide, supprimée ou étrangère. Les noms et coordonnées sont des instantanés historiques de l’envoi, sans actualisation depuis le contact."
          },
          "firstName": {
            "type": "string",
            "nullable": true,
            "maxLength": 200
          },
          "lastName": {
            "type": "string",
            "nullable": true,
            "maxLength": 200
          },
          "email": {
            "type": "string",
            "nullable": true,
            "maxLength": 320
          },
          "phone": {
            "type": "string",
            "nullable": true,
            "maxLength": 32
          }
        }
      },
      "CampaignDeliveryListMeta": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "nextCursor",
          "hasMore",
          "count"
        ],
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 200
          }
        }
      },
      "CampaignDeliveryListSource": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "readAt",
          "providerChecked",
          "scope",
          "maxRecords"
        ],
        "properties": {
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "scope": {
            "type": "string",
            "enum": [
              "STORED_NON_TEST_DELIVERY_RECORDS"
            ]
          },
          "maxRecords": {
            "type": "integer",
            "enum": [
              10000
            ]
          }
        }
      },
      "CampaignDeliveryRecordResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "source"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignDeliveryRecord"
          },
          "source": {
            "$ref": "#/components/schemas/CampaignDeliveryRecordSource"
          }
        }
      },
      "CampaignDeliveryRecordSource": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "readAt",
          "providerChecked"
        ],
        "properties": {
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "CampaignStopPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignStopPreview"
          }
        }
      },
      "CampaignStopPreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "campaignId",
          "revision",
          "state",
          "stopRecorded",
          "pendingRecordCount",
          "observedAt",
          "includesTests",
          "activeProviderCalls",
          "canRecallHandedOff",
          "rescheduleAvailable",
          "reschedulePrerequisite"
        ],
        "properties": {
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "state": {
            "type": "string",
            "enum": [
              "INIT",
              "VALIDATE",
              "FINISHED"
            ]
          },
          "stopRecorded": {
            "type": "boolean"
          },
          "pendingRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "observedAt": {
            "type": "string",
            "format": "date-time"
          },
          "includesTests": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "activeProviderCalls": {
            "type": "string",
            "enum": [
              "UNKNOWN"
            ]
          },
          "canRecallHandedOff": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "rescheduleAvailable": {
            "type": "boolean",
            "nullable": true,
            "enum": [
              null
            ]
          },
          "reschedulePrerequisite": {
            "type": "string",
            "enum": [
              "USE_DEDICATED_RESCHEDULING_PREVIEW"
            ]
          }
        }
      },
      "CampaignDeliveryCommandResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignDeliveryCommand"
          }
        }
      },
      "CampaignDeliveryCommand": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "commandId",
          "campaignId",
          "action",
          "state",
          "stopRecorded",
          "canceledRecordCount",
          "remainingPendingRecordCount",
          "errorCode",
          "startedAt",
          "finishedAt",
          "deliveryId",
          "selectionSaved",
          "audienceCount",
          "audienceHash",
          "canRecallHandedOff",
          "providerChecked"
        ],
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "STOP",
              "UPDATE_AUDIENCE",
              "SEND_TEMPLATE"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "ADMITTING",
              "RUNNING",
              "COMPLETED",
              "PARTIAL",
              "REJECTED",
              "UNKNOWN",
              "QUEUED"
            ]
          },
          "stopRecorded": {
            "type": "boolean",
            "nullable": true
          },
          "canceledRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "remainingPendingRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "errorCode": {
            "type": "string",
            "nullable": true,
            "enum": [
              "REVISION_CONFLICT",
              "CAMPAIGN_STATE_UNSUPPORTED",
              "CAMPAIGN_HISTORY_REVIEW_REQUIRED",
              "CAMPAIGN_NOT_FOUND",
              "COMMAND_OUTCOME_UNKNOWN",
              "COMMAND_ADMISSION_UNAVAILABLE",
              "AUDIENCE_CHANGED",
              "AUDIENCE_EMPTY",
              "AUDIENCE_HISTORY_REVIEW_REQUIRED",
              "CAMPAIGN_NOT_EDITABLE",
              "AUDIENCE_SOURCE_UNAVAILABLE",
              "CONTACT_UNAVAILABLE",
              "RECIPIENT_UNSUBSCRIBED",
              "TEMPLATE_UNAVAILABLE",
              "TEMPLATE_SEND_CHANGED",
              "CAMPAIGN_OPERATION_BUSY",
              "CAMPAIGN_STOP_REQUESTED",
              "CAMPAIGN_FENCE_UNCERTAIN",
              "CAMPAIGN_FENCE_LOST",
              "CAMPAIGN_FENCE_INVALID",
              null
            ]
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "deliveryId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "selectionSaved": {
            "type": "boolean",
            "nullable": true
          },
          "audienceCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "audienceHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "canRecallHandedOff": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      },
      "UnisoftRequest_46ebc7072c9dc383fded": {
        "type": "object",
        "properties": {
          "version": {
            "type": "integer",
            "enum": [
              1
            ]
          },
          "allContact": {
            "type": "boolean",
            "description": "Set true to start from every non-deleted contact visible to this connection, then apply excludedListIds and excludedCategories. Requires empty listIds/categories and operator union. Omit or false keeps the explicit list/category selection; no implicit all-contact fallback."
          },
          "operator": {
            "type": "string",
            "enum": [
              "union",
              "intersection"
            ],
            "default": "union"
          },
          "listIds": {
            "type": "array",
            "maxItems": 100,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400
            }
          },
          "categories": {
            "type": "array",
            "maxItems": 100,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400
            }
          },
          "excludedListIds": {
            "type": "array",
            "maxItems": 100,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400
            }
          },
          "excludedCategories": {
            "type": "array",
            "maxItems": 100,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400
            }
          }
        },
        "required": [
          "version"
        ],
        "additionalProperties": false
      },
      "CampaignAudiencePreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignAudiencePreview"
          }
        }
      },
      "CampaignAudiencePreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "campaignId",
          "revision",
          "audienceHash",
          "target",
          "excludedCampaignIds",
          "contactCount",
          "preparedRecordCount",
          "channels",
          "observedAt",
          "queueCreated",
          "sendAuthorised",
          "providerChecked",
          "dispatchRequiresReview"
        ],
        "properties": {
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "audienceHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "target": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "version",
              "operator",
              "listIds",
              "categories",
              "excludedListIds",
              "excludedCategories"
            ],
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "allContact": {
                "type": "boolean",
                "description": "Set true to start from every non-deleted contact visible to this connection, then apply excludedListIds and excludedCategories. Requires empty listIds/categories and operator union. Omit or false keeps the explicit list/category selection; no implicit all-contact fallback."
              },
              "operator": {
                "type": "string",
                "enum": [
                  "union",
                  "intersection"
                ],
                "default": "union"
              },
              "listIds": {
                "type": "array",
                "maxItems": 100,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 400
                }
              },
              "categories": {
                "type": "array",
                "maxItems": 100,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 400
                }
              },
              "excludedListIds": {
                "type": "array",
                "maxItems": 100,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 400
                }
              },
              "excludedCategories": {
                "type": "array",
                "maxItems": 100,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 400
                }
              }
            }
          },
          "excludedCampaignIds": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "contactCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20000
          },
          "preparedRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20000
          },
          "channels": {
            "type": "array",
            "minItems": 3,
            "maxItems": 3,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "channel",
                "recordCount"
              ],
              "properties": {
                "channel": {
                  "type": "string",
                  "enum": [
                    "EMAIL",
                    "SMS",
                    "WHATSAPP"
                  ]
                },
                "recordCount": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 20000
                }
              }
            }
          },
          "observedAt": {
            "type": "string",
            "format": "date-time"
          },
          "queueCreated": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "sendAuthorised": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "dispatchRequiresReview": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        }
      },
      "CampaignSmsPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignSmsPreview"
          }
        }
      },
      "CampaignSmsPreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "campaignId",
          "revision",
          "preparedRecordCount",
          "primaryRecordCount",
          "primarySegments",
          "possibleFallbackRecordCount",
          "possibleFallbackSegments",
          "ineligibleSmsRecordCount",
          "groups",
          "quota",
          "pricing",
          "source"
        ],
        "properties": {
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "preparedRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20000
          },
          "primaryRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20000
          },
          "primarySegments": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "possibleFallbackRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20000
          },
          "possibleFallbackSegments": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "ineligibleSmsRecordCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20000
          },
          "groups": {
            "type": "array",
            "maxItems": 4,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "route",
                "encoding",
                "recordCount",
                "segments"
              ],
              "properties": {
                "route": {
                  "type": "string",
                  "enum": [
                    "PRIMARY",
                    "POSSIBLE_FALLBACK"
                  ]
                },
                "encoding": {
                  "type": "string",
                  "enum": [
                    "GSM_03_38",
                    "UNICODE"
                  ]
                },
                "recordCount": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 20000
                },
                "segments": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                }
              }
            }
          },
          "quota": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "remainingCredits",
              "unit",
              "source",
              "quality",
              "reserved",
              "sufficientForPrimaryEstimate"
            ],
            "properties": {
              "remainingCredits": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "unit": {
                "type": "string",
                "enum": [
                  "SMS_SEGMENT_CREDIT"
                ]
              },
              "source": {
                "type": "string",
                "enum": [
                  "LEGACY_CRM_GET_NB_SMS_AVAILABLE"
                ]
              },
              "quality": {
                "type": "string",
                "enum": [
                  "OBSERVATION_WITH_KNOWN_LIMITATIONS"
                ]
              },
              "reserved": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "sufficientForPrimaryEstimate": {
                "type": "boolean",
                "nullable": true
              }
            }
          },
          "pricing": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "amountMinor",
              "currency",
              "availability"
            ],
            "properties": {
              "amountMinor": {
                "type": "integer",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "currency": {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              },
              "availability": {
                "type": "string",
                "enum": [
                  "UNAVAILABLE_NO_CANONICAL_TARIFF"
                ]
              }
            }
          },
          "source": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "readAt",
              "providerChecked",
              "queueCreated",
              "audienceReserved",
              "estimateOnly",
              "calculator",
              "providerAppendedContentIncluded"
            ],
            "properties": {
              "readAt": {
                "type": "string",
                "format": "date-time"
              },
              "providerChecked": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "queueCreated": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "audienceReserved": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "estimateOnly": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "calculator": {
                "type": "string",
                "enum": [
                  "NATIVE_GSM_PACKAGE_AND_WORKER_TAG_REMOVAL"
                ]
              },
              "providerAppendedContentIncluded": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            }
          },
          "sms": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "estimateHash",
              "catalogueVersion",
              "records",
              "unisoftUnits",
              "externalRecords",
              "unavailableRecords",
              "availableUnits",
              "remainingUnits"
            ],
            "properties": {
              "estimateHash": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "catalogueVersion": {
                "type": "string",
                "nullable": true
              },
              "records": {
                "type": "integer",
                "minimum": 0,
                "maximum": 2000
              },
              "unisoftUnits": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "externalRecords": {
                "type": "integer",
                "minimum": 0,
                "maximum": 2000
              },
              "unavailableRecords": {
                "type": "integer",
                "minimum": 0,
                "maximum": 2000
              },
              "availableUnits": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "nullable": true
              },
              "remainingUnits": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991,
                "nullable": true
              }
            }
          }
        }
      },
      "CampaignTemplateSendPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignTemplateSendPreview"
          }
        }
      },
      "CampaignTemplateSendPreview": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "campaignId",
          "contactId",
          "templateId",
          "recipientEmail",
          "subject",
          "emailConfigId",
          "revision",
          "channel",
          "independentOfBroadcast",
          "campaignStateChanged",
          "queued",
          "providerChecked",
          "templateFrozen",
          "readAt"
        ],
        "properties": {
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "contactId": {
            "type": "string",
            "format": "uuid"
          },
          "templateId": {
            "type": "string",
            "format": "uuid"
          },
          "recipientEmail": {
            "type": "string",
            "maxLength": 320
          },
          "subject": {
            "type": "string",
            "maxLength": 500
          },
          "emailConfigId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "channel": {
            "type": "string",
            "enum": [
              "EMAIL"
            ]
          },
          "independentOfBroadcast": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "campaignStateChanged": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "queued": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "providerChecked": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "templateFrozen": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "readAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "CampaignTemplateDeliveryResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "source"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/CampaignTemplateDelivery"
          },
          "source": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "readAt",
              "providerChecked"
            ],
            "properties": {
              "readAt": {
                "type": "string",
                "format": "date-time"
              },
              "providerChecked": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            }
          }
        }
      },
      "CampaignTemplateDelivery": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "deliveryId",
          "channel",
          "state",
          "recipient",
          "createdAt",
          "attemptedAt",
          "scheduledAt",
          "canceledAt",
          "smtpAcceptedAt",
          "deliveredReportAt",
          "deliveryUpdatedAt",
          "deliveryStatus",
          "whatsappAck",
          "whatsappAckAt",
          "reasonCode",
          "reasonAvailability",
          "deliveryUncertain",
          "simulation"
        ],
        "properties": {
          "deliveryId": {
            "type": "string",
            "format": "uuid"
          },
          "channel": {
            "type": "string",
            "enum": [
              "EMAIL",
              "SMS",
              "WHATSAPP",
              "NOTIFICATION",
              "APPMOBILE_NOTIFICATION",
              "UNKNOWN"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "INIT",
              "SUCCESS",
              "ERROR",
              "CANCELED",
              "UNKNOWN"
            ]
          },
          "recipient": {
            "$ref": "#/components/schemas/CampaignTemplateRecipient"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "attemptedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "canceledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "smtpAcceptedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "deliveredReportAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "deliveryUpdatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "deliveryStatus": {
            "type": "string",
            "nullable": true,
            "enum": [
              "ACCEPTED",
              "DELIVERED",
              "RELAYED",
              "EXPANDED",
              "DELAYED",
              "ERROR",
              "UNKNOWN",
              null
            ],
            "description": "Statut email enregistré uniquement, sans interrogation fournisseur. ACCEPTED est une acceptation SMTP ; DELIVERED est un rapport positif de livraison conservé, sans preuve de placement en boîte ni de lecture. null signifie absent, invalide ou ligne hors email."
          },
          "whatsappAck": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4,
            "nullable": true,
            "description": "Accusé WhatsApp enregistré uniquement : le consommateur courant interprète 1 comme envoyé, 2 comme reçu et 3 ou plus comme lu. Aucun nouvel accusé n’est demandé ; null signifie indisponible ou non pris en charge."
          },
          "whatsappAckAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "reasonCode": {
            "type": "string",
            "nullable": true,
            "enum": [
              "API_PHONE_BAD_COUNTRY",
              "API_PHONE_BAD_FORMAT",
              "API_EMAIL_BAD_FORMAT",
              "API_EMAIL_UNSUBSCRIBE",
              "MAILER_BAD_CONFIG",
              "MAILER_INVALID_RETRY",
              "MAILER_MAX_ATTEMPTS",
              "MAILER_INVALID_ID",
              "MAILER_DELIVERY_UNCERTAIN",
              "DELIVERY_REPORT_FAILED",
              "USER_EMERGENCY_STOP",
              "SMS_TEST_MODE",
              "SMS_CONFIGURATION_ERROR",
              "INVALID_PHONE_NUMBER",
              "SMS_NOT_AVAILABLE",
              "EMPTY_MESSAGE",
              "SMS_QUOTA_EXCEEDED",
              "WHATSAPP_SEND_ERROR",
              "INVALID_WHATSAPP_NUMBER",
              "WHATSAPP_NUMBER_BLOCKED",
              "WHATSAPP_ACCOUNT_NOT_READY",
              "WHATSAPP_NO_ACCOUNT",
              "WHATSAPP_MEDIA_FAILED",
              "WHATSAPP_TEXT_FAILED",
              null
            ],
            "description": "Uniquement errorCode ou stopReason enregistré et présent dans la liste blanche. null indique l’absence de motif connu publiable, sans signifier absence d’échec. Les diagnostics fournisseur bruts, réponses SMTP et errorMessage ne sont jamais exposés."
          },
          "reasonAvailability": {
            "type": "string",
            "enum": [
              "KNOWN_CODE",
              "UNAVAILABLE"
            ]
          },
          "deliveryUncertain": {
            "type": "boolean",
            "nullable": true,
            "enum": [
              true,
              null
            ],
            "description": "true lorsqu’un marqueur explicite d’incertitude ou MAILER_DELIVERY_UNCERTAIN est enregistré. Sinon null ; son absence ne prouve ni la non-livraison ni qu’un nouvel essai soit sûr."
          },
          "simulation": {
            "type": "boolean",
            "nullable": true
          }
        }
      },
      "CampaignTemplateRecipient": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "contactId",
          "identityStatus",
          "firstName",
          "lastName",
          "email",
          "phone"
        ],
        "properties": {
          "contactId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "identityStatus": {
            "type": "string",
            "enum": [
              "CURRENT_CONTACT_REFERENCE",
              "SNAPSHOT_ONLY",
              "UNAVAILABLE"
            ],
            "description": "CURRENT_CONTACT_REFERENCE signifie que l’UUID de contact enregistré a été réadmis dans l’organisation courante. SNAPSHOT_ONLY indique qu’aucune référence de contact n’était enregistrée. UNAVAILABLE masque l’identité lorsqu’une référence est invalide, supprimée ou étrangère. Les noms et coordonnées sont des instantanés historiques de l’envoi, sans actualisation depuis le contact."
          },
          "firstName": {
            "type": "string",
            "nullable": true,
            "maxLength": 200
          },
          "lastName": {
            "type": "string",
            "nullable": true,
            "maxLength": 200
          },
          "email": {
            "type": "string",
            "nullable": true,
            "maxLength": 320
          },
          "phone": {
            "type": "string",
            "nullable": true,
            "maxLength": 32
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
