# Crear Portal

> Crea el portal web del workspace, donde tus clientes conversan con tus agentes de IA

Fuente: https://developers.plazbot.com/cli/portal/create/

### Crear un portal

Crea el portal público del workspace activo: una URL donde tus clientes conversan con tus agentes de IA. Cada workspace puede tener un solo portal.

```bash
plazbot portal create -n <nombre> -t <título> [opciones]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Nombre | `-n, --name <name>` | Sí | Nombre del portal |
| Título | `-t, --title <title>` | Sí | Título de bienvenida que se muestra en el portal |
| Subtítulo | `-s, --subtitle <subtitle>` | No | Texto que aparece debajo del título |
| Logo | `-l, --logo <url>` | No | URL del logo (`.png` o `.jpg`) |
| Logo modo oscuro | `-d, --logo-dark <url>` | No | URL del logo para modo oscuro (`.png` o `.jpg`) |
| Acceso | `-a, --access <type>` | No | `direct` (abierto) o `form` (pide los datos de contacto antes de chatear). Por defecto `direct` |
| JSON | `--json` | No | Imprime solo `{"id","url"}` en JSON |

### Ejemplos

```bash
# Portal con nombre y título de bienvenida
plazbot portal create -n "Help Center" -t "¿En qué podemos ayudarte?"

# Con subtítulo y logos
plazbot portal create -n "Help Center" -t "Bienvenido" -s "Pregunta a nuestros agentes" -l https://files.example.com/logo.png -d https://files.example.com/logo-dark.png

# Pedir los datos del visitante antes de chatear
plazbot portal create -n "Soporte" -t "Bienvenido" -a form

# Crear y capturar el ID en un script
plazbot portal create -n "Help Center" -t "Bienvenido" --json | jq -r '.id'
```

### Resultado

```text
✔ Portal "Help Center" created
ID: por_AbcDef123
URL: https://la.plazbot.com/portal?id=por_AbcDef123&workspaceId=wok_AbcDef123

Next: plazbot portal add-agent por_AbcDef123 -a <agentId>
```

El siguiente paso es asociar un agente con [`plazbot portal add-agent`](https://developers.plazbot.com/cli/portal/add-agent).

### Salida JSON

```json
{
"id": "por_AbcDef123",
"url": "https://la.plazbot.com/portal?id=por_AbcDef123&workspaceId=wok_AbcDef123"
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `This workspace already has a portal (only one is allowed).` | El workspace ya tiene portal | Míralo con [`plazbot portal list`](https://developers.plazbot.com/cli/portal/list) o cámbialo con [`plazbot portal update`](https://developers.plazbot.com/cli/portal/update) |
| `Invalid logo for --logo: "..."` | El logo no termina en `.png`/`.jpg` o no es una URL `https://` ni una ruta que empiece con `/` | Usa una URL `.png` o `.jpg` |
| `Invalid access type "..."` | `-a` distinto de `direct` o `form` | Usa `direct` o `form` |
| `Portal name is required.` / `Portal title is required.` | `-n` o `-t` vacíos | Pasa un valor no vacío |
| `You are not signed in.` | No hay sesión | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login) |

> **Nota:** Los logos deben ser `.png` o `.jpg`, como URL `https://` o como ruta que empiece con `/`.