# API de SMS

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

<Aside type="caution" title="/createSMSMessage está obsoleto">
Las nuevas integraciones deben usar la [API de Mensajería v2](/es/developer/api-reference/messaging-api-v2/) — pase `platforms: ["SMS"]` a `Notify`. Consulte la [guía de migración](/es/developer/api-reference/messaging-api-v2/migration-from-v1/#from-createsmsmessage).
</Aside>

<Aside type="note">
Antes de enviar mensajes SMS, conecte a su proveedor de SMS en el Panel de Control. [Aprenda más](/es/developer/first-steps/connect-messaging-services/sms-configuration/)
</Aside>

## createSMSMessage <Badge text="Obsoleto" variant="caution" size="small" />

Se utiliza para enviar notificaciones por SMS a los usuarios

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

### Cuerpo de la solicitud

| Nombre | Requerido | Tipo | Descripción |
|---|---|---|---|
| **auth*** | Sí | string | [Token de acceso a la API](/es/developer/api-reference/api-identifiers/#api-access-token) del Panel de Control de Pushwoosh. |
| **application*** | Sí | string | [Código de aplicación de Pushwoosh](/es/developer/api-reference/api-identifiers/#application-code) |
| **notifications*** | Sí | array | Configuración de contenido. Array JSON de parámetros de mensaje. Vea los detalles a continuación. |

**Parámetros de notificación**

| Nombre | Requerido | Tipo | Descripción |
|---|---|---|---|
| **send_date*** | Sí | string | Fecha y hora para enviar la notificación. Use el formato `YYYY-MM-DD HH:mm` o `now` para enviar inmediatamente. |
| **content*** | Sí | string | Contenido de texto del mensaje SMS. |
| **devices*** | Sí | array | Número de teléfono del cliente (debe estar asociado con un UserId usando `/registerDevice` y especificado en el parámetro `hwid` o usar `use_auto_registration`). Solo se puede especificar un número aquí. |
| **use_auto_registration** | No | boolean | Si se establece en `true`, el número de teléfono especificado en el parámetro `devices` se registrará automáticamente. |
| **dynamic_content_placeholders** | No | object | Marcadores de posición de contenido dinámico para personalizar el contenido del mensaje. Cada marcador de posición será reemplazado con los valores dinámicos correspondientes. |
| **preset** | No | string | [Código de Preset](/es/developer/api-reference/api-identifiers/#preset-code) de SMS de su Panel de Control. |

### Ejemplo de solicitud

```json
{
  "request": {
    "application": "12345-67891",    // requerido. Código de aplicación de Pushwoosh.
    "auth": "yxoPUlwqm…………pIyEX4H",  // requerido. Token de acceso a la API del Panel de Control de Pushwoosh.
    "notifications": [{
      "send_date": "now",            // requerido. YYYY-MM-DD HH:mm O "now".
      "content": "Hello!",           // requerido. Texto del SMS (string).
      "devices": ["+1234567890"],    // requerido. Número de teléfono del cliente (debe estar asociado con
                                     //           un UserId usando /registerDevice y especificado en
                                     //           el parámetro "hwid" o usar "use_auto_registration").
                                     //           Solo se puede especificar un número aquí.
      "preset": "XXXXX-XXXXX",       // opcional. Código de Preset de SMS de su Panel de Control.
      "use_auto_registration": true  // opcional. Registrar automáticamente el número de teléfono especificado
                                     //           en el parámetro "devices".
    }]
  }
}
```

### Ejemplo de respuesta

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

### Respuesta de error
```json
{
  "status_code": 210,
  "status_message": "Invalid devices list. \"devices\" must be an array.",
  "response": {
    "Messages": []
  }
}
```

<Aside type="note">
Actualmente, cada SMS debe enviarse en una solicitud separada para cada cliente.
</Aside>

Para obtener estadísticas de SMS, utilice el método [totalsByIntervals](/es/developer/api-reference/statistics-api/message-statistics-api/#totalsbyintervals).

También puede ver las estadísticas de cada mensaje en la sección [Historial de mensajes](/es/product/statistics-and-analytics/message-history/).

<Aside type="caution">
Tenga en cuenta que algunos operadores de telefonía móvil no transmiten datos sobre el estado de la entrega, por lo que es posible que las estadísticas no sean del todo precisas. Puede consultar los detalles con los operadores de telefonía móvil que proporcionan números a sus clientes.
</Aside>