# Mensagens de vídeo no WhatsApp

Uma mensagem de vídeo carrega uma URL pública que o WhatsApp busca no momento do envio, com uma legenda opcional abaixo dela.

## Enviar um vídeo

Defina `video.url`:

**TypeScript**

```typescript
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  video: { url: "https://cdn.example.com/unboxing.mp4" },
});
console.log(msg.id, msg.status);
```

Examples: [TypeScript](/pt-br/documentacao/guides/whatsapp/message-types/video.ts.md) · [Python](/pt-br/documentacao/guides/whatsapp/message-types/video.py.md) · [Go](/pt-br/documentacao/guides/whatsapp/message-types/video.go.md) · [PHP](/pt-br/documentacao/guides/whatsapp/message-types/video.php.md) · [CLI](/pt-br/documentacao/guides/whatsapp/message-types/video.cli.md) · [MCP](/pt-br/documentacao/guides/whatsapp/message-types/video.mcp.md) · [cURL](/pt-br/documentacao/guides/whatsapp/message-types/video.curl.md)

A forma completa adiciona um `caption` opcional:

```json
{
  "to": "+16505551234",
  "from": "+13124495648",
  "video": {
    "url": "https://cdn.example.com/unboxing.mp4",
    "caption": "How to set it up"
  }
}
```

`video` não tem o campo `filename`. `from` é obrigatório em toda mensagem de serviço: um número que seu espaço de trabalho possui, não um gerenciado pelo Bird.

## Limites

| Campo              | Limite                                        | Aplicado por                      |
| ------------------ | --------------------------------------------- | --------------------------------- |
| Tamanho do arquivo | 16 MB                                         | apenas WhatsApp, no fetch (async) |
| Formato            | Container MP4, vídeo H.264, áudio AAC         | apenas WhatsApp, no fetch (async) |
| `caption`          | até 1.024 caracteres                          | Bird, no accept (`422`)           |
| `url`              | absoluta, `https`, com host, sem espaço bruto | Bird, no accept (`422`)           |

Bird verifica o formato da URL e o comprimento da legenda antes de qualquer enfileiramento. Não verifica o tamanho real do arquivo, o container ou o codec; apenas o fetch do próprio WhatsApp no momento do envio pode fazer isso. Consulte [envio de mídia por URL](/docs/guides/whatsapp/message-types#sending-media-by-url) e [quando a mídia falha](/docs/guides/whatsapp/message-types#when-media-fails) no hub.

## Lendo um vídeo recebido

Um vídeo recebido carrega o mesmo objeto `video`, mais um `id` e `mime_type` que Bird aprendeu ao buscar o arquivo. Ambos estão ausentes em uma releitura de saída, já que Bird nunca buscou o arquivo que enviou. Consulte [Recebendo vídeo no WhatsApp](/docs/guides/whatsapp/receiving-whatsapp/video) para a leitura completa de entrada, o payload `whatsapp.received` e o que observar.

## Limites e modos de falha

- **A janela de atendimento ao cliente precisa estar aberta.** Vídeo é uma mensagem de serviço, entregável apenas dentro de uma janela aberta; consulte a [janela de atendimento ao cliente](/docs/guides/whatsapp/message-types#the-customer-service-window) no hub.
- **Bird rejeita `http`; o próprio WhatsApp faria o fetch.** Consulte [envio de mídia por URL](/docs/guides/whatsapp/message-types#sending-media-by-url) no hub para a verificação completa de formato.
- **Um fetch rejeitado ainda é cobrado.** Consulte [quando a mídia falha](/docs/guides/whatsapp/message-types#when-media-fails) no hub para `media_rejected` e o fato da cobrança em caso de falha. O texto de rejeição de vídeo do WhatsApp não foi medido de forma independente como o de imagem, então trate o mapeamento como inferido por simetria, e não confirmado por causa.
- **WhatsApp armazena em cache uma URL buscada por cerca de 10 minutos.** Reenviar a mesma URL dentro dessa janela re-serve o primeiro fetch; altere a URL para forçar um novo.
- **Um GIF animado não é um tipo distinto.** WhatsApp não tem um tipo de mensagem `gif`; um GIF animado que você envia chega ao destinatário, e chegaria de volta para você como recebido, como um `video` comum com tipo MIME MP4.

## Próximos passos

- [Mensagens de serviço no WhatsApp](/docs/guides/whatsapp/message-types): a janela de atendimento ao cliente e o modelo que toda mensagem de serviço compartilha
- [Imagens](/docs/guides/whatsapp/message-types/images): o mesmo formato para uma foto ou gráfico
- [Áudio](/docs/guides/whatsapp/message-types/audio): para uma nota de voz ou clipe de áudio
- [Enviando mensagens no WhatsApp](/docs/guides/whatsapp/sending-whatsapp): o envelope da solicitação, o modelo `202` e tentativas seguras de reenvio

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)