# Agregar teléfono

La operación Agregar Teléfonos permite insertar uno o más números de teléfono en un registro de persona ya existente.

Esta acción es especialmente útil para enriquecer el perfil de un contacto con el tiempo. Si un lead, que inicialmente proporcionó solo el correo electrónico, informa su teléfono en una interacción posterior, puede usar esta operación para complementar el registro sin sobrescribir otros datos.

La operación agrega los nuevos teléfonos a la lista de contactos de la persona, manteniendo los que ya existían.

#### Cómo Configurar

1. En Hablla Studio, agregue el bloque "Personas" a su flujo de automatización.
2. En el campo "Operación", seleccione la opción "Agregar Teléfonos".
3. En el campo "ID de la Persona" (`personId`), inserte el identificador único de la persona a quien desea agregar los teléfonos.
4. En la sección "Teléfonos", complete los detalles del(os) número(s) que desea agregar.

***

### Parámetros (Usando Campos)

| Campo            | Tipo                | ¿Obligatorio? | Descripción                                                                                                                                                                   |
| ---------------- | ------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID de la Persona | Texto               | ✅ Sí          | El ID único de la persona que recibirá los nuevos números de teléfono.                                                                                                        |
| Teléfonos        | Colección de Campos | ✅ Sí          | Una lista que contiene uno o más teléfonos a agregar. Cada elemento de la lista debe incluir: `Tipo` (Personal o Business), `Teléfono` (el número) y `¿Es WhatsApp?` (sí/no). |

Exportar a las Hojas de Cálculo

***

### Estructura (Usando JSON)

El cuerpo de la solicitud JSON debe ser un arreglo llamado `phones`, que contenga uno o más objetos de teléfono.

JSON

```
{
  "phones": [
    {
      "type": "business",
      "phone": "+5511987654321",
      "is_whatsapp": true
    },
    {
      "type": "personal",
      "phone": "+5511912345678",
      "is_whatsapp": false
    }
  ]
}
```

***

### 🚀 Ejemplo de Caso de Uso

Objetivo: Cuando un cliente responde una encuesta de satisfacción y proporciona su número de WhatsApp para contacto, agregar ese número a su registro en Hablla.

1. Cree un flujo que comience con un desencadenador de Webhook, recibiendo los datos de la encuesta completada (incluyendo el correo electrónico y el nuevo teléfono).
2. Use la operación "Buscar Persona por Correo Electrónico" para encontrar el `personId` del cliente en base al correo electrónico recibido.
3. Agregue el bloque "Personas" con la operación "Agregar Teléfonos".
4. En el campo "ID de la Persona", inserte la variable del ID encontrada en el paso anterior (`{{steps.2.result.id}}`).
5. En la sección "Teléfonos", mapee los datos del teléfono recibidos en el desencadenador:
   * Tipo: Defínalo como `personal`.
   * Teléfono: Mapee la variable del teléfono proveniente del webhook.
   * ¿Es WhatsApp?: Defínalo como `true`.

De esta forma, los perfiles de sus clientes se enriquecen automáticamente con nueva información de contacto, centralizando la comunicación y garantizando que los datos estén siempre actualizados.


---

# 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.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/personas/agregar-telefono.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.