Skip to content
ioZen

Herramientas para Desarrolladores ioZen: API, Webhooks e Integraciones

ioZen ofrece una API REST y webhooks salientes para equipos que necesitan acceso programático. Construye integraciones personalizadas, automatiza flujos de trabajo o conecta ioZen a tus sistemas existentes. Consulta todas las funcionalidades disponibles.

Qué está disponible

Section titled “Qué está disponible”
FunciónPlanQué hace
API RESTPro+Lee/escribe envíos, lista bots, gestiona webhooks
Webhooks SalientesBusinessNotificaciones de eventos en tiempo real a tus endpoints
Llaves de APIPro (3) / Business (10)Autenticación con permisos y rate limiting (ver precios)

API REST

Section titled “API REST”

La API vive en https://app.iozen.ai/api/v1/. Sigue convenciones REST con cuerpos de petición/respuesta en JSON.

Qué puedes hacer:

  • Listar y leer IntakeBots
  • Crear y obtener envíos
  • Registrar y gestionar endpoints de webhook

Cada petición requiere una llave de API en el header Authorization. Las llaves tienen permisos específicos, para que puedas limitar lo que cada integración puede acceder.

Límites de velocidad: Pro tiene 100 peticiones/min, Business tiene 500 peticiones/min. Los headers de rate limit se incluyen en cada respuesta.

Para la referencia completa de endpoints, detalles de autenticación y ejemplos de código, ve la Documentación para Desarrolladores.

Webhooks Salientes

Section titled “Webhooks Salientes”

Los webhooks envían eventos a tus endpoints en tiempo real. En lugar de consultar la API, registra una URL y ioZen envía peticiones HTTP POST cuando suceden cosas.

Eventos disponibles:

EventoCuándo se dispara
submission.completedAlguien completa un IntakeBot
submission.updatedLos datos o estado de un envío cambian
contact.createdSe crea un nuevo contacto
contact.updatedSe actualiza un contacto
intake-bot.status-changedEl estado de un bot cambia (ACTIVE → PAUSED, etc.)

Cada payload de webhook está firmado con HMAC-SHA256, para que puedas verificar que vino de ioZen. Las entregas fallidas se reintentan automáticamente con backoff exponencial. Después de 10 fallos consecutivos, el endpoint se pausa.

Para código de verificación de firma (Node.js, Python), detalles de reintentos y mejores prácticas, ve la Guía de Webhooks.

Gestión de Llaves de API

Section titled “Gestión de Llaves de API”

Crea y gestiona llaves desde Configuración del Workspace → Llaves de API. Solo Owners y Admins pueden gestionar llaves.

Permisos disponibles: read:intake-bots, write:intake-bots, read:submissions, read:contacts, read:records, manage:webhooks

Las llaves siguen el formato con prefijo iozen_live_ para que sean fáciles de detectar en escáneres de git y gestores de secretos. Establece fechas de expiración para acceso temporal. Las llaves revocadas dejan de funcionar en 60 segundos.

Siguientes pasos

Section titled “Siguientes pasos”