> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso del navegador

> Permite que un asistente utilice sitios autorizados durante una conversación.

Disponible en planes de Famulor que incluyan esta función, también en el espacio propio de un revendedor de marca blanca. Aún no está disponible en los espacios de los clientes de revendedores. El procesamiento del espacio debe ser **Global**.

1. En **Agent Tools → Agent Connectors**, selecciona **Add** en la tarjeta **Browser Use**. También puedes crear una herramienta **Built-in** y seleccionar **Browser Use**.
2. Introduce una URL HTTPS inicial y los nombres exactos de los sitios permitidos, incluidos los recursos y las redirecciones necesarios.
3. En **Descripción (cuándo usar)**, indica cuándo debe elegir el asistente esta herramienta.
4. Añade las **Instrucciones del navegador**: pasos en el sitio, resultado esperado y condiciones de parada. Se envían directamente a cada tarea.
5. Añade la **Información requerida**, con un nombre único e indicaciones opcionales. El asistente solicita las respuestas que faltan antes de iniciar el navegador o reservar créditos. Añade solo información necesaria para cada tarea.
6. Guarda la herramienta y asígnala al asistente. No es necesario copiar las instrucciones del navegador en el prompt del asistente.
7. Inicia Test Call o Test Chat. El panel se abre automáticamente al comenzar una tarea de navegador. El icono permite cerrarlo y volverlo a abrir. Las demos públicas ofrecen la misma vista en directo.

Para buscar una cita, utiliza el perfil del médico como página inicial. Ejemplo de instrucción: «Leer las fechas y horas disponibles; detenerse antes de seleccionar o reservar una cita». Un dato requerido puede ser «Categoría del paciente», con la indicación «Preguntar si es un paciente nuevo o existente». Las respuestas proceden de la conversación, sin valores inventados. La descripción indica cuándo utilizar la herramienta; las instrucciones explican cómo realizar la tarea.

Teléfono, widget y mensajería mantienen su interfaz. La herramienta trabaja en segundo plano. La vista es de solo lectura.

### Vídeos y créditos

History muestra el icono de grabación cuando existe un vídeo. Abre un reproductor WebM en una ventana. Cada tarea tiene un vídeo privado, conservado un máximo de siete días o menos según la retención del espacio. Eliminar la conversación almacenada elimina los vídeos. La retención cero desactiva la grabación. Los vídeos parciales se indican en el reproductor.

En **Settings → Data Retention**, **Calls** cubre llamadas, Test Call, Test Chat y chats del widget web. La mensajería usa su propia categoría, como **WhatsApp** para conversaciones de texto. Los vídeos del navegador siguen esa categoría, con un máximo de siete días. Los vídeos caducados dejan de estar accesibles. Eliminar la conversación almacenada o el espacio inicia su borrado físico, con reintentos automáticos si el almacenamiento no está disponible.

El tiempo de navegador, incluida una breve espera inactiva, y las decisiones consumen créditos separados. Se descuenta un presupuesto limitado al empezar; los créditos no utilizados se devuelven tras cerrar la sesión y conciliar el uso. Cerrar la vista no detiene la tarea: pide al asistente que la cancele.

### Tareas compatibles

La herramienta pulsa elementos visibles, rellena campos de texto normales con valores conocidos, desplaza y lee páginas. Los pasos y la duración están limitados. No evita CAPTCHA, autenticación de dos factores ni restricciones de sitios. No admite contraseñas, subidas, desplegables complejos ni ventanas emergentes. Comprueba el resultado antes de repetir una acción. Una tarea terminada no sustituye una confirmación visible en el sitio.

## Ejemplos de uso

Usa estos ejemplos como plantillas y prueba el recorrido exacto con tu asistente. No garantizan compatibilidad con todos los sitios. Los calendarios dinámicos, accesos obligatorios o selectores complejos pueden impedir completar la tarea. Un perfil directo o una página de resultados preparada suele requerir menos pasos que buscar desde la página inicial.

| Caso de uso | Página inicial | Información requerida | Instrucciones y resultado |
| - | - | - | - |
| Comparar vuelos | [Google Flights](https://www.google.com/travel/flights) o resultados preparados | Aeropuerto de salida, destino, fecha de ida, solo ida o vuelta, pasajeros; preguntar la fecha de vuelta cuando corresponda | Leer tarifas, moneda, horarios y escalas visibles. Mencionar equipaje y condiciones solo si aparecen. Detenerse antes de reservar. |
| Comparar hoteles | [Google Hotels](https://www.google.com/travel/hotels) o disponibilidad pública de un hotel | Destino, entrada, salida, huéspedes y habitaciones | Comparar precios visibles indicando si son por noche o por estancia. Incluir impuestos y cancelación solo si aparecen. No reservar. |
| Consultar citas | Perfil directo de una consulta o proveedor | Cliente nuevo o existente y tipo de cita | Abrir la disponibilidad, aplicar las preferencias y leer fechas y horas visibles. Detenerse antes de seleccionar o reservar una hora. |
| Consultar productos | Página de un producto | Producto o variante, talla/color, ubicación si corresponde | Leer precio y existencias de la variante solicitada. No añadir al carrito ni comprar. |
| Seguir un envío | Página pública de seguimiento de un transportista | Número de seguimiento | Introducir el número indicado y resumir el estado y la fecha estimada visibles. Detenerse si se necesita iniciar sesión o aportar datos personales adicionales. |

Para vuelos, usa `https://www.google.com/travel/flights` como **URL inicial** y `www.google.com` en **Sitios permitidos**. Añade otros hosts exactos solo para redirecciones o recursos necesarios. La URL inicial es una dirección completa; los sitios permitidos son nombres de host sin rutas ni comodines.

Ejemplo de **Descripción (cuándo usar)**: «Usar cuando el cliente quiera comparar precios de vuelos». Ejemplo de **Instrucciones del navegador**: «Usa la ruta, fechas y pasajeros indicados. Devuelve hasta tres opciones visibles con precio, moneda, salida y escalas. No inventes precios ni condiciones. Detente antes de reservar, pagar o iniciar sesión. Informa si los controles de búsqueda incompatibles impiden la comparación». Marca como **Información requerida** solo las respuestas necesarias en todos los casos; la fecha de vuelta condicional pertenece a las indicaciones de pregunta. Los precios y la disponibilidad pueden cambiar después de la consulta.

## API, MCP, CLI & SDK

Crea y asigna la herramienta con `POST /api/v1/tools` y `PUT /api/v1/assistants/{id}/tools`, o MCP `create_tool` y `set_assistant_tools`. CLI: `famulor create-tool` y `famulor set-assistant-tools`. SDK: `client.api.createTool(...)` y `client.api.setAssistantTools(...)`.

| API | MCP | CLI | SDK |
| - | - | - | - |
| `GET /api/v1/calls/{id}/browser-session` | `get_call_browser_session` | `famulor get-call-browser-session <id>` | `client.calls.browserSession(id)` |
| `GET /api/v1/calls/{id}/browser-recordings` | `list_history_browser_recordings` | `famulor list-call-browser-recordings <id>` | `client.calls.browserRecordings(id)` |
| `GET /api/v1/calls/{id}/browser-recordings/{recordingId}` | `get_history_browser_recording` | `famulor get-call-browser-recording <id> <recordingId> --output-file browser.webm` | `client.calls.browserRecording(id, recordingId)` |
| `GET /api/v1/history/messaging/{id}/browser-recordings` | `list_history_browser_recordings` (`kind: messaging`) | `famulor list-messaging-browser-recordings <id>` | `client.api.listMessagingBrowserRecordings({path:{id}})` |
| `GET /api/v1/history/messaging/{id}/browser-recordings/{recordingId}` | `get_history_browser_recording` (`kind: messaging`) | `famulor get-messaging-browser-recording <id> <recordingId> --output-file browser.webm` | `client.api.getMessagingBrowserRecording({path:{id,recordingId}})` |

Los tickets caducan a los 60 segundos. `viewer_origin` solicita una URL WebSocket de solo lectura para ese origen exacto. Las descargas requieren la misma credencial del espacio y el permiso `calls:read`. MCP devuelve una ruta de descarga autenticada. Mantén las claves API en tu servidor.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.