SDKs oficiales de Omnifox para Node.js, Python y PHP

Qué son los SDKs oficiales de Omnifox, qué necesitas para usarlos y cuándo conviene un SDK en lugar de llamar a la API con curl.

Aug 19, 2026

Mira este paso en el video · SDK oficiales: Node, Python y PHP

Omnifox publica tres SDKs oficiales que envuelven la API REST v1 para que no tengas que armar peticiones HTTP a mano:

Los tres van por la versión 0.4 y cubren la plataforma completa: bandeja de entrada, contactos, CRM, tableros y proyectos, agenda y citas, catálogo, pedidos y cotizaciones, difusiones, flujos, webhooks y reportes.

Qué resuelven

  • Autenticación y reintentos. Ponen el encabezado Authorization: Bearer y reintentan solos ante 429 (respetando Retry-After) y ante errores 5xx pasajeros.
  • Paginación. Recorren listados largos sin que tú lleves la cuenta de páginas ni cursores.
  • Errores tipados. En vez de un JSON suelto, recibes una excepción con el código, el estado HTTP y los errores por campo.
  • Cosas que la API pide y no son obvias. Por ejemplo, cuatro endpoints exigen el id del espacio de trabajo dentro del cuerpo aunque el token ya esté fijado a uno; los SDKs lo rellenan por ti.

Requisitos

  • Un plan con Acceso a API: disponible desde Crece (Crece, Escala y Exclusivo). Lite, Impulsa y Conecta no lo incluyen.
  • Una clave de API creada en Configuración → Desarrollo → API Keys.
  • Node.js 20 o superior para el SDK de Node; Python 3.9 o superior para el de Python; PHP 8.1 o superior (con Composer) para el de PHP.

Instalación

# Node.js
npm install @omnifox/sdk

# Python
pip install omnifox

# PHP
composer require omnifox/sdk

Importante sobre la clave

Ninguno de los SDKs lee variables de entorno por su cuenta. La clave hay que pasarla siempre al constructor. Si guardas el token en OMNIFOX_API_KEY, eres tú quien lo lee y se lo entrega al cliente.

Lo que los SDKs no hacen

  • No suben archivos. Los adjuntos viajan como URL o como carga tipada; una subida real es multipart y ningún SDK la implementa.
  • No exponen el módulo Team ni Co-browse.
  • No reemplazan a los webhooks: para enterarte de eventos en tiempo real sigue siendo mejor recibir un webhook que consultar en bucle.

Consejos

  • Si solo vas a hacer dos o tres llamadas, curl o el cliente HTTP de tu lenguaje alcanzan. El SDK gana cuando hay paginación, reintentos y muchos módulos de por medio.
  • Si lo que quieres es que un asistente de IA opere sobre Omnifox, mira el servidor MCP: no requiere escribir código.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp