Ver un portal
Muestra la configuración completa de un portal a partir de su ID: datos generales, logos, enlaces y agentes asociados.
bash
01plazbot portal get <portalId> [--json]
Parámetros
| Parámetro | Flag | Requerido | Descripción |
|---|---|---|---|
| Portal ID | <portalId> | Sí | ID del portal (sale en plazbot portal list) |
| JSON | --json | No | Imprime el portal en JSON |
Ejemplos
bash
01# Ver el detalle de un portal02plazbot portal get por_AbcDef1230304# Obtener el portal en JSON05plazbot portal get por_AbcDef123 --json0607# Listar solo los agentes asociados08plazbot portal get por_AbcDef123 --json | jq '.agents'
Resultado
text
01 Portal details02 ────────────────────────────────────────03 ID: por_AbcDef12304 Name: Help Center05 URL: https://la.plazbot.com/portal?id=por_AbcDef123&workspaceId=wok_AbcDef12306 Access: direct07 Status: Enabled08 Title: ¿En qué podemos ayudarte?09 Subtitle: Pregunta a nuestros agentes10 Plazbot brand: Visible1112 Assets13 ────────────────────────────────────────14 Logo: https://files.example.com/logo.png15 Logo (dark mode): https://files.example.com/logo-dark.png1617 Links18 ────────────────────────────────────────19 Docs: https://docs.example.com20 Pricing: https://example.com/pricing2122 Agents23 ────────────────────────────────────────24 Asistente de Ventas: age_AbcDef123
Las secciones Assets, Links y Agents solo aparecen si el portal tiene logos, enlaces o agentes.
Salida JSON
El objeto del portal tal como lo devuelve la API. Campos principales:
json
01{02 "id": "por_AbcDef123",03 "name": "Help Center",04 "url": "https://la.plazbot.com/portal?id=por_AbcDef123&workspaceId=wok_AbcDef123",05 "access": "direct",06 "disabled": false,07 "brandOff": false,08 "title": "¿En qué podemos ayudarte?",09 "subtitle": "Pregunta a nuestros agentes",10 "logo": "https://files.example.com/logo.png",11 "logodark": "https://files.example.com/logo-dark.png",12 "links": [{ "value": "Docs", "url": "https://docs.example.com" }],13 "agents": [{ "id": "age_AbcDef123", "name": "Asistente de Ventas" }]14}
Errores comunes
| Mensaje | Causa | Solución |
|---|---|---|
Resource not found. | El ID no existe o es de otro workspace | Revisa el ID y el workspace activo con plazbot whoami |
You are not signed in. | No hay sesión | Ejecuta plazbot login |
Comandos relacionados
| Para… | Usa |
|---|---|
| Cambiar nombre, textos, logos o acceso | plazbot portal update |
| Asociar o quitar un agente | plazbot portal add-agent · plazbot portal remove-agent |
| Agregar o quitar enlaces | plazbot portal add-link · plazbot portal clear-links |