Integra Konnect con tu app, CRM externo o automatizaciones. El Puente ya captura leads en la plataforma; aquí documentamos cómo conectar hacia afuera.
Hay dos capas distintas: (1) suscripción Konnect al negocio (planes Free/Pro/Premium); (2) integraciones del negocio — webhooks hacia Zapier/Make, Square, QuickBooks u otros sistemas.
Configura tu webhook de salida en /app/integraciones. La API REST de lectura está en early access.
Konnect cobra al negocio por el plan Free/Pro/Premium — no a los visitantes del directorio ni vía Stripe Connect.
Ver /precios. El dueño gestiona la suscripción en /app/plan tras iniciar sesión.
Cuando ocurre un evento, Konnect hace POST a tu URL (si está habilitada en /app/integraciones).
Firma: header X-Konnect-Signature = HMAC-SHA256 hex del body con tu webhook secret. También X-Konnect-Event. Responde 2xx en < 5s.
Eventos: lead.created | estimate.accepted | invoice.created | invoice.paid. Camino típico: webhook → Zapier/Make → Square o QuickBooks.
{
"id": "evt_...",
"type": "lead.created",
"created_at": "2026-07-18T16:00:00.000Z",
"data": {
"lead_id": "clx...",
"business_id": "clx...",
"business_slug": "granitos-el-aguila",
"name": "María Pérez",
"email": "maria@email.com",
"phone": "+14045551212",
"message": "Necesito cotización de quartz",
"source": "QUOTE_REQUEST"
}
}En Pro/Premium puedes crear presupuestos en un deal, enviarlos por email o WhatsApp (enlace /p/{token}) y el cliente puede aceptar.
Al aceptar se crea una factura PENDING; el dueño puede marcarla pagada. Cobro con tarjeta nativo (Stripe Connect / Square OAuth) es roadmap.
Webhooks útiles: estimate.accepted, invoice.created, invoice.paid — para crear Invoice en Square/QB vía Zapier.
{
"id": "evt_..._accepted",
"type": "estimate.accepted",
"created_at": "2026-07-25T16:00:00.000Z",
"data": {
"estimate_id": "clx...",
"invoice_id": "clx...",
"business_id": "clx...",
"business_slug": "all-in-remodeling",
"deal_id": "clx...",
"number": 12,
"total": 2500,
"currency": "USD"
}
}Square: usa lead.created o estimate.accepted / invoice.created en Zapier (“Catch Hook”) y crea Customer/Invoice en Square.
QuickBooks Online: mismo flujo — webhook → Make/Zapier → Create Customer / Estimate / Invoice.
OAuth nativo Square/QB es roadmap (Fase 2).
Sources que disparan lead.created: DIRECTORY_FORM | QUOTE_REQUEST | CLICK_CALL | CLICK_WHATSAPP | BOOKING (también MANUAL / IMPORT / REFERRAL desde el CRM).
No necesitas API para capturar leads del perfil público: los formularios y clicks ya crean el lead y, si hay webhook, lo reenvían.
Crea keys en /app/integraciones (dueño). Header: Authorization: Bearer kn_live_…. La key completa solo se muestra al crearla; se guarda hasheada (SHA-256).
Endpoint actual: GET /api/v1/leads?status=&source=&limit=50 (máx 100). Responde { data: Lead[] }.
curl -X GET "https://konnect.kmd.agency/api/v1/leads?limit=20" \
-H "Authorization: Bearer kn_live_xxx" \
-H "Accept: application/json"Zapier/Make, WhatsApp Business API, Google Sheets, HubSpot/Salesforce, Twilio SMS. Conector oficial: escríbenos para sandbox compartido.
Verifica siempre X-Konnect-Signature. No hagas scraping del directorio. Sanitiza PII. Cumple TCPA/CAN-SPAM al contactar leads.
Email: developers@kmd.agency — indica Square, QuickBooks, webhooks o API de lectura.
Asunto sugerido: [Konnect API] Early access.