Los perfiles de Parallel funcionan de manera similar a los objetos de un CRM, permitiéndote gestionar y hacer seguimiento de la información de tus clientes de forma programática. Esta guía te ayudará a entender cómo integrar tus sistemas con los perfiles de Parallel utilizando nuestra API y webhooks.
Requisitos previos
Antes de empezar con la integración, asegúrate de tener:
Una clave API con los permisos necesarios para gestionar perfiles.
Un entendimiento claro de tus tipos de perfiles y propiedades.
Permisos de acceso correctamente configurados para el usuario de integración.
Puntos de integración con perfiles
Existen dos formas principales de interactuar con los perfiles de Parallel:
Implementación de Listeners para Webhooks
Parallel envía notificaciones mediante webhooks para varios eventos de perfiles. Estos son los eventos principales que podrías querer gestionar:
Creación y actualización de Perfiles
PROFILE_CREATED
: Se dispara cuando se crea un nuevo perfil.PROFILE_UPDATED
: Se envía después de actualizar cualquier propiedad del perfil.
Cambios en relaciones
PROFILE_RELATIONSHIP_CREATED
: Cuando se vinculan perfiles.PROFILE_RELATIONSHIP_REMOVED
: Cuando se eliminan relaciones entre perfiles.
Cambios de estado
PROFILE_CLOSED
: Cuando se cierra un perfil.PROFILE_REOPENED
: Cuando se reactiva un perfil cerrado.PROFILE_SCHEDULED_FOR_DELETION
: Antes de la eliminación permanente.PROFILE_ANONYMIZED
: Cuando un perfil se ha anonimizado tras el período de conservación de datos.
Buenas prácticas
Gestión de errores: Implementa una gestión adecuada de errores tanto para llamadas a la API como para el procesamiento de webhooks.
Fiabilidad de Webhooks:
Implementa comprobaciones de idempotencia usando el ID del evento.
Añade lógica de reintentos para procesamientos fallidos.
Almacena los webhooks sin procesar antes de procesarlos.
Sincronización de datos:
Usa webhooks para actualizaciones en tiempo real.
Implementa sincronización completa periódica para asegurar consistencia.
Gestiona los conflictos de datos apropiadamente.
Seguridad:
Mantén tus claves API seguras.
Valida las firmas de los webhooks.
Sigue el principio de mínimo privilegio al configurar usuarios de integración.
Gestión de diferentes tipos de Perfiles
Recuerda que diferentes tipos de perfiles (por ejemplo, personas vs. compañías) tienen diferentes propiedades y requisitos:
Perfiles de Personas: Enfocados en identificación y verificación personal
Perfiles de Compañías: Manejan estructura corporativa e información de propiedad
Obtener ayuda
Si encuentras algún problema:
Consulta la documentación de la API en https://www.onparallel.com/developers/api.
Contacta con el soporte de Parallel para asistencia técnica.