Enviar Video

Metodo

POST https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/video

Conceituacao

Envia uma mensagem de video para um numero de telefone atraves de um canal conectado. O video deve ser enviado por URL publica acessivel. Opcionalmente, uma legenda pode ser adicionada.

Formatos suportados

Formato	Extensao
MP4	.mp4
3GP	.3gp

Limites

• Tamanho maximo: 16MB
• Videos maiores serao rejeitados com erro 400.

Atributos

Header

Atributo	Tipo	Obrigatorio	Descricao
Authorization	string	Sim	Bearer {API_KEY} - Chave de autenticacao da API
Content-Type	string	Sim	application/json

Path Parameters

Atributo	Tipo	Obrigatorio	Descricao
channelId	string	Sim	ID do canal pelo qual a mensagem sera enviada.

Body

Atributo	Tipo	Obrigatorio	Descricao
to	string	Sim	Numero do destinatario no formato DDI+DDD+NUM.
videoUrl	string	Sim	URL publica do video.
caption	string	Nao	Legenda do video. Maximo 1024 caracteres.
fileName	string	Nao	Nome do arquivo do video.
mimeType	string	Nao	Tipo MIME do video (ex: video/mp4).
fileSize	number	Nao	Tamanho do arquivo em bytes.

Request

cURL

curl -X POST "https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/video" \
  -H "Authorization: Bearer {API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999998888",
    "videoUrl": "https://exemplo.com/video-tutorial.mp4",
    "caption": "Assista ao tutorial completo"
  }'

Node.js

const axios = require('axios');

const response = await axios.post(
  'https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/video',
  {
    to: "5511999998888",
    videoUrl: "https://exemplo.com/video-tutorial.mp4",
    caption: "Assista ao tutorial completo"
  },
  {
    headers: {
      'Authorization': 'Bearer {API_KEY}',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

Python

import requests

response = requests.post(
    'https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/video',
    json={
        'to': '5511999998888',
        'videoUrl': 'https://exemplo.com/video-tutorial.mp4',
        'caption': 'Assista ao tutorial completo'
    },
    headers={
        'Authorization': 'Bearer {API_KEY}',
        'Content-Type': 'application/json'
    }
)

print(response.json())

Response

202 - Aceito

{
  "success": true,
  "message": "Mensagem enfileirada para envio"
}

400 - Dados invalidos

{
  "message": "Dados de entrada invalidos.",
  "code": "VALIDATION_ERROR",
  "errors": [
    {
      "field": "videoUrl",
      "message": "A URL do video e obrigatoria."
    }
  ]
}

401 - Nao autorizado

{
  "message": "Token de autenticacao invalido ou ausente.",
  "code": "UNAUTHORIZED"
}

429 - Rate limit excedido

{
  "message": "Limite de requisicoes excedido. Tente novamente em alguns segundos.",
  "code": "RATE_LIMIT_EXCEEDED"
}

Dica

Para uma melhor experiencia do destinatario, utilize videos no formato MP4 com codec H.264. Este formato possui a maior compatibilidade entre dispositivos.