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

# Enviar PTV (Vídeo de Bolso)

> Envia um vídeo em formato circular (picture-in-picture)

## Descrição

Envia um vídeo no formato PTV (Picture-to-Video), que é exibido de forma circular no WhatsApp, similar ao formato de mensagem de voz em vídeo. O arquivo deve ser um vídeo MP4 hospedado em uma URL pública.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "phone": "5511999999999",
  "ptv": "https://exemplo.com/video.mp4",
  "delayMessage": 1000
}
```

| Campo          | Tipo   | Obrigatório | Descrição                                          |
| -------------- | ------ | ----------- | -------------------------------------------------- |
| `phone`        | string | Sim         | Número do destinatário no formato DDI+DDD+número   |
| `ptv`          | string | Sim         | URL pública do arquivo de vídeo mp4                |
| `delayMessage` | number | Não         | Aguarda N milissegundos antes de enviar a mensagem |

## Response

### Sucesso (202)

```json theme={null}
{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
```

## Exemplo cURL

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-ptv' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "ptv": "https://exemplo.com/video.mp4"
  }'
```

<Tip>O PTV (Picture-to-Video) exibe o vídeo em formato circular no WhatsApp, similar ao vídeo de mensagem de voz. É ideal para mensagens de vídeo curtas e pessoais.</Tip>