Skip to main content
POST
/
instances
/
{INSTANCE_ID}
/
token
/
{INSTANCE_TOKEN}
/
send-ptv
Enviar PTV (Vídeo de Bolso)
curl --request POST \
  --url https://api.example.com/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-ptv

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

{
  "phone": "5511999999999",
  "ptv": "https://exemplo.com/video.mp4",
  "delayMessage": 1000
}
CampoTipoObrigatórioDescrição
phonestringSimNúmero do destinatário no formato DDI+DDD+número
ptvstringSimURL pública do arquivo de vídeo mp4
delayMessagenumberNãoAguarda N milissegundos antes de enviar a mensagem

Response

Sucesso (202)

{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}

Exemplo cURL

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"
  }'
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.