Integraciones

NexGestión puede conectarse con aplicaciones externas mediante su API y notificar cambios mediante webhooks. Esta documentación cubre el contrato público que debe usar una integración; no publica infraestructura ni código interno del CRM.

Recorrido recomendado

1. Empieza por API Quickstart.
2. Revisa autenticación y scopes.
3. Diseña operaciones repetibles con errores e idempotencia.
4. Configura webhooks si necesitas recibir eventos.
5. Si estás creando una extensión instalable, vuelve a Módulos externos.

Reglas de seguridad

• usa una clave distinta por integración;
• concede solo los scopes necesarios;
• no incluyas claves en JavaScript público, repositorios o capturas;
• usa HTTPS y valida certificados;
• registra request_id, estado y latencia, nunca secretos;
• trata los webhooks como reintentables y potencialmente duplicados.

Los valores de ejemplo usan <API_KEY>, <WEBHOOK_SECRET> y dominios ficticios. Sustitúyelos solo en tu configuración protegida.