# Enviar mensagem de música

`POST /send/music`

Pasta: **Enviar Mensagem**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Enviar mensagem de música

Envia uma mensagem de música (Message.musicMessage) no chat, estilo compartilhamento de faixa/música.

## Endpoint

```http
POST {{baseUrl}}/send/music
```

## Autenticação

Envie o token da instância no header:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| chatid | string | Sim* | Destinatário (JID ou número) — use `chatid` ou `number` |
| number | string | Não* | Destinatário como número puro |
| songUri | string | Sim | URL absoluta do áudio/música |
| artworkUri | string | Não | URL da capa/artwork da música |
| title | string | Não | Título da música |
| author | string | Não | Artista/autor |
| explicit | bool | Não | Indicar conteúdo explícito (padrão: false) |
| style | string | Não | Estilo do card: `vinyl` (padrão) / `default` |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/music" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"chatid": "{{remoteJid}}", "songUri": "https://cdn.exemplo.com/song.m4a", "artworkUri": "https://cdn.exemplo.com/cover.jpg", "title": "Nome da Música", "author": "Artista", "style": "vinyl"}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": {
    "id": "3EB0CCC333",
    "timestamp": "2026-08-07T12:34:56Z"
  }
}
```

## Erros comuns

- destinatário ausente (`chatid`/`number`)
- nem `title` nem `songUri` fornecidos
- `style` inválido (apenas `vinyl` suportado por enquanto)

## Observações

- `songUri`/`artworkUri` são URLs públicas; nenhum upload local é feito.
- Ao receber, a API classifica como `MessageType=music` e exibe o conteúdo como "Artista — Música".
- Suportado em instâncias Web e Mobile (inclui fila async `/send/music`).

## Corpo (exemplo)

```json
{
  "chatid": "{{remoteJid}}",
  "songUri": "https://cdn.exemplo.com/song.m4a",
  "artworkUri": "https://cdn.exemplo.com/cover.jpg",
  "title": "Nome da Música",
  "author": "Artista",
  "style": "vinyl",
  "explicit": false
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/music" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "chatid": "{{remoteJid}}",
  "songUri": "https://cdn.exemplo.com/song.m4a",
  "artworkUri": "https://cdn.exemplo.com/cover.jpg",
  "title": "Nome da Música",
  "author": "Artista",
  "style": "vinyl",
  "explicit": false
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/enviar-mensagem-de-musica)