> ## Documentation Index > Fetch the complete documentation index at: https://developers.datafyapi.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Enviar vídeo > Envie um vídeo por link público ou pelo ID de uma mídia enviada. Envia um vídeo, com legenda opcional, para um cliente com a [janela de 24 horas](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#janela-de-24-horas) aberta. > [!NOTE] > > O destinatário pode ser informado pelo **número de telefone** (`to`) ou pelo **ID do usuário** (`recipient`). Se os dois forem enviados, vale o `to`; para enviar pelo ID do usuário, deixe o `to` em branco. Veja a diferença em [Destinatário](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#destinatário). ## Link ou ID da mídia Informe o vídeo de uma das duas formas: | Campo | Quando usar | Como conseguir | | - | - | - | | `video.link` | O vídeo está em uma URL pública. | Envie o arquivo na aba **Mídias** do número, no [painel da Datafy](https://app.datafyapi.com.br). O link gerado vale por **30 dias**. | | `video.id` | Você já enviou o arquivo para a Meta. | Use o `id` retornado pelo endpoint [Upload de mídia](https://developers.datafyapi.com.br/api-reference/whatsapp/recursos/midia/upload-de-midia.md). | > [!WARNING] > > **Envie apenas um dos dois.** Com `link` e `id` na mesma requisição, a Meta recusa o envio. Para vídeos, a Meta recomenda usar o `id`, porque o envio fica mais rápido do que baixar o arquivo por link a cada mensagem. No **Testar**, o `link` já vem preenchido com um vídeo de exemplo. Para testar com um `id`, apague o `link` antes de enviar. ## Formatos aceitos | Formato | Extensão | Tipo MIME | Tamanho máximo | | - | - | - | - | | MP4 | `.mp4` | `video/mp4` | 16 MB | | 3GPP | `.3gp` | `video/3gpp` | 16 MB | O vídeo precisa usar o codec **H.264**, com perfil **Main** ou **Baseline**, e o áudio precisa ser **AAC** com no máximo uma faixa. Vídeos com perfil High e B-frames podem não reproduzir no WhatsApp para Android. > [!TIP] > > Se o vídeo não reproduzir, converta com o ffmpeg para o formato recomendado: > > ```bash theme={null} > ffmpeg -i entrada.mov -c:v libx264 -profile:v main -c:a aac -movflags +faststart saida.mp4 > ``` > > O `-movflags +faststart` coloca as informações do vídeo no início do arquivo, como a Meta recomenda. A legenda aceita até **1.024 caracteres** e a mesma [formatação do texto](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/enviar-texto.md#formatação). Veja mais detalhes na [documentação de mensagens de vídeo da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages). ## OpenAPI ````yaml api-reference/whatsapp/specs/video.json POST /v1/{phone_number_id}/messages openapi: 3.1.0 info: title: Datafy API — Enviar vídeo version: 1.0.0 servers: - url: https://cloud.datafyapi.com.br description: Produção security: - bearerAuth: [] paths: /v1/{phone_number_id}/messages: post: summary: Enviar vídeo operationId: enviarVideo parameters: - name: phone_number_id in: path required: true schema: type: string description: ID do número que envia a mensagem. Descubra com `GET /me`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MensagemVideo' example: messaging_product: whatsapp recipient_type: individual to: '5511999999999' type: video video: link: https://files2.datafychats.com.br/video-exemplo-whatsapp.mp4 caption: Veja como fica o produto em uso. responses: '200': description: Envio aceito pela Meta. Não confirma a entrega. content: application/json: example: messaging_product: whatsapp contacts: - input: '5511999999999' wa_id: '5511999999999' messages: - id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA= '400': description: Erro retornado pela Meta, como enviar `id` e `link` juntos. content: application/json: example: error: message: >- (#132018) There’s an issue with the parameters in your template type: OAuthException code: 132018 error_data: messaging_product: whatsapp details: Only one of media ID or link must be present fbtrace_id: AbCdEfGhIjK '401': description: Token ausente ou inválido. content: application/json: example: statusCode: 401 message: Token inválido ou não encontrado. components: schemas: MensagemVideo: type: object required: - messaging_product - to - type - video properties: messaging_product: type: string enum: - whatsapp default: whatsapp example: whatsapp description: Sempre `whatsapp`. recipient_type: type: string enum: - individual default: individual example: individual description: Sempre `individual`. to: type: string example: '5511999999999' description: >- Número do destinatário com código do país e DDD, como `5511999999999`. Tem prioridade sobre `recipient`: para enviar pelo ID do usuário, deixe em branco. recipient: type: string description: >- ID do usuário no WhatsApp (BSUID), recebido nos webhooks em `from_user_id` e `contacts[].user_id`, como `BR.13491208655302741918`. Usado quando `to` não é informado. type: type: string enum: - video default: video example: video description: Sempre `video`. video: type: object description: Vídeo da mensagem. Informe `link` **ou** `id`, nunca os dois. properties: link: type: string example: https://files2.datafychats.com.br/video-exemplo-whatsapp.mp4 description: >- URL pública do vídeo. Você pode gerar um link na aba **Mídias** do número, no painel da Datafy. Não envie junto com `id`. id: type: string description: >- ID da mídia retornado pelo endpoint **Upload de mídia**. Não envie junto com `link`. caption: type: string maxLength: 1024 example: Veja como fica o produto em uso. description: Legenda exibida abaixo do vídeo, com até 1.024 caracteres. context: type: object description: Responde citando uma mensagem anterior da conversa. properties: message_id: type: string description: ID (`wamid`) da mensagem que será citada. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Token gerado no painel da Datafy ao criar o canal. Formato: `sk_live_xxx`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.