# Buscar contactos

> plazbot contacts search: busca contactos por número de WhatsApp o por email

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

### Buscar contactos

Busca contactos por número de WhatsApp o por email. Un mismo número puede tener más de un contacto si escribió a distintos números de tu empresa, por eso el resultado es una lista.

```bash
plazbot contacts search (-p <número> | -e <email>) [--json]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Teléfono | `-p, --phone <number>` | Uno de los dos | Número en formato internacional: `+51912345678`, `51912345678` o `"+51 912 345 678"` |
| Email | `-e, --email <email>` | Uno de los dos | Email exacto |
| 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` |

Pasa `--phone` o `--email`, no los dos.

### Ejemplos

```bash
# Buscar por teléfono
plazbot contacts search -p +51912345678

# Buscar por email, en JSON
plazbot contacts search -e ana@empresa.com --json

# Obtener solo el ID del primer resultado
plazbot contacts search -p +51912345678 --json | jq -r '.data[0].id'
```

### Resultado

```text
Contacts (2)
────────────────────────────────────────
┌───────────────┬────────────┬─────────────┬──────────┬────────────┬──────────────────┐
│ ID            │ Name       │ Phone       │ Channel  │ Agent      │ Last message     │
├───────────────┼────────────┼─────────────┼──────────┼────────────┼──────────────────┤
│ con_AbcDef123 │ Ana Torres │ 51912345678 │ whatsapp │ Luis Pérez │ 2026-10-06 17:32 │
├───────────────┼────────────┼─────────────┼──────────┼────────────┼──────────────────┤
│ con_GhiJkl456 │ Ana Torres │ 51912345678 │ whatsapp │ Luis Pérez │ 2026-06-25 02:23 │
└───────────────┴────────────┴─────────────┴──────────┴────────────┴──────────────────┘
```

### Salida JSON

```json
{
"data": [
  {
    "id": "con_AbcDef123",
    "name": "Ana",
    "lastname": "Torres",
    "internalWhatsappNumber": "51912345678",
    "platformId": 2,
    "assignedAgentName": "Luis Pérez",
    "lastMessageDate": "2026-10-06T17:32:08.404Z"
  }
],
"nextCursor": null
}
```

Cada elemento es el contacto completo, igual que en [`plazbot contacts get`](https://developers.plazbot.com/cli/contacts/get).

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Pass either --phone or --email.` | No pasaste ninguno, o pasaste los dos | Usa solo uno |
| `Invalid phone number "..."` | El número no tiene entre 8 y 15 dígitos | Usa el formato internacional con código de país |
| `No contact matches` | No hay contactos con ese dato | Revisa el número o el email, y el workspace activo |