Produ Devs — API Docs

Overview

Cómo está compuesta la API de Produ hoy

Esta documentación cubre los puntos de integración que hoy usamos para conectar pagos, calendario, correo y reuniones. La idea es que puedas entender rápido qué hace cada endpoint y cómo comenzar a consumirlo.

IntegracionesPagos, agenda, correo y reuniones conectadas a Produ.

Webhooks y OAuthFlujos de autenticación y eventos para mantener tus datos al día.

Base URL de funciones: https://<project-ref>.supabase.co/functions/v1/<function-name>

Quickstart

Empezar rápido

Si vas a conectar Produ desde un sistema externo o una automatización, el punto de partida más simple es hacer llamadas HTTP con JSON y headers estándar de Supabase.

curl -X POST "https://<project-ref>.supabase.co/functions/v1/send-transactional-email" \
  -H "Content-Type: application/json" \
  -H "apikey: <SUPABASE_ANON_KEY>" \
  -H "Authorization: Bearer <SUPABASE_ANON_KEY>" \
  -d '{
    "tenantId": "emp_xxx",
    "subject": "Nuevo feedback de cliente",
    "to": [{ "email": "equipo@empresa.cl", "name": "Equipo" }],
    "html": "<p>Tienes una nueva respuesta.</p>"
  }'

Autenticación

Qué headers usa hoy la app

Para consumir estas funciones desde un sistema externo, usamos headers estándar de Supabase:

apikey: <SUPABASE_ANON_KEY>
Authorization: Bearer <SUPABASE_ANON_KEY>
Content-Type: application/json

Credenciales que nunca deben salir al cliente

SUPABASE_SERVICE_ROLE_KEY
MERCADOPAGO_ACCESS_TOKEN
GOOGLE_CLIENT_SECRET
RESEND_API_KEY
secretos de `Diio` y webhook secrets

Edge Functions

Endpoints principales

`send-transactional-email`POST

Envía correos transaccionales por `Resend`. Se usa para alertas, notificaciones operativas y respuestas del portal cliente.

Uso típicoAlertas, feedback cliente, mensajes de soporte.

ProveedorResend

Respuesta`delivery.id`, metadata y destinatarios.

{
  "tenantId": "emp_xxx",
  "subject": "Nuevo feedback de cliente",
  "to": [{ "email": "equipo@empresa.cl", "name": "Equipo" }],
  "html": "<p>Tienes una nueva respuesta.</p>",
  "entityType": "content_piece",
  "entityId": "piece_xxx"
}

`mercadopago-create-payment-link`POST

Crea links de pago para facturas o cobranza y devuelve el `init_point` de Mercado Pago. En operación real, este flujo normalmente se ejecuta sobre una integración ya configurada en Produ.

{
  "tenantId": "emp_xxx",
  "invoiceId": "inv_xxx",
  "externalReference": "FAC-2026-0012",
  "amount": 1497000,
  "currency": "CLP",
  "description": "Pago factura FAC-2026-0012",
  "customer": { "name": "Go Soluciones", "email": "pagos@gosoluciones.cl" }
}

`mercadopago-handle-webhook`POST

Normaliza el estado de un pago desde Mercado Pago. Puede trabajar con `paymentId` directo o resolver por `externalReference` y `preferenceId`.

`google-calendar-oauth-start`POST

Inicia OAuth de Google Calendar y devuelve la URL de autorización para conectar una cuenta.

`google-calendar-oauth-callback`GET / POST

Completa OAuth y devuelve la conexión con `refreshToken`, `calendarId` y datos del usuario conectado.

`google-calendar-create-event`POST

Crea o actualiza eventos en Google Calendar, con soporte para invitados y Google Meet.

`google-calendar-list-events`POST

Lista eventos de un calendario en una ventana de tiempo.

`google-calendar-delete-event`POST

Elimina un evento existente desde Google Calendar.

`diio-company-api`POST

Valida conexión, refresca token e importa reuniones y llamadas desde Diio. También enriquece payloads con transcript, playbook y usuarios.

`diio-handle-webhook`GET / POST

Recibe webhooks de Diio, valida firma y actualiza la interacción correspondiente dentro de Produ.

Alcance

Qué cubre esta documentación

Aquí documentamos la superficie pensada para integraciones y automatizaciones. Si necesitas un flujo especial, nuestro equipo puede ayudarte a revisar la mejor forma de conectarlo sin exponer procesos internos de la plataforma.

Sí documentamosEndpoints, ejemplos de uso, autenticación, OAuth y webhooks disponibles para terceros.

No documentamos aquíServicios internos, procesos de soporte y capas privadas de operación que no forman parte del uso externo.

Casos comunesLinks de pago, agenda, correo transaccional, sincronización de reuniones y automatizaciones simples.

AyudaSi tu caso requiere algo más específico, escríbenos y revisamos la integración contigo.

Ejemplos

Ejemplos rápidos

Crear link de pago

curl -X POST "https://<project-ref>.supabase.co/functions/v1/mercadopago-create-payment-link" \
  -H "Content-Type: application/json" \
  -H "apikey: <SUPABASE_ANON_KEY>" \
  -H "Authorization: Bearer <SUPABASE_ANON_KEY>" \
  -d '{
    "tenantId": "emp_xxx",
    "invoiceId": "inv_xxx",
    "externalReference": "FAC-2026-0012",
    "amount": 1497000,
    "currency": "CLP"
  }'

Iniciar OAuth de Google Calendar

curl -X POST "https://<project-ref>.supabase.co/functions/v1/google-calendar-oauth-start" \
  -H "Content-Type: application/json" \
  -H "apikey: <SUPABASE_ANON_KEY>" \
  -H "Authorization: Bearer <SUPABASE_ANON_KEY>" \
  -d '{
    "tenantId": "emp_xxx",
    "userId": "usr_xxx",
    "userEmail": "usuario@empresa.cl",
    "redirectTo": "https://app.produ.cl/admin/empresa"
  }'