> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interacto.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Video

> O endpoint `/message/video` é utilizado para enviar uma mensagem contendo um video para um número de telefone especificado. Além do conteúdo do documento, você pode adicionar opções como atraso no envio, tempo de digitação simulado, prioridade, tags, e metadados adicionais.

***

### Notas

Certifique-se de que o número do destinatário esteja no formato internacional (E.164). O tempo de atraso e a simulação de digitação são úteis para criar uma experiência mais natural de envio de mensagens, especialmente em aplicações onde o realismo na comunicação é importante.

## Atenção!

Recomendamos fortemente que você utilize as opções de `delay` ou `typing` ao enviar múltiplas mensagens em sequência. O envio de mensagens em grande volume sem essas configurações pode resultar no bloqueio temporário ou permanente de sua conta no WhatsApp. Use essas opções para garantir uma experiência mais natural e segura na plataforma.


## OpenAPI

````yaml POST /message/video
openapi: 3.0.1
info:
  title: Interacto API
  description: API for Interacto messaging platform
  version: 1.0.0
servers:
  - url: https://api.interacto.io
security:
  - apiKeyAuth: []
paths:
  /message/video:
    post:
      tags:
        - Messages
      operationId: MessageController_sendVideo
      parameters:
        - in: header
          name: Instance-Id
          required: true
          schema:
            type: string
          description: Unique identifier for the instance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoMessage'
      responses:
        '201':
          description: Message sent successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 201
                  message:
                    type: string
                    example: request successful
                  data:
                    $ref: '#/components/schemas/VideoMessageResponse'
      security:
        - apiKeyAuth: []
components:
  schemas:
    VideoMessage:
      type: object
      properties:
        to:
          type: string
          description: Destinatário da mensagem
          example: '5511999999999'
        media:
          description: Informações do vídeo
          allOf:
            - $ref: '#/components/schemas/VideoMessageInfo'
        delay:
          type: number
          description: Atraso opcional para envio da mensagem em segundos
          example: 2
        typing:
          type: number
          description: Atraso opcional de digitação em segundos
          example: 8
        priority:
          type: number
          description: Prioridade opcional da mensagem em inteiro
          example: 2
        tags:
          type: array
          description: Array opcional de tags
          items:
            type: string
          example:
            - urgente
            - lead
        metadata:
          type: object
          description: Objeto opcional de metadados
          example:
            leadId: '1234533'
      required:
        - to
        - media
    VideoMessageResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the sent message
          example: 66b3c041eac929f51c6f160f
        instanceId:
          type: string
          description: Unique identifier for the instance that sent the message
          example: 66a09db606fd14660c8fc1d0
        to:
          type: string
          description: Recipient's phone number in E.164 format
          example: '551198888888'
        midia:
          type: object
          description: Content of the message
          properties:
            url:
              type: string
              description: Text content of the message
              example: https://example.com/video.mp4
            caption:
              type: string
              description: Text content of the message
              example: Check out this video!!
        status:
          type: string
          description: Status of the message sending process
          enum:
            - QUEUED
            - sent
            - delivered
            - read
            - failed
        sended:
          type: boolean
          description: Indicates whether the message has been successfully sent
        priority:
          type: integer
          description: Priority level of the message
        timestamp:
          type: string
          format: date-time
          description: Timestamp when the message was created or processed
        metadata:
          type: object
          description: Additional metadata related to the message
    VideoMessageInfo:
      type: object
      required:
        - url
        - caption
      properties:
        url:
          type: string
          description: URL do vídeo
          example: https://example.com/video.mp4
        caption:
          type: string
          description: Descrição do vídeo
          example: Exemplo de descrição
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      name: Authorization
      in: header
      description: API Key needed to access the endpoints

````