> ## 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 un mensaje interactivo experimental

> Envío REST exclusivamente inmediato para botones de flujo nativo, listas de selección,
solicitudes de ubicación y carruseles. No soportado por envíos programados o MCP.
Utiliza un protocolo no oficial; el éxito de la API no garantiza el renderizado o entrega del destinatario
. Acepta solo usuarios individuales o destinatarios de grupos.
Proporcione botones o tarjetas. También se aplican límites generales de cuerpo HTTP.




## OpenAPI

````yaml /es/openapi.yml post /send/interactive
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/interactive:
    post:
      tags:
        - send
      summary: Enviar un mensaje interactivo experimental
      description: >
        Envío REST exclusivamente inmediato para botones de flujo nativo, listas
        de selección,

        solicitudes de ubicación y carruseles. No soportado por envíos
        programados o MCP.

        Utiliza un protocolo no oficial; el éxito de la API no garantiza el
        renderizado o entrega del destinatario

        . Acepta solo usuarios individuales o destinatarios de grupos.

        Proporcione botones o tarjetas. También se aplican límites generales de
        cuerpo HTTP.
      operationId: sendInteractive
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InteractiveSendRequest'
            example:
              phone: '628123456789'
              body: Confirm your order?
              buttons:
                - name: quick_reply
                  params:
                    display_text: Confirm
                    id: confirm
      responses:
        '200':
          description: >-
            Aceptado para enviar; el renderizado del destinatario no está
            verificado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendResponse'
        '400':
          description: >-
            Destinatario, texto, parámetros de botón o límites de imagen
            inválidos
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Error al enviar dispositivos, medios o WhatsApp
          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:
    InteractiveSendRequest:
      type: object
      required:
        - phone
        - body
      properties:
        phone:
          type: string
          description: Número de teléfono o usuario individual o grupo JID.
        body:
          type: string
          description: Texto no en blanco requerido, máximo 4096 bytes.
        footer:
          type: string
          description: Máximo 256 bytes.
        buttons:
          type: array
          minItems: 1
          maxItems: 10
          items:
            $ref: '#/components/schemas/InteractiveNativeFlowButton'
        cards:
          type: array
          minItems: 2
          maxItems: 10
          items:
            $ref: '#/components/schemas/InteractiveCarouselCard'
      oneOf:
        - required:
            - buttons
          not:
            required:
              - cards
        - required:
            - cards
          not:
            required:
              - buttons
    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
    InteractiveNativeFlowButton:
      type: object
      required:
        - name
        - params
      properties:
        name:
          type: string
          enum:
            - quick_reply
            - cta_url
            - cta_copy
            - cta_call
            - single_select
            - send_location
        params:
          type: object
          additionalProperties: true
          description: >
            Máximo 16384 bytes JSON. quick_reply requiere display_text e id;

            cta_url requiere display_text y una url absoluta de HTTP(S);

            cta_copy requiere display_text y copy_code;

            cta_call requiere display_text y phone_number.

            single_select requiere title y sections no vacías, cada una con

            rows no vacías cuyos id y title sean cadenas no vacías.

            send_location acepta un objeto como {} y debe ser el único botón

            en un mensaje no carrusel. Todos los parámetros de texto nombrados
            deben

            ser cadenas no vacías.
    InteractiveCarouselCard:
      type: object
      required:
        - body
        - buttons
      properties:
        title:
          type: string
          description: Máximo 256 bytes.
        body:
          type: string
          description: Texto no en blanco requerido, máximo 4096 bytes.
        footer:
          type: string
          description: Máximo 256 bytes.
        image_base64:
          type: string
          description: >
            Opcional base64 JPEG o PNG, sin un prefijo de URL de datos.

            Máximo 2800000 caracteres codificados y 2000000 bytes decodificados,
            también

            sujeto al límite de imagen configurado. Máximo 4096 píxeles por
            lado.

            Redimensionado, codificado JPEG, miniaturado, y subido antes de
            enviar.
        buttons:
          type: array
          minItems: 1
          maxItems: 10
          items:
            $ref: '#/components/schemas/InteractiveNativeFlowButton'
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Mensajes interactivos experimentales](https://gowa-docs.mintlify.site/es/examples/interactive-messages.md)
- [Inicio rápido](https://gowa-docs.mintlify.site/es/quickstart.md)
- [Enviar mensaje](https://gowa-docs.mintlify.site/es/api-reference/send/enviar-mensaje.md)
- [Enviando mensajes](https://gowa-docs.mintlify.site/es/examples/sending-messages.md)
- [Enviar respuesta al mensaje](https://gowa-docs.mintlify.site/es/api-reference/message/enviar-respuesta-al-mensaje.md)


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