---
title: "Vídeo"
method: POST
path: "/v1/send/video"
tags: ["Envio"]
---

# Vídeo

`POST /v1/send/video`

Envia uma mensagem de vídeo para um contato.
O campo FileIdOrUrl é obrigatório; informe uma URL pública ou o ID de um arquivo previamente cadastrado.
O arquivo deve seguir as regras do canal de atendimento (formato e tamanho).
O campo CallbackUrl permite receber webhook quando a mensagem for entregue ou falhar.
Este endpoint tem rate limit individual e permite 1000 requisições a cada 2 minutos.

## Request body

- PublicReqSendMediaVideoDTO
  - `to` string, nullable
  - `from` string, nullable
  - `options` PublicReqSendOptionsDTO
    - `enableBot` boolean, nullable — Determina se o chatbot deve ser ativado ao receber uma resposta do contato. Válido apenas caso um novo atendimento seja criado ao enviar a mensagem.
    - `hiddenSession` boolean, nullable — Determina se o atendimento deve estar oculto na tela. Válido apenas caso um novo atendimento seja criado ao enviar a mensagem. O atendimento passará a ser visível caso o contato responda.
    - `forceStartSession` boolean, nullable — Se um atendimento estiver em andamento, força o encerramento dele e inicia um novo.
    - `user` PublicReqSendUserDTO
      - `id` string, uuid, nullable — ID do atendente a ser atribuído ao atendimento.
      - `phoneNumber` string, nullable — Telefone do atendente a ser atribuído ao atendimento.
      - `email` string, nullable — E-mail do atendente a ser atribuído ao atendimento.
    - `department` PublicReqSendDepartmentDTO
      - `id` string, uuid, nullable — ID da equipe a ser atribuída ao atendimento.
      - `name` string, nullable — Nome da equipe a ser atribuída ao atendimento.
  - `sessionId` string, uuid, nullable — ID do atendimento. (Opcional) Deve ser utilizado para atendimentos em tempo real, como respostas de IA externa.
  - `refId` string, uuid, nullable — ID da mensagem que está sendo respondida. Para resposta a uma mensagem
  - `delayTyping` integer, nullable — Tempo em segundos "digitando..." antes de entregar a mensagem. Se fornecido o disparo será adiado, para que o contato consiga ver o digitando. Para a API Oficial, utilize o endpoint específico para uma melhor experiência Max.: 25 segundos
  - `callbackUrl` string, nullable — URL para receber webhook quando a mensagem for enviada ou falhar
  - `senderId` string, nullable — ID de identificação no seu sistema para rastreamento e consulta da mensagem.
  - `fileIdOrUrl` string, required — Informe uma URL (com acesso público) do arquivo ou o Id de um arquivo. O arquivo enviado deverá seguir as regras do canal de atendimento.
  - `text` string, nullable — Legenda a ser enviada junto com o arquivo. O suporte a legenda depende do canal de atendimento.

## Response `200`

Success

- PublicRespSendMessageDTO
  - `id` string, uuid
  - `createdAt` string, date-time
  - `updatedAt` string, date-time, nullable
  - `companyId` string, uuid
  - `sessionId` string, uuid, nullable
  - `status` 'PROCESSING' | 'SAVED' | 'QUEUED' | 'SENT' | 'DELIVERED' | 'READ' | 'FAILED' | 'DELETED' | 'WAIT_REPLY'
  - `senderId` string, nullable
  - `statusUrl` string, nullable
  - `sentAt` string, date-time, nullable
  - `failedReason` string, nullable
  - `callbackUrl` string, nullable
  - `waitReply` boolean, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Server Error

---

[API](https://skmtc.net/wts/apis/core.md) · [All operations](https://skmtc.net/wts/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wts/core/versions/1efd0a6ba643/schema)