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: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
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:
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.
Prueba y verifica
Que el webhook reciba los datos no garantiza que la llamada quede en el contacto correcto. Antes de publicar:- Envía una llamada entrante de prueba y confirma que se ejecuta la rama de entrantes.
- Verifica que el número De identificó al contacto correcto y que la llamada quedó registrada en él.
- Envía una llamada saliente de prueba y confirma que se ejecuta la rama de salientes.
- Verifica que el número Para identificó al contacto correcto.
- Abre el contacto y revisa la llamada en su conversación: dirección, fecha y hora, números, estado y grabación.
- Publica el flujo cuando los resultados sean los esperados.
- 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?
¿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?
¿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?
¿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?
¿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?
¿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?
¿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
Recibe datos de sistemas externos en tus flujos.
Cómo funcionan los flujos
Disparadores, acciones y ramas.
Telefonía y SMS
Llamadas desde el sistema telefónico de Chateea.
La bandeja unificada
Dónde ves las llamadas registradas.

