# API SMS

import { Badge } from '@astrojs/starlight/components';

<Aside type="caution" title="/createSMSMessage est obsolète">
Les nouvelles intégrations doivent utiliser l'[API de Messagerie v2](/fr/developer/api-reference/messaging-api-v2/) — passez `platforms: ["SMS"]` à `Notify`. Consultez le [guide de migration](/fr/developer/api-reference/messaging-api-v2/migration-from-v1/#from-createsmsmessage).
</Aside>

<Aside type="note">
Avant d'envoyer des messages SMS, connectez votre fournisseur SMS dans le Panneau de Contrôle. [En savoir plus](/fr/developer/first-steps/connect-messaging-services/sms-configuration/)
</Aside>

## createSMSMessage <Badge text="Obsolète" variant="caution" size="small" />

Utilisé pour envoyer des notifications SMS aux utilisateurs

POST `https://api.pushwoosh.com/json/1.3/createSMSMessage`

### Corps de la requête

| Nom                            | Requis | Type    | Description                                                                                                  |
|--------------------------------|--------|---------|--------------------------------------------------------------------------------------------------------------|
| **auth***                      | Oui    | string  | [Jeton d'accès API](/fr/developer/api-reference/api-identifiers/#api-access-token) depuis le Panneau de Contrôle Pushwoosh.                                                               |
| **application***               | Oui    | string  | [Code d'application Pushwoosh](/fr/developer/api-reference/api-identifiers/#application-code)                                                                                 |
| **notifications***             | Oui    | array   | Paramètres de contenu. Tableau JSON des paramètres de message. Voir les détails ci-dessous.                                       |

**Paramètres de notification**

| Nom                              | Requis | Type    | Description                                                                                                                                                                                   |
|----------------------------------|--------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **send_date***                   | Oui    | string  | Date et heure d'envoi de la notification. Utilisez le format `AAAA-MM-JJ HH:mm` ou `now` pour un envoi immédiat.                                                                                           |
| **content***                     | Oui    | string  | Contenu textuel du message SMS.                                                                                                                                                              |
| **devices***                     | Oui    | array   | Numéro de téléphone du client (doit être associé à un UserId en utilisant `/registerDevice` et spécifié dans le paramètre `hwid` ou utiliser `use_auto_registration`). Un seul numéro peut être spécifié ici. |
| **use_auto_registration**        | Non    | boolean | Si défini sur `true`, le numéro de téléphone spécifié dans le paramètre `devices` sera automatiquement enregistré.                                                                                      |
| **dynamic_content_placeholders** | Non    | object  | Espaces réservés de contenu dynamique pour personnaliser le contenu du message. Chaque espace réservé sera remplacé par les valeurs dynamiques correspondantes.                                                           |
| **preset**                       | Non    | string  | [Code de préréglage](/fr/developer/api-reference/api-identifiers/#preset-code) SMS de votre Panneau de Contrôle.                                                                                                                                                      |

### Exemple de requête

```json
{
  "request": {
    "application": "12345-67891",    // requis. Code d'application Pushwoosh.
    "auth": "yxoPUlwqm…………pIyEX4H",  // requis. Jeton d'accès API depuis le Panneau de Contrôle Pushwoosh.
    "notifications": [{
      "send_date": "now",            // requis. AAAA-MM-JJ HH:mm OU "now".
      "content": "Bonjour !",           // requis. Texte du SMS (chaîne de caractères).
      "devices": ["+1234567890"],    // requis. Numéro de téléphone du client (doit être associé à
                                     //           un UserId en utilisant /registerDevice et spécifié dans
                                     //           le paramètre "hwid" ou utiliser "use_auto_registration").
                                     //           Un seul numéro peut être spécifié ici.
      "preset": "XXXXX-XXXXX",       // optionnel. Code de préréglage SMS de votre Panneau de Contrôle.
      "use_auto_registration": true  // optionnel. Enregistre automatiquement le numéro de téléphone spécifié
                                     //           dans le paramètre "devices".
    }]
  }
}
```

### Exemple de réponse

```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "9648-0B10ECB6-0D9F214D"
    ]
  }
}
```

### Réponse d'erreur
```json
{
  "status_code": 210,
  "status_message": "Invalid devices list. \"devices\" must be an array.",
  "response": {
    "Messages": []
  }
}
```

<Aside type="note">
 Actuellement, chaque SMS doit être envoyé dans une requête distincte pour chaque client.
</Aside>

Pour obtenir les statistiques SMS, utilisez la méthode [totalsByIntervals](/fr/developer/api-reference/statistics-api/message-statistics-api/#totalsbyintervals).

Vous pouvez également consulter les statistiques pour chaque message dans la section [Historique des messages](/fr/product/statistics-and-analytics/message-history/).

<Aside type="caution">
Veuillez noter que certains opérateurs mobiles ne transmettent pas les données de statut de livraison, les statistiques peuvent donc être imprécises. Vous pouvez vérifier les détails auprès des opérateurs mobiles qui fournissent des numéros à vos clients.
</Aside>