Saltar al contenido principal

Integraciones personalizadas

Si las integraciones pre-construidas no cubren tus necesidades, puedes construir integraciones personalizadas usando la API REST y los webhooks de SalesOS.

Opciones de integración

API REST

Interacción directa con los endpoints de SalesOS para leer y escribir datos.

Webhooks

Recibe notificaciones en tiempo real cuando ocurren eventos en SalesOS.

SalesOS Connect

Usa n8n como middleware para orquestar integraciones sin código.

Patrones de integración comunes

Datos del sistema externo hacia SalesOS

Ideal cuando una fuente externa genera datos que deben reflejarse en SalesOS.Ejemplo: Leads de un formulario web se crean automáticamente en SalesOS.
Sistema externo → API REST → SalesOS

Guía de implementación

1

Planifica la integración

Define claramente qué datos necesitas sincronizar, en qué dirección y con qué frecuencia.
2

Obtén credenciales

Configura la autenticación para obtener tokens de acceso a la API.
3

Implementa la lógica

Desarrolla el código de integración usando los endpoints necesarios.
4

Configura webhooks

Si necesitas reaccionar a eventos en tiempo real, configura los webhooks correspondientes.
5

Prueba exhaustivamente

Prueba todos los escenarios posibles: datos válidos, errores, timeouts, datos duplicados.
6

Monitorea en producción

Implementa logs y alertas para detectar problemas rápidamente.

Mejores prácticas

Implementa reintentos con backoff exponencial para manejar errores transitorios. Registra todos los errores para facilitar la depuración.
Diseña tus integraciones para ser idempotentes. Si un webhook se recibe dos veces, el resultado debe ser el mismo que si se recibió una sola vez.
Respeta los límites de la API e implementa colas para manejar picos de solicitudes.
Almacena las credenciales de forma segura, verifica las firmas de los webhooks y usa HTTPS para todas las comunicaciones.
Para integraciones de complejidad media, considera usar SalesOS Connect (n8n) como middleware. Puedes construir flujos complejos sin escribir código.
Nuestro equipo de soporte técnico puede ayudarte a planificar y validar integraciones personalizadas. Contacta a suporte@play2sell.com.

Próximos pasos