API Reference - Edge Functions

Esta documentación describe todas las Edge Functions disponibles en Cierro.

Información General

Base URL: https://<project-id>.supabase.co/functions/v1
Autenticación: Bearer token (JWT de Clerk)
Content-Type: application/json

Autenticación

Headers Requeridos

Authorization: Bearer <clerk-jwt-token>
Content-Type: application/json

Funciones de Autenticación

liveblocks-auth

Autenticación para colaboración en tiempo real con Liveblocks.

Endpoint: POST /liveblocks-auth

Request Body:

{
  "room": "budget_<budget-id>"
}

Response:

{
  "token": "<liveblocks-token>"
}

Funciones de Equipo

invite-team-member

Envía invitación por email a un nuevo miembro del equipo.

Endpoint: POST /invite-team-member

Request Body:

{
  "email": "[email protected]",
  "role": "member",
  "companyId": "uuid"
}

Response:

{
  "success": true,
  "invitation": {
    "id": "uuid",
    "token": "invitation-token",
    "expiresAt": "2024-01-15T00:00:00Z"
  }
}

Roles válidos: admin, manager, member, viewer

accept-invitation

Acepta una invitación de equipo y crea el perfil del usuario.

Endpoint: POST /accept-invitation

Request Body:

{
  "token": "invitation-token"
}

Response:

{
  "success": true,
  "profile": {
    "id": "uuid",
    "email": "[email protected]",
    "company_id": "uuid",
    "role": "member"
  }
}

manage-team

Gestiona miembros del equipo (actualizar rol, eliminar).

Endpoint: POST /manage-team

Actions:

Actualizar Rol

{
  "action": "update_role",
  "profileId": "uuid",
  "newRole": "manager"
}

Eliminar Miembro

{
  "action": "remove_member",
  "profileId": "uuid"
}

Response:

{
  "success": true
}

Funciones de IA

chat-gemini

Genera contenido usando Google Gemini para el editor de propuestas.

Endpoint: POST /chat-gemini

Request Body:

{
  "messages": [
    {
      "role": "user",
      "content": "Genera una propuesta para desarrollo web"
    }
  ],
  "budgetContext": {
    "title": "Propuesta de Desarrollo Web",
    "clientName": "Empresa ABC",
    "services": "Desarrollo de sitio web corporativo"
  },
  "companyContext": {
    "name": "Mi Agencia",
    "systemPrompt": "Eres un experto en propuestas comerciales...",
    "memory": "Información adicional de la empresa..."
  },
  "language": "es"
}

Response (streaming):

data: {"content": "# Propuesta de "}
data: {"content": "Desarrollo Web\n\n"}
data: {"content": "## Introducción..."}
data: [DONE]

Funciones de Documentos

import-budget

Importa un presupuesto desde un archivo (PDF, DOCX).

Endpoint: POST /import-budget

Request Body:

{
  "fileUrl": "https://storage.../document.pdf",
  "companyId": "uuid"
}

Response:

{
  "success": true,
  "budget": {
    "title": "Título extraído",
    "content": "<html>...</html>",
    "client": {
      "name": "Cliente detectado",
      "company": "Empresa detectada"
    }
  }
}

parse-document

Parsea documentos para extracción de contenido.

Endpoint: POST /parse-document

Request Body:

{
  "fileUrl": "https://storage.../document.pdf",
  "extractImages": true
}

Response:

{
  "text": "Contenido del documento...",
  "metadata": {
    "pages": 5,
    "title": "Título del documento"
  },
  "images": [
    {
      "url": "https://...",
      "page": 1
    }
  ]
}

Funciones de Integraciones

hubspot-api

Proxy para la API de HubSpot.

Endpoint: POST /hubspot-api

Actions:

Buscar Contactos

{
  "action": "search_contacts",
  "query": "empresa"
}

Obtener Contacto

{
  "action": "get_contact",
  "contactId": "123456"
}

Buscar Deals

{
  "action": "search_deals",
  "query": "proyecto"
}

Crear Deal

{
  "action": "create_deal",
  "data": {
    "dealname": "Nuevo Proyecto",
    "amount": 10000,
    "pipeline": "default"
  }
}

Response (ejemplo search_contacts):

{
  "results": [
    {
      "id": "123456",
      "properties": {
        "firstname": "Juan",
        "lastname": "Pérez",
        "email": "[email protected]",
        "company": "Empresa SA"
      }
    }
  ]
}

pipedream-auth

Autenticación OAuth para Pipedream.

Endpoint: POST /pipedream-auth

Request Body:

{
  "action": "get_connect_url",
  "app": "hubspot"
}

Response:

{
  "url": "https://pipedream.com/connect/..."
}

pipedream-action

Ejecuta acciones a través de Pipedream.

Endpoint: POST /pipedream-action

Request Body:

{
  "action": "create_contact",
  "app": "hubspot",
  "data": {
    "email": "[email protected]",
    "firstname": "Nuevo",
    "lastname": "Cliente"
  }
}

crm-via-pipedream

Ejecuta acciones CRM a través de Pipedream.

Endpoint: POST /crm-via-pipedream

Request Body:

{
  "action": "sync_budget",
  "budgetId": "uuid",
  "crmType": "hubspot"
}

Funciones de Pagos

reveniu-webhook

Webhook para procesar eventos de Reveniu.

Endpoint: POST /reveniu-webhook

Headers:

X-Reveniu-Signature: <signature>

Event Types:

subscription.created
subscription.activated
subscription.cancelled
payment.success
payment.failed

Response:

{
  "received": true
}

cancel-subscription

Cancela la suscripción activa de una empresa.

Endpoint: POST /cancel-subscription

Request Body:

{
  "companyId": "uuid",
  "reason": "Motivo de cancelación"
}

Response:

{
  "success": true,
  "subscription_ends_at": "2024-02-01T00:00:00Z"
}

reactivate-subscription

Reactiva una suscripción cancelada.

Endpoint: POST /reactivate-subscription

Request Body:

{
  "companyId": "uuid"
}

Response:

{
  "success": true,
  "subscription_status": "active"
}

Funciones de Email

send-notification-email

Envía emails transaccionales.

Endpoint: POST /send-notification-email

Request Body:

{
  "type": "budget_approved",
  "to": "[email protected]",
  "data": {
    "userName": "Juan",
    "budgetTitle": "Propuesta de Desarrollo",
    "clientName": "Cliente ABC",
    "totalAmount": 15000,
    "currency": "USD"
  }
}

Email Types:

Type

Descripción

welcome_trial

Bienvenida al trial

trial_expiring

Trial por vencer

trial_expired

Trial expirado

budget_expiring

Presupuesto por vencer

budget_approved

Presupuesto aprobado

team_invitation

Invitación al equipo

team_welcome

Bienvenida al equipo

subscription_activated

Suscripción activada

subscription_cancelled

Suscripción cancelada

subscription_reactivated

Suscripción reactivada

payment_failed

Pago fallido

send-contact-form

Envía formulario de contacto.

Endpoint: POST /send-contact-form

Request Body:

{
  "name": "Juan Pérez",
  "email": "[email protected]",
  "company": "Empresa SA",
  "message": "Me gustaría más información...",
  "budget": "$5,000 - $10,000"
}

Response:

{
  "success": true,
  "message": "Mensaje enviado correctamente"
}

Funciones de Utilidad

exchange-rates

Obtiene tasas de cambio actualizadas.

Endpoint: GET /exchange-rates

Query Parameters:

base: Moneda base (default: USD)
symbols: Monedas a obtener (comma-separated)

Example: /exchange-rates?base=USD&symbols=CLP,EUR,MXN

Response:

{
  "base": "USD",
  "rates": {
    "CLP": 950.25,
    "EUR": 0.92,
    "MXN": 17.15
  },
  "timestamp": 1705315200
}

Funciones Programadas (Cron)

check-trial-expiration

Verifica trials y presupuestos por vencer. Ejecuta automáticamente cada hora.

Endpoint: GET /check-trial-expiration

Funcionalidad:

Busca trials que expiran en 7, 3, o 1 día
Busca presupuestos que expiran en 7, 3, o 1 día
Envía emails de recordatorio
Registra notificaciones para evitar duplicados

Response:

{
  "success": true,
  "processed": {
    "trials": 5,
    "budgets": 12
  }
}

Funciones de Administración

admin-panel

Panel de administración para super admins.

Endpoint: POST /admin-panel

Requiere: is_super_admin = true

Actions:

Listar Empresas

{
  "action": "list_companies"
}

Estadísticas

{
  "action": "get_stats"
}

Actualizar Plan

{
  "action": "update_plan",
  "companyId": "uuid",
  "planId": "uuid"
}

Códigos de Error

Código

Significado

400

Bad Request - Parámetros inválidos

401

Unauthorized - Token inválido o faltante

403

Forbidden - Sin permisos suficientes

404

Not Found - Recurso no encontrado

429

Too Many Requests - Rate limit excedido

500

Internal Server Error - Error del servidor

Rate Limits

General: 100 requests/minuto por usuario
IA (chat-gemini): 20 requests/minuto
Emails: 50/hora por empresa

Ejemplos de Uso

JavaScript/TypeScript

import { supabase } from '@/integrations/supabase/client';

// Invocar Edge Function
const { data, error } = await supabase.functions.invoke('chat-gemini', {
  body: {
    messages: [{ role: 'user', content: 'Genera una propuesta' }],
    language: 'es'
  }
});

cURL

curl -X POST \
  'https://bfxmwgymodigbnqfkuoi.supabase.co/functions/v1/invite-team-member' \
  -H 'Authorization: Bearer <jwt-token>' \
  -H 'Content-Type: application/json' \
  -d '{"email": "[email protected]", "role": "member"}'

AnteriorSummary SiguienteArquitectura de Cierro

Última actualización hace 8 minutos

Buenas tardes

Información General

Autenticación

Headers Requeridos

Funciones de Autenticación

liveblocks-auth

Funciones de Equipo

invite-team-member

accept-invitation

manage-team

Actualizar Rol

Eliminar Miembro

Funciones de IA

chat-gemini

Funciones de Documentos

import-budget

parse-document

Funciones de Integraciones

hubspot-api

Buscar Contactos

Obtener Contacto

Buscar Deals

Crear Deal

pipedream-auth

pipedream-action

crm-via-pipedream

Funciones de Pagos

reveniu-webhook

cancel-subscription

reactivate-subscription

Funciones de Email

send-notification-email

send-contact-form

Funciones de Utilidad

exchange-rates

Funciones Programadas (Cron)

check-trial-expiration

Funciones de Administración

admin-panel

Listar Empresas

Estadísticas

Actualizar Plan

Códigos de Error

Rate Limits

Ejemplos de Uso

JavaScript/TypeScript

cURL