> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Vídeo

> Envia um vídeo

Envia um vídeo para um contato ou grupo. Suporta URL ou base64.

## Request Body

<ParamField body="sessionId" type="string" required>
  ID da sessão que enviará a mensagem.
</ParamField>

<ParamField body="to" type="string" required>
  Destinatário (número com DDI ou JID).
</ParamField>

<ParamField body="video" type="string" required>
  URL do vídeo ou conteúdo em base64.

  **Formatos suportados:** MP4, 3GP, MOV

  **Tamanho máximo:** 64 MB
</ParamField>

<ParamField body="caption" type="string">
  Legenda do vídeo (opcional).
</ParamField>

<ParamField body="gifPlayback" default="false" type="boolean">
  Enviar como GIF (vídeo em loop sem áudio).
</ParamField>

<ParamField body="viewOnce" default="false" type="boolean">
  Vídeo que desaparece após ser visualizado.
</ParamField>

<ParamField body="quoted" type="object">
  Responder a uma mensagem específica.
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/messages/video" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "to": "5511999999999",
      "video": "https://exemplo.com/video.mp4",
      "caption": "Veja nosso novo produto!"
    }'
  ```

  ```typescript TypeScript theme={"system"}
  const message = await client.messages.sendVideo(sessionId, {
    to: '5511999999999',
    video: 'https://exemplo.com/video.mp4',
    caption: 'Veja nosso novo produto!',
  });
  ```

  ```python Python theme={"system"}
  message = client.messages.send_video(
      session_id,
      to='5511999999999',
      video='https://exemplo.com/video.mp4',
      caption='Veja nosso novo produto!'
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "messageId": "3EB0ABC123DEF456789GHI",
    "status": "sent",
    "to": "5511999999999@s.whatsapp.net",
    "timestamp": "2024-01-15T10:30:00.000Z"
  }
  ```

  ```json 400 Bad Request theme={"system"}
  {
    "statusCode": 400,
    "error": "MEDIA_TOO_LARGE",
    "message": "Arquivo excede o limite de 64MB"
  }
  ```
</ResponseExample>

## Enviar como GIF

Para enviar um vídeo curto como GIF animado (sem som, em loop):

```json theme={"system"}
{
  "sessionId": "...",
  "to": "5511999999999",
  "video": "https://exemplo.com/animacao.mp4",
  "gifPlayback": true
}
```

<Note>
  Vídeos enviados como GIF devem ser curtos (até 6 segundos) e terão o áudio removido automaticamente.
</Note>