Conectar un Canal Personalizado (Custom Channel por webhook)

El Canal Personalizado (en el selector de tipo aparece como Custom Channel) es la "puerta de escape" para conectar cualquier sistema propio o legado que Omnifox no soporte de forma nativa: un CRM interno, un chat propietario, un sistema de tickets a medida. Funciona con dos URLs: una que Omnifox te da para recibir mensajes, y otra que vos das para que Omnifox te mande los salientes.

Requisitos

• Un sistema externo capaz de recibir peticiones HTTP POST con JSON y de exponer un endpoint propio
• Definir un nombre descriptivo para el canal (por ejemplo "CRM interno" o "Sistema legado")

Pasos para conectar

1. En Omnifox, andá a Canales → Conectar nuevo canal y elegí Custom Channel.
2. Guardá el canal para que Omnifox genere la Incoming Webhook URL y una Secret Key (ambas de solo lectura, con botón de copiar).
3. Completá la Outgoing Webhook URL: la dirección de tu sistema donde Omnifox va a mandar los mensajes salientes.
4. Configurá tu sistema externo para que envíe los mensajes entrantes (JSON) a la Incoming Webhook URL de Omnifox.
5. Opcional: definí Field Mappings (ver el artículo dedicado a mapeo de campos) si tu payload no usa los nombres por defecto.

Configuración

• Incoming Webhook URL: recibe JSON desde tu sistema; se usa para crear mensajes entrantes en el Inbox.
• Outgoing Webhook URL: adonde Omnifox hace POST cuando un agente responde.
• Secret Key: firma HMAC-SHA256 de cada request saliente (headers X-Omnifox-Signature, X-Omnifox-Timestamp, X-Omnifox-Channel-Type, X-Omnifox-Delivery).

Ejemplo

Un sistema de tickets interno recibe un pedido de soporte y lo posta al webhook de Omnifox con {"text": "necesito ayuda", "sender": "Juan", "id": "tk_123"}. Ese mensaje aparece en el Inbox; cuando el agente responde, Omnifox hace POST a tu Outgoing Webhook URL con el cuerpo por defecto (message_id, conversation_id, recipient, content, etc.).

Consejos

• Verificá siempre la firma HMAC del lado de tu sistema antes de procesar un request: evita que terceros inyecten mensajes falsos.
• Si tu sistema devuelve 4xx, Omnifox lo trata como error fatal (no reintenta); si devuelve 5xx o hay timeout, reintenta hasta 3 veces con backoff.

Solución de problemas

• Los mensajes salientes no llegan: revisá que la Outgoing Webhook URL responda 2xx dentro de 30 segundos.
• Los mensajes entrantes no se ven en el Inbox: confirmá que estás posteando a la Incoming Webhook URL exacta que te dio Omnifox, con Content-Type application/json.