Skip to main content

Integraciones

Plane se integra con herramientas populares de desarrollo para sincronizar tu trabajo.

GitHub​

Que hace?​

  • Vincula PRs a issues de Plane
  • Sincroniza issues entre GitHub y Plane
  • Menciona issues en commits
  • Cierra issues automaticamente con PRs

Conectar GitHub​

  1. Ve a Workspace Settings > Integrations
  2. Busca GitHub
  3. Clic en Connect
  4. Autoriza Plane en GitHub
  5. Selecciona los repositorios

Vincular repositorio a proyecto​

  1. Ve a Project Settings > Integrations
  2. Clic en Link repository
  3. Selecciona el repo de GitHub

Vincular PR a Issue​

En el mensaje del PR o commit, menciona el ID:

feat: add user authentication

Fixes PROJ-123

Formatos validos:

  • PROJ-123
  • Fixes PROJ-123
  • Closes PROJ-123

Sincronizar Issues​

Puedes importar issues de GitHub:

  1. Ve al proyecto vinculado
  2. Clic en Import from GitHub
  3. Selecciona issues a importar

GitLab​

Que hace?​

  • Vincula MRs a issues de Plane
  • Sincroniza issues entre GitLab y Plane
  • Menciona issues en commits

Conectar GitLab​

  1. Ve a Workspace Settings > Integrations
  2. Busca GitLab
  3. Clic en Connect
  4. Ingresa tu GitLab URL (si es self-hosted)
  5. Autoriza Plane

Vincular MR a Issue​

Igual que GitHub, menciona el ID en el MR:

feat: add user authentication

Fixes PROJ-123

Slack​

Que hace?​

  • Notificaciones de cambios en issues
  • Crear issues desde Slack
  • Actualizaciones de ciclos

Conectar Slack​

  1. Ve a Workspace Settings > Integrations
  2. Busca Slack
  3. Clic en Connect
  4. Autoriza en Slack
  5. Selecciona el canal

Configurar notificaciones​

Elige que eventos notificar:

  • Issue creado
  • Issue completado
  • Comentario nuevo
  • Mencion

Webhooks​

Para integraciones custom, usa webhooks.

Crear webhook​

  1. Ve a Workspace Settings > Webhooks
  2. Clic en Add webhook
  3. Configura:
    • URL: Tu endpoint
    • Eventos: Que disparar

Eventos disponibles​

  • issue.created
  • issue.updated
  • issue.deleted
  • comment.created
  • cycle.created
  • cycle.completed

Payload de ejemplo​

{
  "event": "issue.created",
  "data": {
    "id": "uuid",
    "name": "Titulo del issue",
    "project": "PROJ",
    "state": "todo",
    "priority": "high",
    "assignees": ["user-id"],
    "created_at": "2024-01-15T10:00:00Z"
  }
}

API​

Plane tiene API REST para automatizaciones.

Autenticacion​

  1. Ve a tu perfil > API Tokens
  2. Crea un nuevo token
  3. Usa en header: X-API-Key: tu-token

Endpoints principales​

GET    /api/v1/workspaces/{slug}/projects
GET    /api/v1/workspaces/{slug}/projects/{project}/issues
POST   /api/v1/workspaces/{slug}/projects/{project}/issues
PATCH  /api/v1/workspaces/{slug}/projects/{project}/issues/{id}

Ejemplo: Crear issue​

curl -X POST \
  'https://tu-plane.deployalo.com/api/v1/workspaces/mi-empresa/projects/PROJ/issues' \
  -H 'X-API-Key: tu-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Nuevo issue desde API",
    "description": "Creado automaticamente",
    "priority": "medium"
  }'

Integraciones con n8n​

Si tienes n8n en Deployalo, puedes:

  1. Crear workflow en n8n
  2. Usar nodo HTTP Request
  3. Conectar a la API de Plane

Ideas de automatizacion​

  • Crear issue cuando llega email a soporte
  • Notificar en Discord cuando issue es urgente
  • Sincronizar con CRM cuando cliente tiene issues
  • Generar reporte semanal de progreso

Tips​

  • Sincroniza solo repos relevantes al proyecto
  • Usa etiquetas consistentes entre GitHub y Plane
  • Configura webhooks para integraciones custom
  • Documenta tus automatizaciones