> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/api-de-la-plataforma/messages.md).

# Mensajería

Envío de mensajes de WhatsApp desde tus agentes. Base: `https://panel.anunzi.net/api/v1/messages/`.

| Método | Ruta       | Descripción                                       |
| ------ | ---------- | ------------------------------------------------- |
| `POST` | `send.php` | Envía un mensaje de WhatsApp (texto o plantilla). |

Consume créditos (tarifa de mensaje de WhatsApp de tu plan).

***

## Enviar texto

```bash
curl -X POST "https://panel.anunzi.net/api/v1/messages/send.php" \
  -H "Authorization: Bearer anz_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "agent_id":"AGENT_ID", "to":"+5491123456789", "type":"text", "text":"Hola 👋" }'
```

## Enviar plantilla

```json
{
  "agent_id": "AGENT_ID",
  "to": "+5491123456789",
  "type": "template",
  "template": {
    "name": "recordatorio_turno",
    "language": "es",
    "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Ana" } ] } ]
  }
}
```

* `agent_id` debe ser un agente de **WhatsApp** de tu cuenta con conexión de Meta activa.
* Respuesta: `{ "message_id": "…", "sent": true, "credits": N }`.

> Fuera de la ventana de 24 h de WhatsApp, solo se pueden enviar **plantillas** aprobadas.