> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/users/xuid({xuid})/outbox)

> POST (/users/xuid({xuid})/outbox)

# POST (/users/xuid({xuid})/outbox)

Envía un mensaje especificado a una lista de destinatarios.
El dominio de estos URI es `msg.xboxlive.com`.

* [Comentarios](#ID4EV)
* [Parámetros de URI](#ID4EAB)
* [Autorización](#ID4ENB)
* [Efecto de la configuración de privacidad en el recurso](#ID4EYB)
* [Cuerpo de la solicitud](#ID4E3F)
* [Códigos de estado HTTP](#ID4ETCAC)
* [Cuerpo de la respuesta](#ID4E1EAC)

## Comentarios

El único tipo de contenido que admite esta API es "application/json", que es obligatorio en los encabezados HTTP de cada llamada.

## Parámetros de URI

| Parámetro | Tipo | Descripción |
| - | - | - |
| xuid | entero de 64 bits sin signo | Identificador de usuario de XBOX (XUID) del jugador que realiza la solicitud. |

## Autorización

Debe tener su propia notificación de usuario y una suscripción gold válida para enviar un mensaje de usuario.

## Efecto de la configuración de privacidad en el recurso

Enviar correctamente un mensaje de usuario a un jugador, tanto si ese jugador es amigo como si no, da como resultado un código de resultado de 200. Sin embargo, si envía un mensaje a alguien que le ha bloqueado, el destinatario no recibirá el mensaje y usted no recibirá ninguna indicación de que el mensaje no se envió correctamente.

También hay límites en cuanto al número de mensajes que se pueden enviar por día y a cuántos amigos y no amigos, como se indica a continuación.

* 20 desconocidos por mensaje
* 200 desconocidos por 24 horas
* 250 mensajes en total por 24 horas
* 2500 destinatarios en total por 24 horas

\| Usuario solicitante| Configuración de privacidad del usuario de destino| Comportamiento|
\| --- | --- | --- | --- | --- | --- |
\| yo| -| Como se describe.|
\| amigo| todos| 200 OK|
\| amigo| solo amigos| 200 OK|
\| amigo| bloqueado| 200 OK|
\| usuario no amigo| todos| 200 OK|
\| usuario no amigo| solo amigos| 200 OK|
\| usuario no amigo| bloqueado| 200 OK|
\| sitio de terceros| todos| 200 OK|
\| sitio de terceros| solo amigos| 200 OK|
\| sitio de terceros| bloqueado| 200 OK|

## Cuerpo de la solicitud

| Propiedad | Tipo | Longitud máxima | Consumidores | Comentarios |
| - | - | - | - | - |
| header | Header | | Todos | Encabezado del mensaje de usuario |
| messageText | string | 250 | Todas las plataformas excepto Windows 8 | Texto del mensaje de usuario (UTF-8) |

#### Header

| Propiedad | Tipo | Longitud máxima | Consumidores | Comentarios |
| - | - | - | - | - |
| recipients | User\[] | 20 | Todos | Lista de destinatarios del mensaje |

#### User

| Propiedad | Tipo | Longitud máxima | Consumidores | Comentarios |
| - | - | - | - | - |
| xuid | ulong | | Todos | XUID del destinatario. No se usa si se envía el gamertag. |
| gamertag | string | 15 | Todos | Gamertag del destinatario. No se usa si se envía el XUID. |

#### Cuerpo de solicitud de ejemplo

```cpp theme={null}
{
          "header":
          {
            "recipients":
            [{"gamertag":"GoTeamEmily"},
            {"gamertag":"Longstreet360"}]
          },
          "messageText":"random user text"
        }

```

## Códigos de estado HTTP

El servicio devuelve uno de los códigos de estado de esta sección en respuesta a una solicitud realizada con este método en este recurso. Para obtener una lista completa de los códigos de estado HTTP estándar que se usan con los servicios de XBOX Live, consulte [Códigos de estado HTTP estándar](https://devdocs.xbox.com/es/reference/live/rest/additional/httpstatuscodes).

\| Código| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| Correcto.|
\| 400| La lista de destinatarios está vacía o supera la longitud máxima; o se especificaron tanto el gamertag como el XUID; o messageText es demasiado largo.|
\| 403| El XUID no se puede convertir.|
\| 404| El gamertag no es válido o no se encuentra el usuario.|
\| 409| El usuario ha alcanzado el límite diario impuesto por el sistema.|
\| 500| Error general del lado servidor.|

## Cuerpo de la respuesta

No se envía ningún objeto en el cuerpo de la respuesta.

## Consulte también

##### Elemento primario

[/users/xuid({xuid})/outbox](https://devdocs.xbox.com/es/reference/live/rest/uri/users/uri-usersxuidoutbox)

##### Referencia  [Códigos de estado HTTP estándar](https://devdocs.xbox.com/es/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblSocialSubmitReputationFeedbackAsync](https://devdocs.xbox.com/fr-CA/reference/live/xsapi-c/social_c/functions/xblsocialsubmitreputationfeedbackasync.md)
- [XblAchievementsManagerUpdateAchievement](https://devdocs.xbox.com/es/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)