# #phone

Este helper está diseñado para ayudarte a extraer o transformar el valor de un número de teléfono de forma sencilla a estructuras personalizadas.

Habitualmente usarás este helper para identificar valores del número de teléfono en Webhooks hacia plataformas para envío de notificaciones como SMS, llamadas telefónicas, WhatsApp, Telegram u otros.

## Modo de uso

Este helper debe recibir tres valores en el siguiente orden:

1. `phone`: Número de teléfono que deberás extraer desde los datos
2. `country`: Código del país, que deberás extraer desde los datos
3. `format`: El formato de salida que esperas. Los valores disponibles son: `code`, `code-plus`, `international` y `national`. Por defecto, es `international`.

{% code title="Ejemplo" %}

```handlebars
{{phone-number customer.phone location.countryCode 'international' }}
```

{% endcode %}

En el caso de este ejemplo, la salida sería `+12345678900`.

{% code title="Ejemplo full" %}

```handlebars
{
    "code": {{phone-number customer.phone location.countryCode 'code' }},
    "number": {{phone-number customer.phone location.countryCode 'national' }},
    "fullNumber": {{phone-number customer.phone location.countryCode 'international' }},
}
```

{% endcode %}

## Formatos

La diferencia entre `international` y `national`, es que el primer contiene el codigo de país y el símbolo `+`. Y entre de formato entre `code` y `code-plus` es que este último incluye el símbolo `+` como sufijo.

El valor del número de teléfono puede ser con o sin código de país, con o sin espacios e no sensible si incluye el símbolo `+`. Es decir, `+12345678900`, `12345678900`, `2345678900` o `+1 234 567 8900`.

### `international`

```handlebars
{{phone-number 12345678900 'US' 'international' }}
```

Salida: `+12345678900`

### `national`

```handlebars
{{phone-number 12345678900 'US' 'national' }}
```

Salida: `2345678900`

### `code`

```handlebars
{{phone-number 12345678900 'US' 'code' }}
```

Salida: `1`

### `code-plus`

```handlebars
{{phone-number 12345678900 'US' 'code-plus' }}
```

Salida: `+1`


---

# Agent Instructions: 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:

```
GET https://docs.videsk.io/es-developers/webhooks/helpers/phone.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.