Ir al contenido principal
Integrando con Perfiles de Parallel
Martina avatar
Escrito por Martina
Actualizado hace más de un mes

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:

  1. Una clave API con los permisos necesarios para gestionar perfiles.

  2. Un entendimiento claro de tus tipos de perfiles y propiedades.

  3. 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:

  1. API REST: Para operaciones directas como crear, leer, actualizar y listar perfiles

  2. Webhooks: Para recibir notificaciones en tiempo real sobre cambios en los perfiles

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

  1. Gestión de errores: Implementa una gestión adecuada de errores tanto para llamadas a la API como para el procesamiento de webhooks.

  2. 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.

  3. 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.

  4. 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:

  1. Consulta la documentación de la API en https://www.onparallel.com/developers/api.

  2. Contacta con el soporte de Parallel para asistencia técnica.

¿Ha quedado contestada tu pregunta?