Vídeo

curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "video",
    "mediaUrl": "https://example.com/video.mp4",
    "text": "Check out this video",
    "userId": "USER_ID"
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

POST

bots

{botId}

messages

curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "video",
    "mediaUrl": "https://example.com/video.mp4",
    "text": "Check out this video",
    "userId": "USER_ID"
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "video",
    "mediaUrl": "https://example.com/video.mp4",
    "text": "Check out this video",
    "userId": "USER_ID"
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

Parâmetros de rota

string

obrigatório

Identificador único do bot que envia a mensagem.

Parâmetros do corpo

string

obrigatório

Tipo de mensagem. Deve ser "video".

string

obrigatório

Destinatário da mensagem. Aceita um número de telefone no formato E.164 sem o sinal + (ex.: 593999999999) ou um BSUID (ex.: US.13491208655302741918) para usuários com a proteção de número ativada no WhatsApp. Veja Identificação do destinatário.

string

obrigatório

URL pública (HTTPS) do arquivo de vídeo. Os formatos e o tamanho máximo dependem do canal (veja a tabela de formatos e limites por canal).

string

Texto opcional exibido junto com a mídia. Apenas WhatsApp: Instagram e Messenger não suportam texto junto com o vídeo; para enviá-lo, use uma mensagem de texto separada.

Resposta

boolean

true se a mensagem foi enviada com sucesso.

string

Identificador da mensagem enviada.

Formatos e limites de tamanho por canal

Canal	Formatos suportados	Limite de tamanho
WhatsApp	`video/mp4`, `video/3gp`	16MB
Instagram	`video/mp4`, `video/ogg`, `video/webm`, `video/quicktime` (.mov)	25MB
Messenger	`video/mp4`, `video/ogg`, `video/webm`, `video/quicktime` (.mov)	25MB

Requisitos de URL

A URL deve ser acessível publicamente via HTTPS, não deve exigir autenticação e deve apontar diretamente para o arquivo (e não para uma página HTML).

Erros Comuns

INVALID_MEDIA_URL - A URL do vídeo é inválida ou inacessível
MEDIA_TOO_LARGE - O arquivo de vídeo excede o limite de tamanho do canal
UNSUPPORTED_MEDIA_TYPE - O formato de vídeo não é suportado

Casos de Uso

Compartilhar tutoriais em vídeo
Enviar demonstrações de produtos
Compartilhar vídeos promocionais
Enviar conteúdo educativo

Referência de API

Enviar Mensagens

Campanhas

Conversações

Etiquetas

Métricas

Usuários

Recursos

Widget

Datum

Painel de Atendimento Externo

Canal Personalizado

Gestão de Memória

Parâmetros de rota

Parâmetros do corpo

Resposta

Formatos e limites de tamanho por canal

Requisitos de URL

Erros Comuns

Casos de Uso

​Parâmetros de rota

​Parâmetros do corpo

​Resposta

​Formatos e limites de tamanho por canal

​Requisitos de URL

​Erros Comuns

​Casos de Uso

Parâmetros de rota

Parâmetros do corpo

Resposta

Formatos e limites de tamanho por canal

Requisitos de URL

Erros Comuns

Casos de Uso