# Enviar uma mensagem

Esta ação permite o envio de uma nova mensagem, bastando fornecer os parâmetros adequados.

## URL

/api/v1/send/message

## Acesso

É necessário autenticar-se como um servidor utilizando o header `X-Server-API-Key`. Se não for autorizado, será retornado um erro do tipo `AccessDenied`.

## Parâmetros

<table border="1" cellpadding="5" cellspacing="0" class="table paramTable" id="bkmrk-par%C3%A2metro-tipo-valor"><thead><tr><th width="40%">Parâmetro</th><th width="20%">Tipo</th><th width="20%">Valor Padrão</th><th width="20%">Descrição</th></tr></thead><tbody><tr><td><span class="paramTable__name">to</span></td><td>Array</td><td>null</td><td>Endereços de e-mail dos destinatários (máximo de 50).</td></tr><tr><td><span class="paramTable__name">cc</span></td><td>Array</td><td>null</td><td>Endereços de e-mail de cópia (máximo de 50).</td></tr><tr><td><span class="paramTable__name">bcc</span></td><td>Array</td><td>null</td><td>Endereços de e-mail em cópia oculta (máximo de 50).</td></tr><tr><td><span class="paramTable__name">from</span></td><td>String</td><td>null</td><td>Endereço de e-mail para o cabeçalho "From".</td></tr><tr><td><span class="paramTable__name">sender</span></td><td>String</td><td>null</td><td>Endereço de e-mail para o cabeçalho "Sender".</td></tr><tr><td><span class="paramTable__name">subject</span></td><td>String</td><td>null</td><td>Assunto do e-mail.</td></tr><tr><td><span class="paramTable__name">tag</span></td><td>String</td><td>null</td><td>Tag identificadora do e-mail.</td></tr><tr><td><span class="paramTable__name">reply\_to</span></td><td>String</td><td>null</td><td>Endereço de resposta (Reply-To).</td></tr><tr><td><span class="paramTable__name">plain\_body</span></td><td>String</td><td>null</td><td>Corpo do e-mail em texto puro.</td></tr><tr><td><span class="paramTable__name">html\_body</span></td><td>String</td><td>null</td><td>Corpo do e-mail em HTML.</td></tr><tr><td><span class="paramTable__name">attachments</span></td><td>Array</td><td>null</td><td>Lista de anexos a serem enviados com o e-mail.</td></tr><tr><td><span class="paramTable__name">headers</span></td><td>Hash</td><td>null</td><td>Hash de cabeçalhos adicionais personalizados.</td></tr><tr><td><span class="paramTable__name">bounce</span></td><td>Boolean</td><td>null</td><td>Indica se a mensagem é uma notificação de erro (bounce).</td></tr></tbody></table>

## Erros

<table border="1" cellpadding="5" cellspacing="0" class="table errorsTable" id="bkmrk-erro-atributos-valid"><thead><tr><th width="60%">Erro</th><th width="40%">Atributos</th></tr></thead><tbody><tr><td><span class="paramTable__name">ValidationError</span>  
Os dados fornecidos não foram suficientes para envio.</td><td>- errors
    
    Hash com detalhes dos campos inválidos.

</td></tr><tr><td><span class="paramTable__name">NoRecipients</span>  
Nenhum destinatário foi definido para a mensagem.</td><td> </td></tr><tr><td><span class="paramTable__name">NoContent</span>  
O conteúdo da mensagem está ausente.</td><td> </td></tr><tr><td><span class="paramTable__name">TooManyToAddresses</span>  
Limite máximo de destinatários "To" atingido (máx. 50).</td><td> </td></tr><tr><td><span class="paramTable__name">TooManyCCAddresses</span>  
Limite máximo de endereços "CC" atingido (máx. 50).</td><td> </td></tr><tr><td><span class="paramTable__name">TooManyBCCAddresses</span>  
Limite máximo de endereços "BCC" atingido (máx. 50).</td><td> </td></tr><tr><td><span class="paramTable__name">FromAddressMissing</span>  
O endereço "From" é obrigatório e está ausente.</td><td> </td></tr><tr><td><span class="paramTable__name">UnauthenticatedFromAddress</span>  
O endereço "From" não está autorizado neste servidor.</td><td> </td></tr><tr><td><span class="paramTable__name">AttachmentMissingName</span>  
Um dos anexos está sem nome definido.</td><td> </td></tr><tr><td><span class="paramTable__name">AttachmentMissingData</span>  
Um dos anexos está sem dados definidos.</td><td> </td></tr></tbody></table>

## Dados da Resposta

Esta ação retorna um Hash com os dados da mensagem enviada.

## Exemplo: Envio de mensagem padrão (JSON)

Este exemplo mostra como enviar uma mensagem utilizando corpo em texto simples e HTML, com o endpoint `/api/v1/send/message`.

```bash
curl -X POST https://app.sender25.com/api/v1/send/message \
  -H "Content-Type: application/json" \
  -H "X-Server-API-Key: SUA_CHAVE_AQUI" \
  -d '{
    "to": ["destinatario@exemplo.com"],
    "from": "remetente@seudominio.com",
    "subject": "Assunto do e-mail",
    "plain_body": "Texto simples do corpo",
    "html_body": "HTML do corpo"
  }'
```