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.
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,idy, si corresponde,mediaoattachmentscon 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
- Abre el canal desde Canales y edítalo (o configúralo al crearlo).
- En Mapeo de campos pulsa Agregar.
- 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. - A la derecha elige el campo de Omnifox que llena ese dato.
- 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.idobligatorio: 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
Artículos relacionados
-
Cómo conectar Telegram
Conecta un bot de Telegram a tu bandeja de Omnifox en pocos minutos usando BotFather.
-
Guía completa del Webchat (chat para tu sitio web)
El Webchat a fondo, en 32 capítulos: instalarlo, apariencia, idiomas, formulario, departamentos, horario, disparadores, IA, la bandeja, identificación segura y API de JavaScript, con un sitio real de punta a punta.
-
Códigos de error de WhatsApp (Meta): qué significan y qué hacer
Tabla con los códigos de error de Meta más comunes al enviar por WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) y cómo resolver cada uno.
-
Pasar de WhatsApp por QR a Coexistence o Cloud API
Cuando termines de probar con el código QR, pasa tu número a la conexión oficial: sin topes, con plantillas, difusiones y sin riesgo de bloqueo por volumen.
-
Comentarios de Instagram y Facebook: responder y moderar desde Omnifox
Ve y responde los comentarios de tus publicaciones y anuncios de Facebook e Instagram, en público o en privado, y configura respuestas automáticas.