> ## 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.

# Mensajes interactivos experimentales

> Enviar botones de respuesta, llamadas a la acción, listas de selección, solicitudes de ubicación y carruseles de imágenes.

`POST /send/interactive` envía mensajes de flujo nativo de WhatsApp a través del dispositivo seleccionado. Use Basic Auth, `X-Device-Id`, y un cuerpo JSON. Este endpoint soporta envíos REST inmediatos. Los envíos programados y MCP no lo exponen.

> [!WARNING]
>
> Este punto final experimental utiliza un protocolo WhatsApp no oficial. El renderizado del destinatario varía según el cliente y puede cambiar sin previo aviso. Prueba en tus clientes objetivo antes de usar. Una respuesta API exitosa confirma la aceptación de envío, no entrega o renderizado.

Establezca la URL del servidor y las credenciales antes de ejecutar los ejemplos de curl. Utilice la URL pública HTTPS para un servidor remoto e incluya `APP_BASE_PATH` cuando esté configurado.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Botones de envío

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H 'Content-Type: application/json' -H "X-Device-Id: $DEVICE_ID" \
  "$GOWA_URL/send/interactive" --data '{
    "phone": "628123456789",
    "body": "Confirm your order?",
    "footer": "Order 123",
    "buttons": [
      {"name": "quick_reply", "params": {"display_text": "Confirm", "id": "confirm"}},
      {"name": "quick_reply", "params": {"display_text": "Cancel", "id": "cancel"}}
    ]
  }'
```

`phone` acepta un número de teléfono o un usuario o grupo JID. Los envíos de grupos requieren membresía y permiso de publicación. El boletín de noticias y los destinatarios de difusión no son compatibles.

Proporciona `buttons` o `cards` en el nivel superior. Si proporcionas ambos o ninguno, la validación falla.

| Nombre del botón | Parámetros requeridos |
| - | - |
| `quick_reply` | Cadenas `display_text` y `id` no vacías. |
| `cta_url` | No vacía `display_text` y un `url` HTTP o HTTPS. |
| `cta_copy` | No vacíe las cadenas `display_text` y `copy_code`. |
| `cta_call` | No vacías las cadenas `display_text` y `phone_number`. |
| `single_select` | `title` y `sections`. Cada sección necesita `rows`; cada fila necesita `id` y `title`. |
| `send_location` | Un objeto JSON como `{}`. Debe ser el único botón en un mensaje sin tarjetas. |

Para una lista de selección, utilice estos parámetros:

```json theme={null}
{
  "name": "single_select",
  "params": {
    "title": "Choose a size",
    "sections": [{
      "title": "Sizes",
      "rows": [
        {"id": "small", "title": "Small"},
        {"id": "large", "title": "Large"}
      ]
    }]
  }
}
```

## Solicitar una ubicación

```json theme={null}
{
  "phone": "628123456789",
  "body": "Share your delivery location",
  "buttons": [{"name": "send_location", "params": {}}]
}
```

Enviar este JSON a `/send/interactive`. El destinatario debe elegir compartir una ubicación. El punto final no recupera una ubicación sin su acción.

## Enviar un carrusel de imagen

```json theme={null}
{
  "phone": "628123456789",
  "body": "Choose a product",
  "cards": [
    {
      "title": "Product A",
      "body": "Available in blue",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose A", "id": "choose_a"}}]
    },
    {
      "title": "Product B",
      "body": "Available in green",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose B", "id": "choose_b"}}]
    }
  ]
}
```

Reemplace los marcadores de posición de la imagen por base64 estándar sin un prefijo de URL de datos. Las imágenes son opcionales en tarjetas individuales. GOWA redimensiona las imágenes suministradas para ajustarlas a 1280 píxeles, las convierte en JPEG, crea miniaturas y las carga a WhatsApp. Las URL de imágenes remotas no son aceptadas.

## Límites de solicitud

| Campo | Límite |
| - | - |
| Mensaje `body` | Requerido y no en blanco, máximo 4096 bytes. |
| Mensaje `footer` | Máximo 256 bytes. |
| `buttons` | 1–10 por mensaje o tarjeta. |
| `params` | Objeto JSON, máximo 16,384 bytes. |
| `cards` | 2–10 tarjetas. |
| Tarjeta `body` | Requerido y no en blanco, máximo 4096 bytes. |
| Tarjeta `title` y `footer` | Máximo 256 bytes cada uno. |
| Tarjeta `image_base64` | Máximo 2.800.000 caracteres codificados y 2.000.000 bytes decodificados, también sujetos al límite de tamaño de imagen configurado por el servidor. |
| Imagen decodificada | JPEG o PNG, máximo 4096 píxeles por lado. |

El límite total de peticiones HTTP del servidor también se aplica. Utilice imágenes pequeñas al enviar varias tarjetas. Las opciones o tamaños no válidos devuelven un error de validación antes de enviar.

## Manejar respuestas y recibos

Envío exitoso devuelve el sobre de éxito normal con `results.message_id` y un estado que dice que el renderizado del destinatario no está verificado. Usa [webhooks entrantes](https://gowa-docs.mintlify.site/es/concepts/webhooks.md) para respuestas y eventos `message.ack` para recibos. Reintentarlo después de un tiempo de espera ambiguo puede duplicar mensajes.

Las pruebas de Android descendentes reportaron respuestas de trabajo, URL, copia, llamada, selección, ubicación y acciones de carrusel. Estos informes no establecen compatibilidad entre cuentas, iOS o WhatsApp Web. Las tarjetas de carrusel individuales pueden mostrar iconos pendientes incluso cuando el mensaje padre tiene marcas de verificación y el destinatario puede responder. Este problema sigue sin resolverse.

El punto final no registra plantillas oficiales ni ayuda a Flows, catálogos o pagos nativos.


## Related topics

- [Enviando mensajes](https://gowa-docs.mintlify.site/es/examples/sending-messages.md)
- [Enviar un mensaje interactivo experimental](https://gowa-docs.mintlify.site/es/api-reference/send/enviar-un-mensaje-interactivo-experimental.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/es/index.md)
- [Recibiendo mensajes](https://gowa-docs.mintlify.site/es/examples/receiving-messages.md)
- [Revocar mensaje](https://gowa-docs.mintlify.site/es/api-reference/message/revocar-mensaje.md)


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