La pestaña Integraciones del proyecto conecta un proyecto con otros sistemas:
- Webhooks salientes envían eventos del proyecto (tarea creada, sprint iniciado, documento creado…) a un punto final HTTPS de su propiedad, firmado para que el receptor pueda confiar en ellos.
- Tokens de webhook entrantes permiten que un sistema externo (una herramienta de formulario, GitHub, un script) cree tareas o comentarios en el proyecto.
- API pública tokens dan a otro sistema acceso con alcance, lectura o escritura a las tareas y tiempo del proyecto a través de la SolaProjects API.
- Disponibilidad de proveedores integrados muestra conexiones predefinidas (Slack, Microsoft Teams, GitHub, GitLab, Google Calendar, Google Drive, OneDrive, Zapier / IFTTT) y si se puede conectar cada una.
Úselo cuando un proyecto necesite comunicarse con otra herramienta, por ejemplo para enviar actualizaciones de tareas al panel de un cliente o convertir consultas del sitio web en tareas. Lo configuran los responsables de proyectos y los administradores, normalmente una vez por proyecto con su contacto de TI.
Hay dos páginas llamadas Integraciones. Esta página cubre la pestaña proyecto. El elemento Integraciones en la parte Espacio de trabajo de la barra lateral (
/projects/settings/integrations) es la conexión SolaCount de la organización — vea Conexión de la organización SolaCount a continuación y Presupuesto y finanzas.
#Dónde encontrarlo
| Barra lateral | Sección Proyecto → Integraciones (entre Automatizaciones y IA) |
| URL | /projects/{project}/integrations |
| Paleta de comandos | Integraciones · {project name} bajo Proyecto actual |
Quién lo ve:
- Plan: las integraciones son una función del plan Premium y también de Enterprise. En planes inferiores, la pestaña está oculta. Si vence un plan de pago, la pestaña desaparece y dejan de ofrecerse webhooks hasta que renueve.
- Rol: solo las personas que pueden editar el proyecto pueden cargar la pestaña (ver Permisos). Otros ven "No pudimos cargar las integraciones." con Reintentar.
#Recorrido por la pantalla
#Tarjeta de encabezado
Integraciones — Webhooks salientes, tokens entrantes e historial de entrega.
| Azulejo | Significado |
|---|---|
| Salientes | Webhooks de salida activos. |
| Tokens entrantes | Tokens de entrada activos y no revocados. |
| Entregas recientes | Intentos de entrega enumerados en Entregas recientes. |
| Entregas fallidas | Intentos fallidos entre ellos (rojo cuando es superior a cero). |
#Tarjeta de webhooks de salida
ENVIAR eventos del proyecto a un punto final HTTPS externo, firmado con HMAC-SHA256. Nuevo webhook en la parte superior derecha.
Cada tarjeta de webhook muestra el nombre, URL del punto final, una insignia de estado (Activo, Deshabilitado o Archivado), un chip por evento suscrito y {n} entregas · {n} fallidas. Acciones de fila (no en webhooks archivados): Editar, Probar, Rotar secreto, Archivar.
Estado vacío: No hay webhooks salientes — Cree uno para enviar eventos a un sistema externo.
#Tarjeta de tokens de webhooks de entrada
Permita que sistemas externos creen tareas/comentarios mediante POST con un token secreto. Nuevo token en la parte superior derecha.
Cada tarjeta de token: nombre, proveedor (Personalizado o GitHub) · último uso {date} o nunca usado, insignia Activo, Inactivo o Revocado. Acciones (no en tokens revocados): Rotar, Revocar.
Estado vacío: No hay tokens entrantes — Cree un token para aceptar webhooks entrantes.
#Tarjeta de API pública
Cree tokens de portador con alcance para puntos finales documentados de proyectos, tareas y entradas de tiempo. Botones: Documentación (abre la referencia de OpenAPI en una nueva pestaña) y Nuevo token.
Cada tarjeta de token: nombre, último uso {date} / nunca usado, insignia de estado, un chip por capacidad. Acciones: Rotar, Revocar.
Estado vacío: Sin tokens de API — Crear un token para la API pública.
#Tarjeta de entregas recientes
Intentos de entrega salientes y su resultado. Insignia con el recuento.
| Columna | Significado |
|---|---|
| Cuando | Fecha de la entrega. |
| Webhook | Nombre del webhook, o Webhook archivado. |
| Evento | Tipo de evento, p. ej. task.status_changed. |
| Estado | Entregado (verde), Pendiente (ámbar, esperando o reintentando), Fallido (rojo), Omitido. |
| Intentos | Cuántas veces SolaProjects ha intentado. |
| Respuesta | El código de estado HTTP devuelto por su punto final, error cuando no se recibió respuesta, o —. |
| (botón) | Reintentar en cualquier entrega que no se haya entregado. |
Estado vacío: No hay entregas aún — Los intentos de entrega aparecen aquí una vez que se dispara un evento o usted envía una prueba.
#Tarjeta de disponibilidad de proveedores nativos
Estado de conexión y requisitos previos de configuración para integraciones específicas del proveedor. Un mosaico por proveedor:
| Proveedor | Qué hace |
|---|---|
| Slack | Envía notificaciones del proyecto a Slack y recibe comandos de tareas desde Slack. |
| Microsoft Teams | Envía notificaciones del proyecto a canales de Teams y admite acciones de Teams. |
| GitHub | Vincula eventos del repositorio, incidencias, solicitudes de extracción y confirmaciones a tareas del proyecto. |
| GitLab | Vincula solicitudes de combinación de GitLab, incidencias y eventos de canalización a tareas del proyecto. |
| Google Calendar | Sincroniza los hitos del proyecto y las fechas de tareas con Google Calendar. |
| Google Drive | Adjunta o sincroniza documentos del proyecto con carpetas de Google Drive. |
| OneDrive | Adjunta o sincroniza documentos del proyecto con carpetas de OneDrive. |
| Zapier / IFTTT | Exponer SolaProjects disparadores y acciones a plataformas sin código. |
Cada tarjeta muestra un estado (Disponible, Pendiente, Activo, Fallido), la capacidad y uno de estos mensajes: Se detectó una configuración del proveedor en producción. o Hay un simulador local disponible; las credenciales de producción se configuran al activar. (el proveedor aún no está en producción para su organización). También puede mostrar Bloqueado por configuración pendiente: …, Notas de activación: …, Retorno OAuth pendiente., Último error: …, el último mensaje o el último evento recibido.
#Eventos que puedes enviar
Marque uno o más en el formulario de webhook:
| Evento | Enviado cuando |
|---|---|
task.created |
Se crea una tarea (incluyendo desde un webhook entrante). |
task.updated |
Se edita una tarea. |
task.status_changed |
Cambia el estado de una tarea. |
task.completed |
Una tarea se marca como terminada. |
task.blocked |
Una tarea se marca como bloqueada. |
comment.created |
Se añade un comentario a una tarea. |
doc.created |
Se crea un documento del proyecto. |
time_entry.created |
Se registra tiempo. |
milestone.completed |
Se completa un hito. |
sprint.started / sprint.completed |
Un sprint empieza / se completa. |
share_link.created |
Se crea un enlace para compartir con invitados. |
automation.run_failed / automation.rule_failed |
Falla una ejecución de automatización. |
ai.suggestion_applied |
Se aplica una sugerencia de IA. |
Cada solicitud es un POST JSON con las cabeceras X-SolaProjects-Event (tipo de evento), X-SolaProjects-Delivery (identificador de entrega), X-SolaProjects-Signature (HMAC-SHA256 del cuerpo sin modificar con su secreto de firma) y User-Agent: SolaProjects-Webhooks/1.0. Verifique la firma antes de confiar en una solicitud.
Reintentos. Una entrega fallida se reintenta automáticamente después de aproximadamente 1, 5, 15 y 60 minutos; después del quinto intento permanece Fallido. Use Reintentar para intentar de nuevo manualmente.
#Tareas
#Crear un webhook de salida
-
Abra el proyecto → Integraciones → Nuevo webhook.
-
Complete Nuevo webhook saliente:
Campo Requerido Reglas / valores predeterminados Notas Nombre si Hasta 160 caracteres. p. ej. Panel de cliente. URL del endpoint (HTTPS) si URL válida, hasta 2.048 caracteres, HTTPS público. Marcador de posición https://example.com/hooks/solaprojects. Las direcciones locales y de red privada son rechazadas: "Use un punto final HTTPS público. Las URL de red local y privada están bloqueadas."Eventos si Al menos uno. Consulta la tabla anterior. Activo — Marcada de forma predeterminada. Desmarque para guardarlo Deshabilitado. -
Haga clic en Crear. Verá Webhook saliente creado. y el diálogo Secreto de firma: "Guarde esto ahora — solo se muestra una vez y no se puede recuperar más tarde." Haga clic en Copiar (Copiado al portapapeles.), guarde el secreto en el sistema receptor, luego Hecho.
#Editar, probar, rotar y archivar un webhook
| acción | Pasos | Resultado |
|---|---|---|
| Editar | Cambie nombre, URL, eventos o Activo → Guardar. | Webhook saliente actualizado. |
| Probar | Haga clic en Probar. | Entrega de prueba en cola. Aparece una fila en Entregas recientes. |
| Rotar secreto | Confirmar Rotar secreto — "El secreto actual dejará de funcionar. Actualice los servicios conectados con el nuevo secreto." | Secreto rotado. y el nuevo secreto se muestra una vez. |
| Archivo | Confirmar Archivar webhook — "Este webhook saliente dejará de entregar eventos del proyecto." | Webhook archivado. Insignia Archivado; no más entregas; historial conservado. |
#Crear un token de webhook de entrada
- Haga clic en Nuevo token en Tokens de webhook entrantes.
- Nombre (obligatorio, hasta 160 caracteres) y Proveedor: Personalizado (predeterminado) o GitHub.
- Haga clic en Crear → Token entrante creado. Copie el Token de webhook entrante mostrado una vez: "Use esto como el token en su URL de webhook entrante. Se muestra solo una vez."
El sistema externo envía entonces POST /api/projects/webhooks/incoming/{token} con un cuerpo JSON (límite de 60 solicitudes por minuto por remitente):
| Proveedor | Cuerpo | Qué sucede |
|---|---|---|
| Personalizado | {"title": "...", "description": "...", "priority": "high"} |
Crea una tarea privada en Tareas pendientes (la prioridad predeterminada es medium; título cortado a 180 caracteres). La respuesta incluye el nuevo task_key. |
| Personalizado | {"task_key": "ALN-14", "comment": "..."} |
Añade un comentario interno a esa tarea. |
| GitHub | Evento de incidencia o comentario en incidencia | Un problema se convierte en una tarea; un comentario en un problema cuyo título contiene una clave de tarea (p. ej. ALN-14) se convierte en un comentario en esa tarea. |
Cualquier otra cosa es rechazada con "Webhook rechazado."; un token revocado o incorrecto obtiene la misma respuesta. Las tareas y comentarios son creados por la persona que creó el token.
Renovar emite un token nuevo y revoca el anterior de inmediato (Token renovado.). Revocar pregunta Revocar token — «Las solicitudes con este token dejarán de tener acceso». → Token revocado.
#Crear un token de API pública
-
Haga clic en Nuevo token en API pública.
-
Nombre (obligatorio, hasta 120 caracteres) y Habilidades (al menos una;
projects:read,tasks:readytime:readestán premarcadas):Habilidad Permitir projects:readLeer este proyecto. tasks:read/tasks:writeLeer / crear y actualizar tareas. time:read/time:writeLeer / crear registros de tiempo. -
Crear → Token de API creado. Copie el Token de API del proyecto: "Úselo como token de portador para /api/v1. Se muestra solo una vez."
Las tareas creadas mediante la API activan las mismas automatizaciones y webhooks que las creadas en la aplicación. Rotar → confirmar Renovar token, con «El token actual dejará de funcionar. Actualice los servicios conectados con el nuevo token». → Token de API rotado. Revocar → Token de API revocado.
#Reintentar una entrega fallida
En Entregas recientes, haga clic en Reintentar en la fila → Entrega reintentada. Compruebe Estado y Respuesta después de un momento.
#Conectar un proveedor nativo
- En el mosaico del proveedor elija el canal (p. ej. #proyectos para Slack) y haga clic en Conectar → {Provider} conexión iniciada.
- Complete el diálogo de autorización {Provider} autorización con Completar devolución de llamada (o Más tarde) → Integración nativa conectada.
- Una vez conectado, use Enviar prueba ({Provider} mensaje de prueba enviado.), Actualizar ({Provider} actualizado.) o Desconectar ({Provider} desconectado.).
Los mosaicos en modo simulador también muestran Simular evento y error para verificar la configuración antes de que el proveedor entre en funcionamiento; no contactan con el servicio real.
#Estados
| Objeto | Estados |
|---|---|
| Webhook de salida | Activo, Deshabilitado (guardado con Activo desmarcado), Archivado |
| Entrega | Pendiente, Entregado, Fallido, Omitido |
| Token de entrada / API | Activo, Inactivo, Revocado |
| Proveedor nativo | Disponible, Pendiente, Activo, Fallido |
#Permisos
| Rol | Abrir la pestaña | Crear / cambiar webhooks, tokens, proveedores |
|---|---|---|
| Propietario de la organización | si | si |
| Administrador de proyectos | si | si |
| Administrador de proyectos que es un Administrador de proyecto aquí | si | si |
| Miembro del proyecto, Visor del proyecto, invitados | No | No |
Si la edición de integraciones está desactivada para la organización, la pestaña es de solo lectura (sin Nuevo, acciones de fila ni Reintentar). Un cambio rechazado muestra «La edición de integraciones está desactivada o no está permitida».; una página desactualizada, «Recargue la página e inténtelo de nuevo». Los secretos y tokens nunca vuelven a mostrarse después del diálogo de una sola vez, ni siquiera a los propietarios.
#Conexión de SolaCount de la organización
La opción Integraciones (/projects/settings/integrations) de la barra lateral del espacio de trabajo abre una página distinta. Muestra si SolaProjects está conectado a SolaCount (Conectado, Listo para conectar, Integración pausada, Desconectado — historial conservado, …) y permite al propietario de la organización o al administrador de Finanzas conectar, pausar, desconectar o comprobar la conexión. Se puede excluir un proyecto concreto desde su pestaña Configuración (tarjeta Integraciones → Proyecto interno / finanzas desactivadas). Consulte Presupuesto y finanzas y la descripción general de SolaProjects.
#Ejemplos prácticos
#Ejemplo 1 — Las consultas se convierten en tareas (cotidiano)
{User 1 name} quiere que las consultas del sitio web para {Showroom project name} (DEMO-FIT) lleguen como tareas.
- Nuevo token → Nombre Consultas del sitio web, Proveedor Personalizado → Crear; ella entrega el token al desarrollador web.
- El sitio web contabiliza
{"title": "Quote request – reception desk", "priority": "high"}. - La tarea ALN-31 Solicitud de presupuesto – recepción aparece en Tareas pendientes, privada, prioridad Alta. La tarjeta de token muestra usado por última vez el 6 de oct..
#Ejemplo 2 — Feed del panel de cliente con un fallo (escenario completo)
{User 2 name} conecta el panel del sitio de {Organization name}.
| Paso | acción | Resultado |
|---|---|---|
| 1 | Nuevo webhook: Panel del sitio, https://hooks.company.example.com/projects, eventos task.status_changed, task.completed, milestone.completed. |
Webhook saliente creado.; secreto de firma copiado al panel. |
| 2 | Probar. | Entrega de prueba en cola.; fila Entregado, Respuesta 200. |
| 3 | {User 1 name} mueve ALN-12 a Completado. | Dos entregas: task.status_changed y task.completed, ambas Entregado. |
| 4 | El panel está fuera de servicio por mantenimiento. | La siguiente entrega muestra Pendiente, luego Fallido con Respuesta 503; encabezado Entregas fallidas 1 en rojo; se reintenta a los ~1, 5, 15, 60 minutos. |
| 5 | Panel de vuelta; {User 2 name} hace clic en Reintentar. | Entrega reintentada. → Entregado. |
| 6 | TI sospecha que el secreto se filtró. {User 2 name} hace clic en Rotar secreto y confirma. | Secreto rotado.; nuevo secreto mostrado una vez; TI actualiza el panel. |
#Cómo se conecta
| Dónde | Enlace |
|---|---|
| Tareas | Los tokens entrantes y la API crean tareas y comentarios; los cambios de tarea envían eventos. |
| Planificación | La finalización de hitos y el inicio/finalización de sprints envían eventos. |
| Automatizaciones | Actúe dentro de SolaProjects; las ejecuciones fallidas pueden enviarse como eventos. |
| Enlaces para compartir con invitados | Evento share_link.created. |
| IA | Evento ai.suggestion_applied. |
| Control de tiempo | Evento time_entry.created; habilidades de API de tiempo. |
| Configuración | Interruptor de finanzas SolaCount por proyecto. |
#Consejos y problemas comunes
| Problema | Causa | Solución |
|---|---|---|
| Pestaña faltante. | Plan inferior a Premium o caducado. | Mejora el plan o renuévalo. |
| Use un punto final HTTPS público… | La URL es http, localhost o una dirección privada. |
Utiliza una URL HTTPS pública. |
| Se ha perdido un secreto o token. | Se muestra solo una vez. | Rotar y actualice el otro sistema. |
| Entregas Fallidas con un código 4xx. | Su punto final rechaza la solicitud (a menudo verificación de firma). | Compruebe que el punto final utiliza el secreto actual. |
| Webhook rechazado. en llamadas entrantes. | Token revocado/incorrecto, o el cuerpo no tiene title o task_key + comment. |
Comprueba el token y el cuerpo de la solicitud. |
| No se añadió el comentario desde GitHub. | El título de la incidencia no contiene una clave de tarea. | Ponga la clave (p. ej. ALN-14) en el título del problema. |
| La API devuelve acceso denegado. | Al token le falta la capacidad o está revocado. | Cree un token con las capacidades correctas. |
| El proveedor dice El simulador local está disponible… | Aún no está disponible para tu organización. | Pregunte a Solavel soporte sobre la activación. |