Aviso importante: finalización de la fase experimental de la API V1
Informamos a todos los clientes con acceso anticipado que damos por finalizada la etapa de pruebas, análisis y recogida de información de la versión V1 de la API de Witei.
Queremos agradecer sinceramente el esfuerzo y el tiempo dedicados por todos los usuarios que han decidido formar parte de esta iteración. Sus integraciones, pruebas e incidencias reportadas han sido fundamentales para identificar necesidades reales de uso, detectar limitaciones técnicas y definir la arquitectura de la siguiente versión.
Próximos pasos: API V2
A lo largo de las próximas semanas (fecha provisional: finales de diciembre) publicaremos la documentación técnica de la versión V2 de la API, que incorporará las siguientes mejoras:
Cobertura funcional ampliada, que permitirá interactuar con inmuebles, contactos, tareas y otras entidades del espacio de trabajo.
Límites de uso considerablemente más elevados, adecuados para integraciones con mayor volumen de peticiones.
Menos restricciones de acceso y configuración, que simplifican la puesta en marcha de nuevas integraciones.
La API V2 nace con el objetivo de convertirse en una herramienta de referencia para la integración de servicios de terceros, plataformas de inteligencia artificial, automatizaciones y sistemas externos con Witei.
Comunicaremos por los canales habituales la publicación de la documentación, así como las condiciones de uso y el calendario de transición desde la V1.
Usuarios de la API v1
Por motivos de compatibilidad, Witei mantendrá disponible la versión v1 de la API durante un periodo de tiempo suficiente para la migración a la API V2.
La finalización de la API V1 está prevista para el 1 de febrero de 2026.
Se mantiene la información documental de la versión V1 de la API por motivos históricos, pero ya no es válida.
Configuración de acceso API de clientes
Una vez completado el proceso de solicitud, el equipo de witei te confirmará la activación de la herramienta "API Clientes" en tu espacio de trabajo.
A continuación, podrás seguir los siguientes pasos para configurar el acceso API:
Paso 1: creación de un usuario específico para acceso API
Witei recomienda la creación de un usuario específico dentro del espacio de trabajo que será el que tenga asociado el acceso API.
Por motivos de seguridad, este usuario deberá tener la siguiente configuración de permisos:
No podrá ser un usuario de tipo administrador
No podrá tener el permiso "Cambio entre espacios de trabajo de la red"
Solo podrá tener acceso a "Ver" y "Editar" sus propios Contactos, Inmuebles y Tareas.
Deberá tener activo el permiso "Acceso API" (al final del listado de permisos).
Paso 2: obtención de token API
La conexión vía "API Clientes" requiere de un token único generado para el usuario creado en el Paso 1. Los pasos para obtenerlos serán:
Cierra la sesión de tu usuario actual y accede al nuevo usuario creado con el permiso "Acceso API".
Dirígete al área de Configuración > Integraciones > API
Haz clic en "Invalidar token actual y generar uno nuevo"
Notas importantes sobre el token API:
Este token permite a la persona que lo tenga acceso a los contactos, inmuebles tareas, etc. almacenados en el espacio de trabajo bajo las condiciones especificadas por los permisos en el "Paso 1".
No compartas este Token con terceros que no sean de tu confianza
Regenera el token cada cierto tiempo (como recomendación, cada 3 meses).
No compartas este Token con el equipo de Witei en una conversación con soporte.
En caso de sospechar que tu Token está siendo utilizado por un tercero sin autorización: accede al área de configuración > integraciones > API y regenera el token lo antes posible.
Paso 3: obtención de token API
En el mismo área de Configuración > Integraciones > API podrás acceder a la documentación técnica donde se explica cómo usar el token para realizar la verificación de identidad al realizar peticiones a la ".API Clientes"
Alternativas a la "API Clientes"
Integración mediante XML
Witei proporciona la posibilidad de exportar datos en formato XML.
Este formato es ampliamente utilizado en el sector y permite que otros portales, webs o aplicaciones puedan importar la información de manera estructurada.
Integración mediante Webhooks
Los webhooks permiten que Witei notifique automáticamente a un sistema externo cuando ocurre un evento determinado (por ejemplo, la creación o actualización de un inmueble).
De esta manera, se pueden mantener sincronizados los datos entre Witei y otras aplicaciones en tiempo real.
Preguntas frecuentes
¿Puedes usar Uso de la "API de Clientes" para sincronizar una web externa?
No. Witei no permite este tipo de integraciones debido a su altísima propensión a fallos que impiden el correcto funcionamiento de las webs externas. Si deseas mostrar tus inmuebles almacenados en witei sigue las indicaciones de nuestra guía:
¿Witei da soporte a integraciones externas realizadas vía API Clientes?
Witei no realiza auditorías o soporte sobre las integraciones de terceros. En caso de que detectes un comportamiento no esperado de la API, puedes contactar con el equipo de soporte incluyendo esta información:
Petición realizada en formato CURL sin incluir la cabecera con el Token e incluyendo la URL utilizada y el cuerpo de la petición (si corresponde)
Respuesta obtenida: Código HTTP de respuesta y cuerpo de la respuesta (formato JSON)
Respuesta esperada
Versión previa API Clientes
La anterior versión de la API de witei finalizó su disponibilidad el pasado mes de Agosto de 2024. Por motivos técnicos, se mantuvo activa de forma extendida para determinados escenarios.
