> ## 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)

Envia uma mensagem especificada para uma lista de destinatários.
O domínio desses URIs é `msg.xboxlive.com`.

* [Comentários](#ID4EV)
* [Parâmetros de URI](#ID4EAB)
* [Autorização](#ID4ENB)
* [Efeito das configurações de privacidade no recurso](#ID4EYB)
* [Corpo da solicitação](#ID4E3F)
* [Códigos de status HTTP](#ID4ETCAC)
* [Corpo da resposta](#ID4E1EAC)

<a id="ID4EV" />

## Comentários

O único tipo de conteúdo compatível com esta API é "application/json", que é obrigatório nos cabeçalhos HTTP de cada chamada.

<a id="ID4EAB" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| xuid | inteiro de 64 bits sem sinal | A ID de usuário do XBOX (XUID) do jogador que está fazendo a solicitação. |

<a id="ID4ENB" />

## Autorização

Você deve ter sua própria declaração de usuário e uma assinatura gold válida para enviar uma mensagem de usuário.

<a id="ID4EYB" />

## Efeito das configurações de privacidade no recurso

Enviar com êxito uma mensagem de usuário para um jogador, seja ele amigo ou não, resulta em um código de resultado 200. No entanto, se você enviar uma mensagem para alguém que bloqueou você, o destinatário não receberá a mensagem e você não receberá nenhuma indicação de que sua mensagem não foi bem-sucedida.

Também há limites para quantas mensagens podem ser enviadas por dia e para quantos amigos e não amigos, conforme a seguir.

* 20 desconhecidos por mensagem
* 200 desconhecidos a cada 24 horas
* 250 mensagens no total a cada 24 horas
* 2500 destinatários no total a cada 24 horas

\| Usuário solicitante| Configuração de privacidade do usuário de destino| Comportamento|
\| --- | --- | --- | --- | --- | --- |
\| eu| -| Conforme descrito.|
\| amigo| todos| 200 OK|
\| amigo| somente amigos| 200 OK|
\| amigo| bloqueado| 200 OK|
\| usuário não amigo| todos| 200 OK|
\| usuário não amigo| somente amigos| 200 OK|
\| usuário não amigo| bloqueado| 200 OK|
\| site de terceiros| todos| 200 OK|
\| site de terceiros| somente amigos| 200 OK|
\| site de terceiros| bloqueado| 200 OK|

<a id="ID4E3F" />

## Corpo da solicitação

| Propriedade | Tipo | Comprimento máximo | Consumidores | Comentários |
| - | - | - | - | - |
| header | Header | | Todos | Cabeçalho da mensagem de usuário |
| messageText | string | 250 | Todas as plataformas, exceto Windows 8 | Texto da mensagem de usuário (UTF-8) |

#### Header

| Propriedade | Tipo | Comprimento máximo | Consumidores | Comentários |
| - | - | - | - | - |
| recipients | User\[] | 20 | Todos | Lista de destinatários da mensagem |

#### User

| Propriedade | Tipo | Comprimento máximo | Consumidores | Comentários |
| - | - | - | - | - |
| xuid | ulong | | Todos | XUID do destinatário. Não usado se o gamertag for enviado. |
| gamertag | string | 15 | Todos | Gamertag do destinatário. Não usado se a XUID for enviada. |

#### Exemplo de corpo da solicitação

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

```

<a id="ID4ETCAC" />

## Códigos de status HTTP

O serviço retorna um dos códigos de status nesta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com os XBOX Live Services, consulte [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes).

\| Código| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| Êxito.|
\| 400| A lista de destinatários está vazia ou excede o comprimento máximo; ou gamertag e XUID foram especificados; ou messageText é muito longo.|
\| 403| A XUID não pode ser convertida.|
\| 404| O gamertag é inválido ou o usuário não pode ser encontrado.|
\| 409| O usuário atingiu o limite diário imposto pelo sistema.|
\| 500| Erro geral do lado do servidor.|

<a id="ID4E1EAC" />

## Corpo da resposta

Nenhum objeto é enviado no corpo da resposta.

<a id="ID4EJFAC" />

## Confira também

<a id="ID4ELFAC" />

##### Pai

[/users/xuid({xuid})/outbox](/pt-BR/reference/live/rest/uri/users/uri-usersxuidoutbox)

<a id="ID4EZFAC" />

##### Referência  [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblSocialSubmitReputationFeedbackAsync](/fr-CA/reference/live/xsapi-c/social_c/functions/xblsocialsubmitreputationfeedbackasync.md)
- [XblAchievementsManagerUpdateAchievement](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)