# Envois groupés

> Index de la documentation : https://wahasend.com/docs/fr/llms.txt · Tout en un fichier : https://wahasend.com/docs/fr.md · URL de base de l'API : https://app.wahasend.com/api/v1

Le même texte à 500 personnes max en un appel. Inclus dans **Notify**, **Developer** et **Connect** (fonction `batch`). Pour des textes personnalisés et programmés, utilisez les [campagnes](https://wahasend.com/docs/fr/api/campaigns.md).

<a id="alert-batch"></a>

### Envoyer un texte à plusieurs

`POST /api/v1/alert/batch`

Vérifie chaque numéro sur WhatsApp, saute ceux qui n'y sont pas et met en file un message par destinataire restant.

- Débloqué par: Notify, Developer, Connect (`batch`)
- Clé de numéro : oui

> Envoyer le même texte à beaucoup de gens qui ne l'ont pas demandé est le moyen le plus rapide de faire bloquer un numéro. Voir [Bonnes pratiques](https://wahasend.com/docs/fr/good-practice.md).

**Corps de la requête**

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `recipients` | string[] | oui | 1 à 500 numéros ou identifiants `@lid`. |
| `message` | string | oui | 1 à 4096 caractères. |
| `priority` | "high" \| "normal" \| "low" | non | Par défaut `normal`. |
| `skipInvalidNumbers` | boolean | non | Par défaut `true` : les numéros absents de WhatsApp sont sautés et listés dans `invalidNumbers`. `false` : si un numéro n'est pas sur WhatsApp, rien n'est envoyé (`NUMBER_NOT_ON_WHATSAPP` avec `details.invalidNumbers`). |
| `containerId` | uuid | non | Lequel de vos numéros WhatsApp utiliser ; il l'emporte toujours. Par défaut : votre numéro par défaut (sinon un numéro connecté), ou un numéro du groupe quand [plusieurs numéros](https://wahasend.com/docs/fr/phone-numbers.md#several-numbers) est activé. Ignoré avec une clé de numéro, qui utilise toujours son numéro. |

**Exemple**

curl:

```bash
curl -X POST https://app.wahasend.com/api/v1/alert/batch \
  -H "X-API-Key: $WAHASEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "recipients": [
    "+22212345678",
    "+22287654321"
  ],
  "message": "We are closed on Friday for the holiday."
}'
```

JavaScript:

```js
const res = await fetch('https://app.wahasend.com/api/v1/alert/batch', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.WAHASEND_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "recipients": [
      "+22212345678",
      "+22287654321"
    ],
    "message": "We are closed on Friday for the holiday."
  }),
});
const data = await res.json();
```

Python:

```python
import os
import requests

r = requests.post(
    "https://app.wahasend.com/api/v1/alert/batch",
    headers={"X-API-Key": os.environ["WAHASEND_API_KEY"]},
    json={
        "recipients": [
            "+22212345678",
            "+22287654321",
        ],
        "message": "We are closed on Friday for the holiday.",
    },
)
print(r.json())
```

**Réponse 201**

```json
{
  "success": true,
  "count": 1,
  "messages": [
    {
      "phone": "22212345678",
      "messageId": "4f0c6a1e-2b7d-4c1a-9e35-7d8f2a6b1c90",
      "containerId": "6d2b9c1e-8f4a-4e37-a5c2-1b9e7d3f0a64"
    }
  ],
  "invalidNumbers": [
    "22287654321"
  ],
  "skipped": 1
}
```

**Erreurs possibles**

- [`VALIDATION_ERROR`](https://wahasend.com/docs/fr/errors.md#validation_error) (400): Validation failed. Check the details for specific field errors.
- [`NO_VALID_NUMBERS`](https://wahasend.com/docs/fr/errors.md#no_valid_numbers) (400): None of these numbers are on WhatsApp.
- [`NUMBER_NOT_ON_WHATSAPP`](https://wahasend.com/docs/fr/errors.md#number_not_on_whatsapp) (400): This number is not on WhatsApp.
- [`NUMBER_VALIDATION_UNAVAILABLE`](https://wahasend.com/docs/fr/errors.md#number_validation_unavailable) (503): Numbers cannot be checked right now. Try again shortly.
- [`NO_SESSION_CONFIGURED`](https://wahasend.com/docs/fr/errors.md#no_session_configured) (400): This account has no connected WhatsApp number.