# OneBox

Conecta OneBox para que el agente encuentre clientes, cree procesos y registre llamadas

> Full REST + WebSocket API reference: https://api.happ.tools/reference

OneBox es un CRM/ERP de ventas y pedidos. Una vez conectado, el agente encuentra al cliente y su último proceso por teléfono, crea procesos (pedidos o leads), sincroniza el catálogo y registra las llamadas.

## Antes de empezar [#before-you-start]

* **Las aplicaciones 'API v2' y 'API'** instaladas desde la tienda de aplicaciones de OneBox.
* **Un empleado dedicado** para el agente: OneBox mantiene una sesión de API por usuario, y la sesión ocupa una licencia de usuario. Genera la clave del empleado en la página **API v2 keys**.

## Conectar [#connect]

1. **Integraciones** > **Añadir integración** > **OneBox**.
2. Rellena la dirección de OneBox, el usuario del empleado y la contraseña de la REST API, y haz clic en **Conectar**.

| Campo                     | Valor                                          |
| ------------------------- | ---------------------------------------------- |
| Dirección de OneBox       | p. ej., `mybox.crm-onebox.com`                 |
| Usuario del empleado      | Usuario del empleado dedicado a la API         |
| Contraseña de la REST API | La clave del empleado de la página API v2 keys |

## Después de conectar [#after-connecting]

La tarjeta muestra el usuario y tu dirección de OneBox.

**Acepto que Happ reciba y almacene los datos de este CRM**: opcional. Si está marcado, Happ sincroniza contactos, negocios, leads y actividades; si no, no se almacena nada y la integración funciona directamente (herramientas del asistente, notas de llamadas). Al desconectar se retira el consentimiento y se eliminan los datos copiados.

El menú de la tarjeta también tiene **Llamadas por eventos del CRM**, **Copiar la URL del webhook**, **Rotar webhook** y **Registros de webhook**, para llamadas iniciadas por eventos del CRM.

Lo que el agente puede hacer se configura por agente: **Agentes** > el agente > **Integraciones** > la configuración de la integración.

* **Búsqueda de clientes**: encuentra al cliente por teléfono durante la conversación
* **Crear procesos**: con proceso de negocio y estado (obligatorios)
* **Catálogo**: busca productos mientras responde
* **Registrar llamadas**: escribe cada llamada en el CRM, opcionalmente con la transcripción completa

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Siguiente [#next]

* [CRM](/docs/integrations/crm): todas las integraciones de CRM
* [Herramientas](/docs/agents/tools): lo que el agente llama durante la conversación