Integraciones
Conecta Blocky con tu sistema de administración. Publica avisos, recibe notificaciones de votaciones y mantén todo sincronizado.
API Keys activas
2
1 revocada
Webhooks configurados
3
1 con errores
Último evento
14:32
votacion.aprobada · hace 2h
API Keys activas
ComunidadFeliz Producción
bky_live_4x8k...r9wz
● Activa
Test Integración Edifito
bky_test_7p2n...q3hs
● Test
Webhooks
● Activo
https://api.comunidadfeliz.cl/blocky/webhook
98% éxito
● Error
https://sistema.edifito.com/hooks/blocky
3 fallos seguidos
Integraciones
Sin integraciones configuradas
Conecta Blocky con tu sistema de administración. Publica avisos, recibe notificaciones de votaciones y mantén todo sincronizado automáticamente.
API Keys
Esta clave permite que sistemas externos actúen en nombre de tu edificio. Trátala como una contraseña.
🔑
Las claves completas solo se muestran al momento de creación. Después solo verás el prefijo y los últimos 4 caracteres.
API Key creada
⚠️
Copia esta clave ahora. No podrás verla de nuevo.
Una vez que cierres esta pantalla, solo verás los últimos 4 caracteres.
Una vez que cierres esta pantalla, solo verás los últimos 4 caracteres.
Tu nueva API Key — ComunidadFeliz Producción
bky_live_4x8kR9mPqL2nZj7vWsEuYoTcBhFaDiN
Edificios autorizados: Los Olivos · Permisos: lectura+escritura
Cómo usarla
# Header requerido en cada request
Authorization: Bearer bky_live_4x8kR9mPqL2nZj7vWsEuYoTcBhFaDiN
# Ejemplo — publicar un aviso
curl -X POST https://blocky.app/api/v1/avisos \
-H "Authorization: Bearer bky_live_..." \
-H "Content-Type: application/json" \
-d '{"titulo":"Corte de agua","cuerpo":"..."}'
Webhooks
Blocky notifica a tu sistema cada vez que ocurre un evento en el edificio.
● Activo
https://api.comunidadfeliz.cl/blocky/webhook
aviso.publicado
votacion.aprobada
documento.generado
Secret: ...x7mZ
Éxito: 98%
Último envío: hace 2h
Total eventos: 412
● Error
https://sistema.edifito.com/hooks/blocky
votacion.iniciada
votacion.cerrada
⚠️
3 fallos consecutivos detectados. Revisa que tu servidor esté respondiendo con HTTP 200.
● Pausado
https://ediflow.io/api/notifications/blocky
reserva.creada
reserva.cancelada
Test de webhook
https://api.comunidadfeliz.cl/blocky/webhook
Evento de prueba
Webhook pausado
https://ediflow.io/api/notifications/blocky
⏸️
Pausamos este webhook porque falló 5 veces seguidas.
Revisa que tu servidor esté respondiendo con HTTP 200. Una vez corregido, puedes reactivarlo.
Revisa que tu servidor esté respondiendo con HTTP 200. Una vez corregido, puedes reactivarlo.
Últimos intentos
| Timestamp | Evento | HTTP | ms |
|---|---|---|---|
| 27 jun 10:15 | reserva.creada | 500 | 8240 |
| 27 jun 10:14 | reserva.creada | 500 | 10000 |
| 26 jun 22:03 | reserva.cancelada | 500 | 9800 |
| 26 jun 18:45 | reserva.creada | 504 | 10000 |
| 26 jun 14:30 | reserva.creada | 503 | 10000 |
Log de entregas
Últimos 50 intentos de entrega de webhooks.
Referencia de API
API Blocky v1 — Para integraciones con ComunidadFeliz, Edifito u otros sistemas de administración.
🔐
Todos los endpoints requieren el header Authorization: Bearer bky_live_[tu_key]
Avisos
GET
/api/v1/avisos
Lista todos los avisos del edificio
Query params: ?pagina=1&limit=20&estado=activo
// Response 200
{
"data": [
{
"id": "avs_01J9K...",
"titulo": "Corte de agua programado",
"cuerpo": "El martes 1 de julio...",
"fijado": false,
"created_at": "2025-06-27T14:32:00Z"
}
],
"total": 8,
"pagina": 1
}
POST
/api/v1/avisos
Publica un aviso en el mural
// Request body
{
"titulo": "Mantención ascensor",
"cuerpo": "El ascensor N°2 estará...",
"fijado": false,
"idempotency_key": "aviso-mant-20250627" // evita duplicados
}
// Response 201
{ "id": "avs_01J9K...", "status": "publicado" }
Votaciones
GET
/api/v1/votaciones
Historial de votaciones del edificio
// Response 200
{
"data": [
{
"id": "vot_01J8M...",
"titulo": "Cambio proveedor ascensores",
"estado": "aprobada",
"votos_favor": 38,
"votos_contra": 4,
"cerrada_at": "2025-06-02T20:00:00Z"
}
]
}
Documentos
GET
/api/v1/documentos/{id}/url
URL firmada para descarga del PDF
// Response 200
{
"url": "https://r2.blocky.app/signed/...",
"expira_en": "2025-06-30T14:32:00Z"
}
// Response 403 — sin permiso
{
"error": "forbidden",
"message": "Tu API Key no tiene acceso a este edificio.",
"docs": "https://blocky.app/docs/errores#403"
}
Contratos de Arriendo — Eventos webhook
📋
Los siguientes eventos se disparan desde el módulo de Arriendo de Espacios. Suscribite a ellos al crear o editar un webhook para recibir notificaciones cuando se firma un contrato.
EVENTO
contrato.firmado
Ambas partes firman un contrato de arriendo
Incluye: tipo de espacio, partes, número BLK, tipo de firma usada, modo de origen del documento.
// Payload de ejemplo — contrato.firmado
{
"id": "evt_01J...",
"tipo": "contrato.firmado",
"timestamp": "2025-06-27T14:32:00Z",
"edificio_id": "uuid",
"edificio_slug": "edificio-los-olivos",
"data": {
"contrato_id": "uuid",
"numero_blk": "BLK-2025-0042",
"tipo_espacio": "departamento_habitacional",
"arrendador": "Carlos Pérez",
"arrendatario": "María González",
"tipo_firma": "fea",
"modo_origen": "template_blocky",
"fecha_firma": "2025-06-27T14:32:00Z"
},
"blocky_version": "1.0"
}
EVENTO
contrato.vigente
Contrato registrado como vigente en el sistema
Se dispara cuando el contrato queda registrado como vigente, después de la firma de ambas partes y el procesamiento interno. Incluye los mismos campos que contrato.firmado más la fecha de inicio de vigencia.
// Payload de ejemplo — contrato.vigente
{
"id": "evt_01J...",
"tipo": "contrato.vigente",
"timestamp": "2025-06-27T14:35:00Z",
"edificio_id": "uuid",
"edificio_slug": "edificio-los-olivos",
"data": {
"contrato_id": "uuid",
"numero_blk": "BLK-2025-0042",
"tipo_espacio": "departamento_habitacional",
"arrendador": "Carlos Pérez",
"arrendatario": "María González",
"tipo_firma": "fea",
"modo_origen": "template_blocky",
"fecha_firma": "2025-06-27T14:32:00Z",
"vigente_desde": "2025-07-01T00:00:00Z"
},
"blocky_version": "1.0"
}