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

# Acción de flujo: registrar llamada externa

> Registra en el historial del contacto las llamadas hechas con otro sistema telefónico usando una acción de flujo.

La acción de flujo de trabajo **Registrar llamada externa** (Log External Call) agrega al historial de un contacto las llamadas que tu equipo hizo o recibió con otro sistema telefónico. La llamada queda en la conversación del contacto con su dirección, fecha, números, estado y, si está disponible, la grabación. Así tienes toda la actividad del cliente en Chateea aunque no todas las llamadas pasen por el sistema telefónico de Chateea.

## Para qué sirve

* **Historial completo:** las llamadas externas quedan asociadas al contacto correcto, junto al resto de sus mensajes.
* **Visibilidad de otros sistemas:** traes a Chateea la información de tu proveedor de llamadas externo.
* **Datos de cada llamada:** guardas dirección, fecha, números de origen y destino y estado.
* **Acceso a grabaciones:** puedes incluir la referencia de la grabación para escucharla desde la conversación.
* **Flexibilidad:** la acción usa cualquier dato disponible en el flujo, incluidos los que llegan por webhook.

## Cómo funciona

La acción toma los datos de la llamada que tenga el flujo y los registra en un contacto. Por eso necesitas dos cosas: que los datos de la llamada lleguen al flujo y que el flujo identifique al contacto correcto.

El esquema más común es este:

```text theme={null}
Sistema de llamadas externo → Webhook entrante → identificar o crear el contacto → Registrar llamada externa → conversación del contacto
```

Por ejemplo, tu proveedor de llamadas envía los datos al **Webhook entrante** de Chateea cuando termina una llamada. El flujo distingue si fue entrante o saliente, identifica al contacto y registra la llamada.

> [!NOTE]
>
> El webhook entrante es la forma más habitual de recibir los datos, pero no es obligatorio. La acción puede usar cualquier valor disponible en el contexto del flujo.

## Campos de la acción

| Campo | Qué representa | Qué mapear |
| - | - | - |
| **Dirección** | Si la llamada fue entrante o saliente | El valor de dirección que envía tu sistema |
| **Fecha** | Cuándo ocurrió la llamada | La fecha y hora de la llamada |
| **Para** | El número de destino | El número al que se llamó |
| **De** | El número de origen | El número desde el que se llamó |
| **Estado de la llamada** | El resultado registrado por el sistema | El valor que indica el resultado de la llamada |
| **Adjunto** | La grabación de la llamada | La referencia de grabación compatible, si existe |

> [!WARNING]
>
> Los valores de **Dirección**, **Fecha**, **Estado de la llamada** y **Adjunto** deben tener el formato que admite la acción. No des por hecho que un estado o una disposición personalizada de tu proveedor se traduce sola al campo equivalente de Chateea.

Para que los contactos coincidan bien, usa números en formato internacional E.164 siempre que puedas, por ejemplo `+15551234567`.

## Configuración con un webhook entrante

**1. Crea el flujo y agrega el webhook**

Ve a **Automatización → Flujos de trabajo**, crea un flujo nuevo o abre uno existente y agrega el disparador **Webhook entrante** (Inbound Webhook). Copia la URL que te da Chateea y configúrala en tu sistema de llamadas para que envíe ahí los datos de cada llamada.

El envío debe incluir, como mínimo: dirección de la llamada, número de origen, número de destino, fecha y hora, estado y, si existe, la referencia de la grabación.

**2. Envía datos de prueba**

Haz que tu sistema envíe una llamada de ejemplo al webhook, con los mismos campos que enviará en la operación normal. Confirma que Chateea la recibió y que ves todos los campos que necesitas.

**3. Separa llamadas entrantes y salientes**

Después del disparador, agrega una acción **Si/Si no** (If/Else) con una condición sobre el valor de dirección de la llamada. Crea una rama para las entrantes y otra para las salientes.

**4. Identifica o crea el contacto**

En cada rama, agrega una acción que identifique al contacto usando el número de la otra persona:

| Dirección | Número que identifica al contacto | Por qué |
| - | - | - |
| Entrante | **De** (número de origen) | El cliente llamó a tu negocio |
| Saliente | **Para** (número de destino) | Tu negocio llamó al cliente |

Usa **Crear contacto** si quieres que el flujo cree el contacto o lo asocie con uno existente según tus reglas de duplicados. Usa **Buscar contacto** si prefieres controlar qué pasa cuando el contacto existe o no existe, con ramas de **Contacto encontrado** y **Contacto no encontrado**.

**5. Agrega la acción Registrar llamada externa**

En cada rama, después de identificar al contacto, agrega **Registrar llamada externa**. En cada campo, abre el selector de valores personalizados, elige los datos que llegaron por el webhook y guarda.

> [!TIP]
>
> En **Estado de la llamada**, mapea el resultado técnico de la llamada (contestada, no contestada, ocupado, etc.), no la disposición que elige el agente, salvo que tu integración traduzca expresamente una a la otra.

> [!WARNING]
>
> La coincidencia de contactos depende de los datos que envíes y de tu configuración de duplicados. Prueba el flujo con registros representativos antes de procesar llamadas reales.

## Prueba y verifica

Que el webhook reciba los datos no garantiza que la llamada quede en el contacto correcto. Antes de publicar:

1. Envía una llamada entrante de prueba y confirma que se ejecuta la rama de entrantes.
2. Verifica que el número **De** identificó al contacto correcto y que la llamada quedó registrada en él.
3. Envía una llamada saliente de prueba y confirma que se ejecuta la rama de salientes.
4. Verifica que el número **Para** identificó al contacto correcto.
5. Abre el contacto y revisa la llamada en su conversación: dirección, fecha y hora, números, estado y grabación.
6. Publica el flujo cuando los resultados sean los esperados.

Si la llamada no aparece o aparece mal, revisa el historial de ejecución del flujo y confirma que:

* El webhook recibió los datos esperados.
* La condición Si/Si no eligió la rama correcta.
* Se encontró o se creó el contacto correcto.
* Los valores mapeados tenían contenido cuando se ejecutó la acción.
* La estructura de los datos que envía tu proveedor no cambió. Si cambió, vuelve a enviar una muestra y revisa el mapeo.

## Preguntas frecuentes

> **¿Necesito un webhook entrante para usar esta acción?**
>
> No es obligatorio. Es la forma más común de recibir datos de un sistema externo, pero la acción usa cualquier valor disponible en el flujo.

> **¿La acción necesita un contacto?**
>
> Sí. La llamada se registra en la actividad de un contacto, así que el flujo debe identificarlo antes. Si los datos llegan por webhook, usa una acción para buscar o crear el contacto primero.

> **¿Uso Crear contacto o Buscar contacto?**
>
> Crear contacto crea o asocia el contacto según tus reglas de coincidencia. Buscar contacto te da control explícito para decidir qué hacer si existe o si no existe.

> **¿Cómo evito crear contactos duplicados?**
>
> Envía siempre los números en el mismo formato, revisa tu configuración de duplicados y prueba con contactos reales. Buscar contacto te ayuda a comprobar si ya existe antes de crear uno.

> **¿Puedo incluir la grabación?**
>
> Sí. Mapea la referencia de grabación compatible que te da tu proveedor en el campo **Adjunto** y verifica que se pueda escuchar desde la conversación.

> **¿Por qué la llamada no aparece en Conversaciones?**
>
> Revisa la ejecución del flujo: que el webhook haya recibido los datos, que se haya ejecutado la rama correcta, que se identificara al contacto y que los campos tuvieran valores. Si tu proveedor cambió el formato de los datos, actualiza el mapeo.

## Artículos relacionados

> **[Disparador Webhook entrante](https://help.chateea.com/docs/automatizaciones/activador-premium-webhook-entrante.md)**
>
> Recibe datos de sistemas externos en tus flujos.

> **[Cómo funcionan los flujos](https://help.chateea.com/docs/automatizaciones/introduccion.md)**
>
> Disparadores, acciones y ramas.

> **[Telefonía y SMS](https://help.chateea.com/docs/telefonia/introduccion.md)**
>
> Llamadas desde el sistema telefónico de Chateea.

> **[La bandeja unificada](https://help.chateea.com/docs/conversaciones/bandeja-unificada.md)**
>
> Dónde ves las llamadas registradas.


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