Canal personalizado: qué es y cómo configurarlo
Conecta a Omnifox tu propio sistema (app, plataforma o CRM a medida) con el canal personalizado: cómo funciona y cómo configurarlo paso a paso.
El canal personalizado (en el selector aparece como Custom Channel) conecta con Omnifox cualquier sistema propio que no tenga un conector nativo: tu app, tu plataforma de reservas, un chat interno, un sistema de tickets o un CRM hecho a medida. Los mensajes de tus usuarios llegan a la bandeja de Omnifox como los de cualquier otro canal, y las respuestas de tus agentes, del agente de IA o de tus flujos vuelven a tu sistema.
Este artículo explica qué es y cómo configurarlo desde la pantalla. Para la parte de programación (formato de los mensajes, firma, eventos y ejemplos de código) comparte con tu desarrollador la Guía técnica de integración del canal personalizado.
Contenido
- Cómo funciona
- Antes de empezar
- Crear el canal paso a paso
- Unir con contactos existentes: cuándo encenderlo
- Qué pasa cuando el canal está activo
- Lo que el canal personalizado no hace
- Problemas frecuentes
1. Cómo funciona
El canal usa dos direcciones web y una clave:
- URL de webhook entrante: la genera Omnifox. Tu sistema envía ahí cada mensaje de tus usuarios.
- URL del webhook saliente: la pones tú. Omnifox envía ahí las respuestas y los avisos de lo que pasa en la conversación (asignada, cerrada, leída…).
- Clave secreta: una sola clave firma los mensajes en los dos sentidos, para que nadie pueda hacerse pasar por tu sistema ni por Omnifox.
Cada mensaje que llega identifica a la persona con un ID de contacto (el ID de ese usuario en tu sistema). Cada ID distinto es un contacto distinto en Omnifox, con su propia conversación.
2. Antes de empezar
- El canal personalizado está incluido en los planes Escala y Exclusivo.
- Necesitas que tu sistema pueda enviar solicitudes HTTP con JSON y recibir las que envía Omnifox en una dirección pública con HTTPS. Normalmente lo configura tu desarrollador.
- Decide un nombre claro para el canal, por ejemplo App de reservas o Portal de clientes.
3. Crear el canal paso a paso
- Ve a Configuración → Canales → Conectar nuevo canal y elige Custom Channel.
- Escribe el Nombre del canal.
- Copia la URL de webhook entrante con el botón de copiar y entrégasela a tu desarrollador. Se genera una sola vez y no cambia al editar el canal. Empieza a recibir mensajes en cuanto guardas el canal.
- Pega en URL del webhook saliente la dirección de tu sistema donde Omnifox debe enviar las respuestas, por ejemplo
https://tu-sistema.com/omnifox. Es opcional, pero sin ella el canal solo recibe: las respuestas de los agentes y de la IA quedan como fallidas. - Copia la Clave secreta y entrégala a tu desarrollador por un medio seguro. Si alguna vez se filtra, pulsa Regenerar, guarda el canal y actualiza la clave en tu sistema: la anterior deja de funcionar.
- En Unir con contactos existentes deja Unir por teléfono y Unir por correo apagadas, salvo que tengas claro que las necesitas (ver la sección 4).
- En Eventos a enviar elige qué avisos quieres recibir en tu sistema además de los mensajes (que se envían siempre): conversación creada, asignada o transferida, cerrada, reabierta, prioridad cambiada, etiqueta agregada, la IA pasó la conversación a una persona, el agente leyó la conversación, entre otros. Todos vienen marcados.
- Mapeo de campos (opcional): úsalo solo si tu sistema no puede enviar el formato estándar de Omnifox. Pulsa Agregar y, en cada fila, escribe a la izquierda la ruta del dato en tu JSON (por ejemplo
data.user.id) y elige a la derecha el campo de Omnifox que llena. Detalles en Canal personalizado: mapeo de campos. - Pulsa Continuar. Si pusiste URL saliente, Omnifox le envía un mensaje de prueba firmado y espera una respuesta correcta (código 2xx) en menos de 5 segundos. Si tu sistema no responde bien, verás el error y el canal no se guarda hasta que lo corrijas. Si dejaste la URL saliente vacía, el canal se guarda directamente.
Consejo: si tu sistema todavía no está listo para recibir, crea el canal sin URL saliente, prueba la entrada de mensajes y agrega la URL más tarde editando el canal.
4. Unir con contactos existentes: cuándo encenderlo
Estas dos casillas deciden qué pasa con el primer mensaje de un ID de contacto nuevo:
- Apagadas (recomendado): cada usuario de tu sistema crea su propio contacto en Omnifox. Si su teléfono ya pertenece a otro contacto, el nuevo se crea sin teléfono para no mezclarlos.
- Unir por teléfono: si ya existe un contacto con ese teléfono (por ejemplo, porque te escribió antes por WhatsApp), el usuario se vincula a ese contacto.
- Unir por correo: si no hubo coincidencia por teléfono, se busca un contacto con el mismo correo.
Atención: si encienden estas opciones, dos personas distintas que comparten teléfono o correo (una familia, una oficina, un correo genérico como info@) terminarían en el mismo contacto y en la misma conversación. Enciéndelas solo si en tu sistema cada teléfono o correo pertenece a una única persona.
5. Qué pasa cuando el canal está activo
- Los mensajes de tus usuarios entran a la Bandeja de entrada con texto, imágenes, video, audio o archivos.
- Funcionan igual que en los demás canales: asignación por equipos, agente de IA del canal, flujos y automatizaciones, etiquetas y notificaciones.
- Tu sistema puede pedir que una conversación nueva vaya a un equipo o a un agente concreto, y puede actualizar el nombre, teléfono, correo y campos personalizados del contacto.
- Cuando alguien responde, Omnifox envía la respuesta a tu URL saliente indicando quién respondió: una persona, el agente de IA o un flujo.
- Tu sistema puede avisar cuándo tu usuario recibió y leyó cada respuesta, y en la bandeja se ven las marcas de entregado y leído.
6. Lo que el canal personalizado no hace
- No muestra el indicador "escribiendo…".
- No permite editar ni borrar mensajes, ni reacciones.
- Admite una sola URL saliente por canal.
- No aplica la ventana de 24 horas de WhatsApp: puedes responder en cualquier momento.
7. Problemas frecuentes
- Al pulsar Continuar aparece un error del webhook: tu URL saliente no respondió con un código 2xx en 5 segundos. Revisa que la dirección sea correcta y pública, o déjala vacía por ahora.
- No entra ningún mensaje: confirma con tu desarrollador que usa la URL entrante exacta y la clave secreta actual (si pulsaste Regenerar, la anterior ya no sirve).
- Las respuestas aparecen en rojo como fallidas: falta la URL saliente o tu sistema la está rechazando.
- Todos los mensajes caen en el mismo contacto: tu sistema está enviando el mismo ID de contacto para todos los usuarios.
- Un usuario apareció dentro de un contacto que ya existía: está encendida alguna opción de Unir con contactos existentes.
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.