> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/hablla-docs-es/hablla/configuraciones/extensiones.md).

# Extensiones

El recurso de **Extensiones** permite configurar y gestionar los usuarios que podrán realizar y recibir llamadas a través del módulo de Telefonía de Hablla.

Cada usuario responsable de atenciones de voz puede tener una extensión asociada. De esta forma, las llamadas pueden ser **distribuidas automáticamente entre los usuarios disponibles** o transferidas de un agente a otro durante una atención.

{% hint style="warning" %}
**Importante:** el recurso de Extensiones está disponible para operaciones que utilizan el **módulo de Telefonía de Hablla**. Antes de configurar una extensión, es necesario tener una conexión de telefonía previamente configurada en tu espacio de trabajo.

Para saber más sobre la configuración y utilización de la Telefonía, consulta nuestra documentación [**haciendo clic aquí**](/hablla-docs-es/hablla/configuraciones/conexiones-e-integraciones/telefono.md).
{% endhint %}

### ¿Cómo funcionan las extensiones?

La extensión es el identificador único de un usuario habilitado para realizar y recibir llamadas telefónicas en la operación. Las extensiones también pueden participar en la distribución automática de atenciones, de acuerdo con las reglas del **algoritmo de desborde** configuradas para el sector.&#x20;

El propio usuario podrá controlar su disponibilidad para Telefonía dentro del entorno de Hablla; de esta forma, puede definir cuándo está **disponible** o **no disponible** para la recepción y/o transferencia de llamadas.

#### Principales funcionalidades

* **Transferencia de llamadas**: Permite transferir llamadas directamente entre agentes habilitados y disponibles.

> *Ejemplo:* Si el cliente solicita hablar con otro colaborador, la llamada podrá ser transferida si el destinatario tiene una extensión activa y estado disponible.

* **Distribución automática**: Las extensiones se integran al algoritmo de desborde del sector, recibiendo y distribuyendo llamadas automáticamente de acuerdo con las reglas configuradas.
* **Control de disponibilidad**: El propio usuario puede gestionar su estado de atención en el panel de Hablla, controlando la recepción y la transferencia de llamadas.

### Cómo configurar una extensión

{% stepper %}
{% step %}

### 1. Accede a la configuración de Extensiones

Dentro de **Studio Hablla**, haz clic en el ícono de **engranaje**, ubicado en la esquina superior derecha de la pantalla, para acceder a la configuración de tu espacio de trabajo. En el menú lateral izquierdo, localiza y haz clic en la opción **Extensiones**.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FZ8TKmp5T176ekEc8BlQa%2Framais.png?alt=media&amp;token=1e3b6b1b-cdb2-44ae-bfd8-e6903d8e1361" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 2. Agrega una nueva extensión

En la pantalla de **Extensiones**, haz clic en el botón **+ Agregar Extensión**, ubicado en la esquina superior derecha. Después de hacer clic, se mostrará una nueva ventana para que configures la información de la extensión.

{% endstep %}

{% step %}

### 3. Configura la extensión

Para crear la extensión, completa la información presentada en la pantalla.

#### **Descripción**

Define un nombre que facilite la identificación de la extensión. Recomendamos utilizar una descripción que contenga el **nombre del usuario y el número de la extensión**. De esta manera, será más fácil identificar posteriormente a quién pertenece esa extensión.

> Ejemplo: **`Tomaz [0133]`**.

#### **Extensión**

Indica el número que se utilizará para identificar esa extensión. Recomendamos utilizar una numeración estandarizada entre los usuarios de tu operación. Las extensiones de **cuatro dígitos** son una convención común y facilitan la organización, como `1001`, `1002`, `1003` y así sucesivamente.

> Ejemplo: **`0133`**.

Recomendamos utilizar una numeración estandarizada entre los usuarios de tu operación. Las extensiones de **cuatro dígitos** son una convención común y facilitan la organización, como `1001`, `1002`, `1003` y así sucesivamente.

#### **Tipo**

Define cómo el usuario utilizará la extensión. Actualmente, la configuración puede usar los tipos **Web** o **Dispositivo**.

* **Web:** permite que el usuario realice y reciba llamadas directamente en el entorno de Hablla, utilizando su propio navegador. Esta será la opción utilizada en nuestro ejemplo.
* **Dispositivo:** destinado a escenarios en los que la operación utiliza un dispositivo físico de telefonía asociado a la extensión.

{% hint style="info" %}
Para realizar configuraciones utilizando el tipo **Dispositivo**, te recomendamos ponerte en contacto con nuestro equipo de Soporte para recibir ayuda durante la configuración. **Habla con nuestro soporte** [**haciendo clic aquí**](https://wa.me/558000001351)**.**
{% endhint %}

#### **Usuario**

Selecciona el **usuario que será propietario de esa extensión**. Es a través de esta asociación que Hablla identifica qué usuario deberá utilizar la extensión para realizar y/o recibir llamadas.
{% endstep %}

{% step %}

### 4. Agrega una Conexión

Después de definir la configuración de la extensión y seleccionar al usuario, será necesario asociar una **Conexión de Telefonía**. En la sección **Configuración de Conexiones**, haz clic en **+ Agregar Conexión**.

Se mostrarán los campos necesarios para definir qué conexión será utilizada por la extensión.

**Conexión**

Selecciona una de las **Conexiones de Telefonía configuradas en tu espacio de trabajo**. Esta conexión será la responsable de permitir que la extensión utilice la estructura de telefonía configurada en Hablla.

{% hint style="warning" icon="triangle-exclamation" %}
Si no hay ninguna conexión disponible para seleccionar, verifica primero si la Telefonía ya fue configurada correctamente en tu espacio de trabajo.
{% endhint %}

**Tipo de Conexión**

Define qué operaciones podrá realizar la extensión utilizando esa conexión. Según la necesidad de tu operación, podrás configurar la conexión para:

* **Realizar llamadas:** utilizada para llamadas salientes;
* **Recibir llamadas:** utilizada para llamadas entrantes;
* **Realizar y recibir llamadas:** permite usar la conexión tanto para llamadas entrantes como salientes.

Elige la opción de acuerdo con la finalidad de esa extensión.
{% endstep %}

{% step %}

### 5. Guarda la extensión

Después de finalizar todas las configuraciones, haz clic en el botón **Guardar** ¡y listo! La extensión quedará asociada al usuario seleccionado y configurada.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2F2HlmCMTWA5QWfcKRVy24%2F%5BDOCS%5D%20-%20Como%20Cadastrar%20Ramais.gif?alt=media&amp;token=09a1e939-e15e-4baa-b762-e090a9e8b0f4" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Disponibilidad para llamadas

Después de crear la extensión, el usuario asociado podrá controlar su **disponibilidad para llamadas** directamente en el entorno de Hablla.

#### Actualiza el entorno del usuario

Si el usuario para el que se configuró la extensión **ya tenía Hablla abierto en el momento de la configuración**, será necesario realizar un **recargado forzado de la página** para que se muestre la opción de disponibilidad para llamadas.

Para ello, utiliza el atajo:

**`Ctrl + Shift + R`**

Este comando obliga al navegador a recargar la página y actualizar los recursos utilizados por Hablla.

#### Accede al estado de disponibilidad

Después de actualizar la página, haz clic en el **botón morado con el ícono de flecha**, ubicado en el lateral izquierdo de la pantalla, para expandir el área donde quedan centralizadas las atenciones del usuario.

En la parte inferior de esa área, se mostrarán las opciones de disponibilidad para los diferentes tipos de atención:

* **Mensajes:** controla la disponibilidad del usuario para atenciones de mensajería;
* **Llamadas:** controla la disponibilidad del usuario para atenciones de telefonía.

En la opción **Llamadas**, el usuario podrá cambiar su estado entre **Disponible** y **No disponible**.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FYZSVwkQls4fvv8LlCOjg%2F%5BDOCS%5D%20-%20Como%20Verificar%20Status%20de%20Disponibilidade.gif?alt=media&amp;token=f76b0edd-1e9c-46ee-8429-20f8f6a437d7" alt=""><figcaption></figcaption></figure>

#### Disponible

Cuando el usuario esté **Disponible para llamadas**, su extensión estará apta para recibir nuevas llamadas y transferencias realizadas por otros agentes.

#### No disponible

Cuando el usuario esté **No disponible para llamadas**, su extensión no estará disponible para recibir nuevas llamadas y/o transferencias de llamadas.

{% hint style="warning" icon="triangle-exclamation" %}
**Importante:** para que una llamada sea dirigida o transferida a determinado usuario, este deberá tener una extensión correctamente configurada y estar con el estado **Disponible** en **Llamadas**.
{% endhint %}

### ¡Todo listo!

Con la extensión configurada y el usuario disponible para llamadas, podrá participar normalmente en tu operación de Telefonía en Hablla.&#x20;

A partir de esta configuración, las llamadas podrán ser dirigidas a los usuarios disponibles según las reglas de tu operación, además de permitir la **transferencia de llamadas entre agentes** cuando sea necesario.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/hablla-docs-es/hablla/configuraciones/extensiones.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
