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

# Enviar imagen



## OpenAPI

````yaml /es/openapi.yml post /send/image
openapi: 3.0.0
info:
  title: Multidispositivo API de WhatsApp
  version: 9.7.0
  description: >
    Esta API se utiliza para enviar whatsapp a través de API.


    El panel web es un proyecto separado (gowa-ui); el servidor descarga su
    último recurso de versión

    y lo sirve en `/` (o devuelve un banner JSON cuando

    APP_UI_ENABLED=false).


    Ámbito del dispositivo:

    - Envía `X-Device-Id` en todas las llamadas REST con ámbito dispositivo.

    - WebSocket: conectar a `/ws?device_id=<id>`.

    - WebSocket auth (cuando la autenticación básica está habilitada): los
    navegadores no pueden establecer un encabezado
      de autorización en conexiones WebSocket, así que también pase
      `&authorization=<base64(user:pass)>` en la cadena de consulta. Usa TLS en producciónformat@@0
      ya que la credencial es visible en la URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Conexión inicial al servidor de Whatsapp
  - name: device
    description: Gestión de dispositivos para soporte multidispositivo
  - name: user
    description: Obteniendo información
  - name: send
    description: Enviar mensaje (Texto/Imágen/Archivo/Video).
  - name: message
    description: Manipulación de mensajes (revocar/react/actualizar).
  - name: call
    description: Gestión de llamadas (rechazar llamadas entrantes)
  - name: chat
    description: Chats de chat y mensajería
  - name: group
    description: Ajuste de grupo
  - name: newsletter
    description: configuración del boletín de noticias
  - name: chatwoot
    description: Integración de Chatwoot para soporte al cliente
paths:
  /send/image:
    post:
      tags:
        - send
      summary: Enviar imagen
      operationId: sendImage
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              allOf:
                - $ref: '#/components/schemas/ScheduleOptions'
              properties:
                phone:
                  type: string
                  example: 6289685028129@s.whatsapp.net
                  description: Número de teléfono con código de país
                caption:
                  type: string
                  example: selamat malam
                  description: Título a enviar
                mentions:
                  type: array
                  items:
                    type: string
                  example:
                    - '628123456789'
                    - '@everyone'
                  description: >
                    Lista de números de teléfono a mencionar (menciones fantasma
                    - no @ requerido en la leyenda).

                    También se menciona `@phone` en el subtítulo. Utilice la
                    palabra clave especial "@everyone" para mencionar a todos
                    los participantes del grupo.

                    Enviar un campo de `mentions` por entrada.
                reply_message_id:
                  type: string
                  example: 3EB089B9D6ADD58153C561
                  description: ID de mensaje que desea respuesta
                view_once:
                  type: boolean
                  example: false
                  description: Ver una vez
                image:
                  type: string
                  format: binary
                  description: Imagen a enviar
                image_url:
                  type: string
                  example: https://example.com/image.jpg
                  description: URL de imagen a enviar
                compress:
                  type: boolean
                  example: false
                  description: Comprimir imagen
                hd:
                  type: boolean
                  example: true
                  description: >-
                    Enviar una rendición de imagen de alta definición (borde
                    máximo 2560px). Sobreescribe comprimir cuando es verdadero.
                duration:
                  type: integer
                  example: 86400
                  description: >-
                    Desapareciendo la duración del mensaje en segundos. Valores
                    permitidos: 0 (sin caducidad), 86400 (24h), 604800 (7d),
                    7776000 (90d).
                is_forwarded:
                  type: boolean
                  example: false
                  description: Si este es un mensaje reenviado
                allow_reshare:
                  type: boolean
                  example: false
                  description: >-
                    Mostrar el botón volver a compartir a los espectadores de
                    estado. Requiere que `phone` sea `status@broadcast`; GOWA
                    rechaza el campo para cualquier otro destinatario.
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendResponse'
        '400':
          description: Solicitud incorrecta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Identificador de dispositivo para soporte multidispositivo. Requerido
        cuando se registran múltiples dispositivos.

        Si sólo se registra un dispositivo, se utilizará como el valor
        predeterminado.

        También se puede proporcionar como parámetro de consulta `device_id`.
      schema:
        type: string
        example: my-device-id
  schemas:
    ScheduleOptions:
      type: object
      description: >
        Campos opcionales que programan el mensaje en lugar de enviarlo ahora.
        Establece

        `scheduled_at` a programar; sin él, el mensaje se envía inmediatamente.

        Un trabajador de fondo lo envía en la hora programada, reintentando
        mientras el dispositivo

        está desconectado o no está conectado. Los medios subidos se almacenan
        en el servidor

        hasta que finalice el programa.

        En los cuerpos multipart/form-data, envíe `weekdays` como un campo
        repetido

        (`weekdays=1`, `weekdays=3`).
      properties:
        scheduled_at:
          type: string
          format: date-time
          example: '2026-10-01T09:00:00+07:00'
          description: >-
            RFC3339 vez del primer envío. Debe ser en el futuro. El primer envío
            siempre ocurre en este momento, incluso si cae fuera de `weekdays` o
            `day_of_month`; los que establecen las repeticiones que siguen.
        timezone:
          type: string
          example: Asia/Jakarta
          description: >-
            Zona horaria IANA usada para calcular las ejecuciones recurrentes.
            Requerido cuando scheduled_at está establecido.
        recurrence:
          type: string
          enum:
            - once
            - daily
            - weekly
            - monthly
          default: once
          description: Con qué frecuencia repetir el envío
        weekdays:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 6
          uniqueItems: true
          example:
            - 1
            - 3
            - 5
          description: >-
            Días para enviar, 0=Domingo a 6=Sábado. Se requiere cuando la
            repetición es semanal.
        day_of_month:
          type: integer
          minimum: 1
          maximum: 31
          example: 15
          description: >-
            Día del mes para enviar, aplastado hasta el último día del mes.
            Requerido cuando la repetición es mensual.
        end_at:
          type: string
          format: date-time
          example: '2026-12-31T23:59:59+07:00'
          description: >-
            Sólo recurriendo. No hay envíos después de este tiempo; debe estar
            después de scheduled_at.
        occurrence_limit:
          type: integer
          minimum: 1
          example: 10
          description: Sólo recurriendo. Detener después de estos envíos.
    SendResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success
        results:
          type: object
          properties:
            message_id:
              type: string
              example: 3EB0B430B6F8F1D0E053AC120E0A9E5C
              description: Omitido para envíos programados
            status:
              type: string
              example: <feature> success ....
            schedule_id:
              type: string
              example: 0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10
              description: >-
                Sólo envíos programados. Utilízalo con las rutas
                /enviar/programar.
            scheduled_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: Sólo envíos programados. La primera vez que se envía.
            next_run_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: >-
                Sólo envíos programados. Cuando el trabajador envía a
                continuación.
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: Código de estado HTTP
        message:
          type: string
          example: field cannot be blank
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: Error
        message:
          type: string
          example: you are not loggin
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Mensajes interactivos experimentales](https://gowa-docs.mintlify.site/es/examples/interactive-messages.md)
- [Enviar Sticker](https://gowa-docs.mintlify.site/es/api-reference/send/enviar-sticker.md)
- [Enviar un mensaje interactivo experimental](https://gowa-docs.mintlify.site/es/api-reference/send/enviar-un-mensaje-interactivo-experimental.md)
- [Enviar archivo](https://gowa-docs.mintlify.site/es/api-reference/send/enviar-archivo.md)
- [Enviar audio](https://gowa-docs.mintlify.site/es/api-reference/send/enviar-audio.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.