# Buscar mensajes

> plazbot messages search: busca un texto en los mensajes de todo el workspace o de un contacto

Fuente: https://developers.plazbot.com/cli/messages/search/

### Buscar mensajes

Busca una palabra o frase en los mensajes. Tiene dos modos:

- **En todo el workspace** (por defecto): devuelve los contactos que tienen un mensaje con ese texto, con el mejor resultado de cada uno.
- **En un contacto** (`-c`): devuelve los mensajes de esa conversación que contienen el texto.

```bash
plazbot messages search <texto> [opciones]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Texto | `<text>` | Sí | Palabra o frase a buscar. Si tiene espacios, va entre comillas |
| Contacto | `-c, --contact <contactId>` | No | Busca solo en la conversación de ese contacto |
| Límite | `--limit <n>` | No | Máximo de resultados en la búsqueda del workspace. Por defecto `50` |
| JSON | `--json` | No | Imprime `{ data, nextCursor }` en JSON |
| Workspace | `-w, --workspace <id>` | No | Otro de tus workspaces |
| Zona | `-z, --zone <zone>` | No | `LA` o `EU` |

### Ejemplos

```bash
# Contactos que mencionaron "reembolso"
plazbot messages search reembolso

# Buscar dentro de una conversación
plazbot messages search "pedido 1234" -c con_AbcDef123

# IDs de los contactos que mencionaron una palabra
plazbot messages search cancelar --json | jq -r '.data[].contactId'
```

### Resultado

En todo el workspace:

```text
Contacts with matching messages (2)
────────────────────────────────────────
┌───────────────┬─────────────┬──────────────────┬──────────────────────────────────┐
│ Contact       │ Name        │ Date (UTC)       │ Message                          │
├───────────────┼─────────────┼──────────────────┼──────────────────────────────────┤
│ con_AbcDef123 │ Ana Torres  │ 2026-10-06 17:32 │ Quiero pedir un reembolso        │
├───────────────┼─────────────┼──────────────────┼──────────────────────────────────┤
│ con_GhiJkl456 │ Carlos Ruiz │ 2026-10-06 15:43 │ ¿Cuánto tarda el reembolso?      │
└───────────────┴─────────────┴──────────────────┴──────────────────────────────────┘
```

Con `-c`, la tabla tiene las mismas columnas que [`plazbot messages list`](https://developers.plazbot.com/cli/messages/list).

### Salida JSON

En todo el workspace, un elemento por contacto:

```json
{
"data": [
  {
    "contactId": "con_AbcDef123",
    "contactName": "Ana Torres",
    "phone": "51912345678",
    "messageId": "mes_AbcDef123",
    "snippet": "Quiero pedir un reembolso",
    "creationDate": "2026-10-06T17:32:08.404Z"
  }
],
"nextCursor": null
}
```

Con `-c`, cada elemento es el mensaje completo, igual que en `plazbot messages list`.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `No messages match` | Ningún mensaje contiene ese texto | Prueba con otra palabra o sin tildes |