Ir al contenido principal

Construyendo Integraciones con la API de CompanyCam

Aprende a usar la API de CompanyCam para generar claves, construir una integración personalizada y conectar Proyectos y Fotos con tu propio software.

La API de CompanyCam te permite leer, crear, actualizar y eliminar Proyectos, Fotos y la mayoría de los demás datos de CompanyCam desde tus propios sistemas. Este artículo explica qué puede hacer la API, cómo generar claves y adónde ir si quieres crear una integración para que otros clientes de CompanyCam la usen.

Esta función solo está disponible en la aplicación web.


Cómo funciona la API

Nuestra API es una API basada en REST, diseñada para funcionar con tu stack tecnológico actual. Puedes usarla para:

  • Crear Proyectos desde tu CRM

  • Sincronizar Fotos con tu software de gestión de obras

  • Suscribirte a un webhook cuando se etiquete una Foto

  • Leer y escribir Páginas, Listas de Tareas y Grupos de Proyectos

No necesitas una cuenta de desarrollador aparte para crear con la API: registrarte en CompanyCam te da la misma cuenta en cualquier caso. Si eres nuevo en CompanyCam, crea una cuenta de CompanyCam para empezar tu prueba gratuita de 14 días. Si ya tienes cuenta, verifica que tengas un Plan Pagado.

Nota: Los Admins y Managers pueden generar claves y gestionar integraciones personalizadas. Los Usuarios Standard todavía no pueden generar claves.


Aplicaciones

En CompanyCam, una Aplicación es la integración en sí: su identidad y registro. Es distinta de una Clave de Aplicación, que es la credencial que autoriza el acceso en su nombre. Registra la Aplicación una vez y, después, crea tantas Claves de Aplicación como necesites.

Si piensas publicar tu integración en el Marketplace de Apps de CompanyCam, la Aplicación también te da credenciales OAuth 2.0 propias, para que cualquier cliente pueda instalarla y autorizarla sin compartir una clave personal.

Consulta Registrando una Aplicación para conocer los pasos de configuración.

Nota: Necesitas registrar una Aplicación antes de poder crear una Clave de Aplicación, incluso para una integración privada creada solo para tu equipo. Los Tokens de Acceso Personal no requieren este paso.


Generando una clave

Necesitas una clave para autenticar tu integración. Hay 2 tipos:

  • Token de Acceso Personal: vinculado a tu cuenta de Usuario. Úsalo para scripts personales rápidos o para pruebas.

  • Clave de Aplicación: vinculada a una integración específica, no a una persona.

Al crear una clave, también eliges un nivel de permiso (Solo lectura, Lectura y escritura, Acceso completo o Personalizado) y le das un nombre para poder identificarla después.

Nota: Solo los Admins y Managers pueden generar una clave. Las claves y los tokens vencen, así que revisa la página de Tokens de Acceso periódicamente y genera una nueva antes de que venza la clave de una integración activa, o dejará de funcionar.

Consulta Creando Tokens y Claves para ver los pasos exactos para generar y copiar tu clave.


Publicando una integración para todos los clientes de CompanyCam

Construir algo solo para tu propia empresa es un camino posible. Si quieres construir una integración y publicarla para que cualquier cliente de CompanyCam pueda instalarla, es un proceso distinto, y para eso sirve una Aplicación (como vimos arriba). Consulta nuestra guía para asociarte con CompanyCam para ver qué implica.


Primeros pasos con la documentación

Nota: Nuestro equipo de Soporte puede orientarte hacia la documentación correcta, pero no son desarrolladores. Solucionar problemas de una integración personalizada debe hacerse de tu lado o con tu equipo de desarrollo.

Recomendamos trabajar con alguien que tenga experiencia en API para asegurarse de que todo esté configurado correctamente.

Toda la documentación para desarrolladores ahora vive en nuestro Portal para Desarrolladores, que incluye la referencia interactiva de la API, una colección de Postman, la especificación de OpenAPI y un registro de cambios público. Esto reemplaza nuestro antiguo sitio de documentación.

Importante: Si actualmente estás construyendo sobre la API Antigua de CompanyCam, tienes hasta el 1 de septiembre de 2027 para migrar a esta. Después de esa fecha, dejará de funcionar.


Conectando la IA a tus datos de CompanyCam

CompanyCam también ofrece un MCP Server en Beta, que te permite conectar herramientas de IA como Claude o Cursor directamente a tus datos de CompanyCam. Una vez conectado, puedes usar lenguaje simple para consultar, leer, crear y actualizar la mayoría de los datos en CompanyCam, como Proyectos y Fotos.

Consulta Conectando el MCP Server de CompanyCam para ver los pasos de configuración.


Preguntas Frecuentes

¿Necesito una cuenta de desarrollador para la API?

Una cuenta de desarrollador no es necesaria para usar la API. Registrarte en CompanyCam crea la misma cuenta en ambos casos.

¿Pueden los Admins y Managers generar una clave?

Los Admins y Managers pueden generar claves y configurar integraciones personalizadas.

¿Pueden los Usuarios Standard generar una clave?

Los Usuarios Standard todavía no pueden generar claves.

¿En qué se diferencian los Tokens de Acceso Personal de las Claves de Aplicación?

Los Tokens de Acceso Personal están vinculados a tu cuenta y funcionan bien para uso personal. Las Claves de Aplicación están vinculadas a la integración en sí y funcionan mejor para todo lo que se comparte con un equipo.

¿Cuál es la diferencia entre una Clave de Aplicación y una Aplicación?

Una Clave de Aplicación autentica una integración privada creada para tu propio equipo. Una Aplicación es una credencial OAuth 2.0 independiente que usan los desarrolladores externos que crean una integración para el Marketplace de Apps de CompanyCam.

Consulta Registrando una Aplicación para conocer los pasos.

¿Qué pasa con mi integración existente creada sobre la API antigua de CompanyCam?

Las integraciones creadas sobre la API antigua de CompanyCam seguirán funcionando hasta el 1 de septiembre de 2027. Después de esa fecha, es necesario migrar a esta API para que sigan funcionando.

¿Puedo publicar mi integración para otras empresas?

Publicar una integración para todos los clientes de CompanyCam es un camino distinto al de crear una solo para tu empresa.

Consulta nuestra guía para asociarte con CompanyCam para conocer la vía pública.

¿Puede el equipo de Soporte de CompanyCam ayudarme a solucionar problemas de mi integración?

El equipo de Soporte de CompanyCam puede orientarte hacia la documentación y los recursos correctos, pero no son desarrolladores. Solucionar problemas de una integración personalizada debe hacerse de tu lado o con tu equipo de desarrollo.


💡 ¿Necesitas más ayuda?

Contacta a nuestro Equipo de Soporte — estamos disponibles de lunes a viernes.

La Comunidad de CompanyCam ofrece ejemplos reales de obras, plantillas y consejos de equipos que utilizan la herramienta a diario. Únete para hacer una pregunta o simplemente para explorar.

¿Ha quedado contestada tu pregunta?