Canal personalizado: mapeo de campos

Usa el mapeo de campos para que Omnifox entienda el JSON de tu sistema sin cambiarlo. Solo aplica a los mensajes entrantes.

Jul 11, 2026

El mapeo de campos del canal personalizado sirve cuando tu sistema no puede enviar los mensajes en el formato estándar de Omnifox. En vez de cambiar tu sistema, le indicas a Omnifox en qué parte de tu JSON está cada dato.

Nota: el mapeo es solo de entrada (mensajes que llegan de tu sistema). Lo que Omnifox envía a tu URL saliente tiene siempre el mismo formato, descrito en la Guía técnica de integración: tu sistema debe adaptarse a él.

Cuándo lo necesitas

  • No lo necesitas si tu sistema ya envía contact.id, text, id y, si corresponde, media o attachments con esos nombres.
  • Sí lo necesitas si tu sistema ya genera un JSON propio que no puedes cambiar, por ejemplo {"data":{"user":{"uid":"..."}}}.

Cómo configurarlo

  1. Abre el canal desde Canales y edítalo (o configúralo al crearlo).
  2. En Mapeo de campos pulsa Agregar.
  3. A la izquierda escribe la ruta del dato en tu JSON, con puntos: data.user.id. Para listas usa el número de posición: items.0.url. Puedes empezar la ruta con $. si te resulta más cómodo.
  4. A la derecha elige el campo de Omnifox que llena ese dato.
  5. Repite por cada dato y pulsa Continuar para guardar.

Campos de Omnifox disponibles

Campo de Omnifox Para qué sirve
ID del contacto (obligatorio) El ID del usuario en tu sistema. Si no llega directo ni mapeado, el mensaje se rechaza.
Nombre, teléfono, correo y URL de la foto del contacto Datos del contacto.
Texto del mensaje El texto.
Tipo de mensaje text, image, video, audio o file.
ID del mensaje (deduplicación) Evita duplicados si tu sistema reenvía el mismo mensaje.
URL, leyenda, tipo MIME y nombre del archivo multimedia Un adjunto. Si mapeas alguno de estos, se ignora la lista attachments del mensaje.
Lista de adjuntos Una lista de adjuntos completa.
Equipo (id o nombre) y Agente (id o correo) A quién asignar una conversación nueva o sin asignar.
Campo personalizado: nombre Aparece uno por cada campo personalizado de contacto creado en tu espacio de trabajo.

Reglas

  • Lo que mapeas tiene prioridad sobre un campo con el nombre estándar.
  • Si la ruta no existe en un mensaje concreto, esa fila simplemente no hace nada.
  • La firma del mensaje se verifica siempre sobre tu JSON original; el mapeo se aplica después.
  • Las rutas son simples: no admiten comodines, filtros ni transformaciones.

Ejemplo

Tu sistema envía:

{"data":{"user":{"uid":"user-M","nombre":"Mario"},"msg":{"mid":"m-1","cuerpo":"Hola","foto":"https://cdn.example.com/a.jpg"}}}

Con estas filas:

Ruta en tu JSON Campo de Omnifox
data.user.uid ID del contacto
data.user.nombre Nombre del contacto
data.msg.cuerpo Texto del mensaje
data.msg.mid ID del mensaje
data.msg.foto URL multimedia

Omnifox crea el contacto user-M con el nombre "Mario" y un mensaje de imagen con la leyenda "Hola".

Problemas frecuentes

  • Error de contact.id obligatorio: la ruta del ID del contacto no coincide con tu JSON. Revisa mayúsculas, puntos y niveles.
  • El mensaje llega sin texto o sin imagen: la ruta de ese dato está mal escrita o apunta a otro nivel.
  • Mi sistema espera otro formato en las respuestas: no existe mapeo de salida; adapta tu receptor al formato fijo de Omnifox.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp