Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.
Mira este paso en el video · Las formas de conectar Omnifox
¿Qué es una integración?
Una integración conecta Omnifox con otras herramientas (tu CRM, una hoja de cálculo, n8n, Make, Zapier, Slack, HubSpot…) para que la información fluya automáticamente entre ellas. En Omnifox tienes tres formas de integrar, según lo que necesites:
- Webhook — Omnifox avisa a otra herramienta cuando pasa algo (llega un mensaje, se crea un contacto).
- OAuth — conectas un servicio externo con un par de clics, sin copiar claves (es lo que usan los conectores de la galería; hoy están en Próximamente, ver abajo).
- Clave de API — tú le pides datos a Omnifox o le mandas acciones desde tu propio código o desde una herramienta no-code.
Esta guía te ayuda a elegir cuál usar y dónde encontrarlas.
Qué está disponible hoy y qué está en Próximamente
Disponible hoy:
- n8n, Make y Zapier (webhooks en los dos sentidos) y Slack (avisos): en Configuración → Integraciones.
- Webhook propio (tu URL) y Cal.com (pegas tu API key): también en Configuración → Integraciones.
- API REST, webhooks salientes, servidor MCP y SDK: desde el plan Crece.
- Webhooks entrantes que disparan workflows: desde el plan Escala.
Próximamente: HubSpot, Salesforce, Shopify, Google Sheets, Google Meet, Gmail, Calendly, Stripe Payments, Zoom, Microsoft Teams, DocuSign, Dropbox Sign, PandaDoc, Notion y Outlook. Están construidas pero todavía no se pueden conectar: en Configuración → Integraciones su tarjeta aparece como «Próximamente» y se activarán cuando estén disponibles. Mientras tanto, puedes llegar a casi todas esas herramientas a través de n8n, Make o Zapier.
¿Cuál elijo?
- Quiero que cuando algo pase en Omnifox se dispare una acción en otra app → Webhook.
- Quiero conectar un servicio listo de la galería (HubSpot, Zoom, etc.) → OAuth (botón Conectar), cuando esté disponible. Mientras tanto → n8n, Make o Zapier.
- Quiero leer o crear datos en Omnifox desde mi sistema → Clave de API.
Requisitos
- Rol Administrador del workspace.
- Para webhooks y claves de API necesitas un plan con Acceso a API (disponible desde el plan Crece en adelante).
Pasos
Opción A — Conectar desde la galería (OAuth, próximamente)
Los conectores OAuth (HubSpot, Google, Microsoft, Zoom, etc.) todavía muestran «Próximamente». Cuando estén disponibles:
- Irás a Configuración → Integraciones.
- Buscarás el conector y pulsarás Conectar.
- Iniciarás sesión en el servicio externo y autorizarás el acceso.
Hoy, en esa misma pantalla, ya puedes conectar n8n, Make, Zapier, Slack, un webhook propio y Cal.com.
Opción B — Crear un webhook saliente
- Ve a Configuración → Webhooks → Nuevo webhook.
- Pega la URL de destino (la que te da n8n, Make, Zapier o tu servidor).
- Marca los eventos que quieres recibir:
message.received,message.sent,conversation.created,conversation.closed,contact.created,contact.updated. - Guarda y pulsa Enviar prueba (
test.ping) para confirmar que tu destino responde.
Opción C — Crear una clave de API
- Ve a Configuración → API Keys → Nueva clave de API.
- Ponle nombre, elige el workspace, una fecha de expiración y los scopes mínimos.
- Copia la clave al instante: solo se muestra una vez.
Verificación
- En Integraciones el conector aparece como Conectado.
- En Webhooks, el envío de prueba devuelve un
200. - Tu clave de API funciona con la cabecera
Authorization: Bearer.
Si algo no funciona
- No ves Webhooks ni Claves de API: tu plan no incluye Acceso a API; sube a Crece o superior.
- El webhook no llega: revisa que la URL sea pública (https) y devuelva
200rápido; mira los reintentos en el detalle del webhook. - La clave de API da 401: confirma que envías la cabecera
Authorization: Bearery que la clave no expiró.
Consejos
- Empieza por el camino no-code (n8n/Make/Zapier) con un webhook antes de escribir código.
- Da a cada integración solo los scopes que necesita.
Artículos relacionados
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
La API REST de Omnifox: introducción y requisitos de plan
Qué es la API REST de Omnifox, qué plan necesitas (desde Crece), cómo autenticar con la cabecera X-API-Key y dónde está la documentación.