Pular para o conteúdo principal
POST
Enviar vídeo
Envia um vídeo, com legenda opcional, para um cliente com a janela de 24 horas aberta.
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.
Informe o vídeo de uma das duas formas:
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

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.
Se o vídeo não reproduzir, converta com o ffmpeg para o formato recomendado:
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. Veja mais detalhes na documentação de mensagens de vídeo da Meta.

Autorizações

Authorization
string
header
obrigatório

Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.

Parâmetros de caminho

phone_number_id
string
obrigatório

ID do número que envia a mensagem. Descubra com GET /me.

Corpo

application/json
messaging_product
enum<string>
padrão:whatsapp
obrigatório

Sempre whatsapp.

Opções disponíveis:
whatsapp
Exemplo:

"whatsapp"

to
string
obrigatório

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.

Exemplo:

"5511999999999"

type
enum<string>
padrão:video
obrigatório

Sempre video.

Opções disponíveis:
video
Exemplo:

"video"

video
object
obrigatório

Vídeo da mensagem. Informe link ou id, nunca os dois.

recipient_type
enum<string>
padrão:individual

Sempre individual.

Opções disponíveis:
individual
Exemplo:

"individual"

recipient
string

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.

context
object

Responde citando uma mensagem anterior da conversa.

Resposta

Envio aceito pela Meta. Não confirma a entrega.