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

# Enviando mensajes

> Envía textos, medios, contactos, ubicaciones, enlaces, encuestas y presencia con los puntos finales /enviar.

Todos los ejemplos asumen Basic Auth `admin:changeme`, una ranura llamada `my-device`, y GOWA en `localhost:3000`.

```bash theme={null}
export GOWA=http://localhost:3000
export AUTH=admin:changeme
export DEVICE=my-device
```

## Destinatarios

`phone` acepta:

* Un número con código de país, sin `+`, espacios o guiones: `628123456789` (un `+` inicial es desnudo).
* Un usuario JID: `628123456789@s.whatsapp.net`.
* Un grupo JID: `120363025246125486@g.us`.
* `status@broadcast` para publicar una actualización de estado.

Con `WHATSAPP_ACCOUNT_VALIDATION=true` (por defecto), GOWA comprueba que hay un número en WhatsApp antes de enviarlo. Comprueba uno mismo con `GET /user/check?phone=628123456789`.

## Texto

```bash theme={null}
curl -u $AUTH -X POST $GOWA/send/message \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "message": "Hello!"}'
```

Campos opcionales:

| Campo | Descripción |
| - | - |
| `reply_message_id` | Citar un mensaje anterior. |
| `mentions` | Los números de teléfono a mencionar, por ejemplo `["628111111111"]`; `"@everyone"` menciona a todos los miembros del grupo. Las menciones no necesitan `@` en el texto. |
| `is_forwarded` | Mostrar la etiqueta "Reenviado". |
| `duration` | Temporizador de mensaje desaparecido en segundos: `0`, `86400` (24 h), `604800` (7 d) o `7776000` (90 d). |
| `allow_reshare` | Sólo las publicaciones de estado (`phone` = `status@broadcast`). |

Envío exitoso devuelve el ID de mensaje de WhatsApp:

```json theme={null}
{"code": "SUCCESS", "message": "Success", "results": {"message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C", "status": "Message sent to 628123456789 (server timestamp: ...)"}}
```

## Medios

Los puntos finales de los medios toman `multipart/form-data`. Sube un archivo, o pasa una URL que GOWA descarga (`*_url`).

```bash Image theme={null}
curl -u $AUTH -X POST $GOWA/send/image -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F caption="Product photo" \
  -F image=@photo.jpg \
  -F compress=true
```

```bash Image from URL theme={null}
curl -u $AUTH -X POST $GOWA/send/image -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F image_url=https://example.com/photo.jpg
```

```bash Document theme={null}
curl -u $AUTH -X POST $GOWA/send/file -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F caption="Invoice" \
  -F file=@invoice.pdf
```

```bash Video theme={null}
curl -u $AUTH -X POST $GOWA/send/video -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F caption="Demo" \
  -F video=@demo.mp4
```

```bash Voice note theme={null}
curl -u $AUTH -X POST $GOWA/send/audio -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F audio=@note.ogg \
  -F ptt=true
```

```bash Sticker theme={null}
curl -u $AUTH -X POST $GOWA/send/sticker -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F sticker=@cat.png
```

| Endpoint | Campo de archivo / campo URL | Campos adicionales |
| - | - | - |
| `/send/image` | `image` / `image_url` | `caption`, `view_once`, `compress`, `hd`, `mentions` |
| `/send/video` | `video` / `video_url` | `caption`, `view_once`, `compress`, `hd`, `gif_playback`, `mentions` |
| `/send/file` | `file` / `file_url` | `caption`, `mentions` |
| `/send/audio` | `audio` / `audio_url` | `ptt` (enviar como nota de voz) |
| `/send/sticker` | `sticker` / `sticker_url` | JPG, PNG, WebP o GIF; convertido a WebP |

Todos los puntos finales de medios también aceptan `reply_message_id`, `is_forwarded` y `duration`. Vea [Media handling](https://gowa-docs.mintlify.site/es/examples/media-handling.md) para límites de tamaño y formatos.

## Contacto, ubicación, enlace, encuesta

```bash Contact theme={null}
curl -u $AUTH -X POST $GOWA/send/contact \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "contact_name": "Jane Doe", "contact_phone": "628987654321"}'
```

```bash Location theme={null}
curl -u $AUTH -X POST $GOWA/send/location \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "latitude": "-6.200000", "longitude": "106.816666"}'
```

```bash Link theme={null}
curl -u $AUTH -X POST $GOWA/send/link \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "link": "https://github.com", "caption": "Check this out"}'
```

```bash Poll theme={null}
curl -u $AUTH -X POST $GOWA/send/poll \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "question": "Lunch?", "options": ["Pizza", "Sushi", "Salad"], "max_answer": 1}'
```

## Presencia y escritura

```bash theme={null}
# account-wide presence: available | unavailable
curl -u $AUTH -X POST $GOWA/send/presence \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"type": "available"}'

# typing indicator in one chat: start | stop
curl -u $AUTH -X POST $GOWA/send/chat-presence \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "action": "start"}'
```

Para botones de flujo nativo, solicitudes de ubicación y carruseles de imágenes, vea [Mensajes interactivos experimentales](https://gowa-docs.mintlify.site/es/examples/interactive-messages.md).

## Después de enviar

| Tarea | Endpoint |
| - | - |
| Editar | `POST /message/{message_id}/update` con `phone`, `message` |
| React | `POST /message/{message_id}/reaction` con `phone`, `emoji` |
| Eliminar para todos | `POST /message/{message_id}/revoke` con `phone` |
| Eliminar para mí | `POST /message/{message_id}/delete` con `phone` |
| Reenviar | `POST /message/{message_id}/forward` con `phone` (destino). El mensaje de origen debe estar en el almacenamiento local de chat de GOWA. |
| Estrella / desestrella | `POST /message/{message_id}/star`, `/unstar` con `phone` |

### Editar una imagen o título del documento

En GOWA `main` después de v9.9.0, establece `media_type` a `image` o `document`. Debe coincidir con el mensaje original. Establece `message` en el título de reemplazo y omite `link`. Reemplaza el ID de ejemplo con el ID del mensaje enviado.

```bash theme={null}
curl -u "$AUTH" -X POST "$GOWA/message/3EB0B430B6F8F1D0E053AC120E0A9E5C/update" \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone":"628123456789","message":"Updated caption","media_type":"image"}'
```

## Enviar más tarde

Añade `scheduled_at` y `timezone` a una solicitud de envío soportada para programarla en su lugar. `/send/interactive` es inmediato. Ver [Envíos programados](https://gowa-docs.mintlify.site/es/examples/scheduled-sends.md).

## Enviando a muchos destinatarios

GOWA no tiene un punto final de transmisión. Bucle sobre los destinatarios en su código, envíe una solicitud a la vez con un retraso y detenga en los errores `WA_REACHOUT_TIMELOCK`. Leer [Enviando límites](https://gowa-docs.mintlify.site/es/advanced/rate-limiting.md) antes de enviar volumen.


## Related topics

- [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)
- [Reenviar mensaje](https://gowa-docs.mintlify.site/es/api-reference/message/reenviar-mensaje.md)
- [Mensaje estrella](https://gowa-docs.mintlify.site/es/api-reference/message/mensaje-estrella.md)
- [Mejores prácticas de producción](https://gowa-docs.mintlify.site/es/advanced/best-practices.md)


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