Integraciones del CRM

La sección de Integraciones permite conectar el CRM de Zentto con sistemas externos mediante webhooks de salida y API Keys públicas para recepción de leads.

Para qué sirve

Enviar eventos del CRM a plataformas externas (Slack, HubSpot, Make, Zapier, sistemas propios) y recibir leads desde sitios web, landing pages o aplicaciones externas que apunten a la API de Zentto.

Webhooks

Los webhooks envían un POST al URL configurado cada vez que ocurre un evento seleccionado:

Evento	Descripción
lead.created	Nuevo lead registrado en el CRM
deal.stage.changed	Un deal cambia de etapa
deal.won	Deal marcado como ganado
deal.lost	Deal marcado como perdido

Crear un webhook

1. Haz clic en Nuevo webhook.
2. Ingresa la URL de destino (debe responder 2xx en menos de 5 s).
3. Selecciona los eventos a suscribir.
4. Guarda y usa Enviar prueba para verificar la conectividad.

API Keys

Las API Keys públicas permiten que formularios externos envíen leads directamente al CRM mediante el endpoint POST /v1/crm/leads/public con el header X-Tenant-Key.

Crear una API Key

1. Haz clic en Nueva API Key.
2. Asigna un nombre descriptivo (ej: “Formulario web corporativo”).
3. Define la fuente de lead que se asignará a los leads recibidos con esta key.
4. Copia la clave generada — no se muestra de nuevo.

Flujo del usuario

Vista no técnica del proceso. Pensada para personal de operación, contabilidad, ventas o administración.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo técnico

Vista técnica para desarrolladores: endpoints, stored procedures/funciones, tablas y servicios involucrados.

Componente	Tipo	Ubicación
GET/POST /v1/crm/webhooks	Route Express	web/api/src/routes/crm/webhooks
POST /v1/crm/webhooks/:id/test	Route Express	web/api/src/routes/crm/webhooks
GET/POST /v1/crm/api-keys	Route Express	web/api/src/routes/crm/api-keys
POST /v1/crm/leads/public	Route Express (pública, X-Tenant-Key)	web/api/src/routes/crm/leads
usp_CRM_Webhook_Upsert	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_CRM_Webhook_Dispatch	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_CRM_ApiKey_Validate	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
crm.Webhook	Tabla webhooks	web/api/migrations/postgres/
crm.WebhookDelivery	Tabla log entregas	web/api/migrations/postgres/
crm.ApiKey	Tabla API Keys (hash)	web/api/migrations/postgres/
IntegracionesWebhooksPage.tsx	Componente Frontend	web/modular-frontend/packages/module-crm/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.