Integraciones – Conecta tu CRM, email, TPV, e-commerce y analítica con Perkstar
Aprende a gestionar las integraciones en Perkstar. Guía completa para conectar plataformas de terceros, acceder a tu clave API, vincular herramientas de CRM/TPV/email marketing, supervisar el estado de sincronización, gestionar las asignaciones de campos y resolver problemas de conexión.
Visión general
La sección de Integraciones es tu centro de conexión para vincular Perkstar con las demás herramientas y plataformas de negocio que usas cada día. Al integrar tu programa de fidelización con tu stack tecnológico actual, creas un ecosistema unificado en el que los datos fluyen automáticamente entre sistemas, lo que elimina el trabajo manual y garantiza la coherencia en todas las plataformas.
Lo que puedes hacer en la sección de Integraciones:
Ver todas las integraciones activas con aplicaciones de terceros
Conectar nuevas plataformas a Perkstar con autorización en un clic
Acceder a tu clave API exclusiva para integraciones personalizadas
Supervisar el estado y el funcionamiento de las integraciones
Revisar los detalles de las integraciones y las fechas de conexión
Desconectar las integraciones que ya no necesites
Consultar la capacidad de integración de tu plan y su uso
Consejo: Las integraciones eliminan los silos de datos y la introducción manual de información, lo que te ahorra horas de trabajo administrativo. Cuando tu plataforma de fidelización se conecta con tu CRM, tu TPV, tu herramienta de email marketing o tu plataforma de e-commerce, los datos de los clientes se sincronizan automáticamente, las transacciones activan recompensas al instante y tu equipo ve una imagen completa de la interacción de los clientes en todos los puntos de contacto.
Quién debería gestionar las integraciones:
Propietarios de la cuenta: acceso completo a todas las funciones de integración
Administradores técnicos: configuran y solucionan problemas de las integraciones
Personal de TI: implementa integraciones personalizadas con la API
Responsables de marketing: conectan plataformas de email y marketing
Antes de empezar
Requisitos:
Una cuenta de Perkstar activa
Permisos de propietario de la cuenta o de administrador
Cuentas activas en las plataformas de terceros que quieras integrar
Credenciales de API o acceso de autorización para los servicios de terceros
Lo que necesitarás:
Según el tipo de integración:
Para integraciones predefinidas: las credenciales de acceso del servicio de terceros
Para integraciones con la API: tu clave API de Perkstar (disponible en esta sección)
Para integraciones personalizadas: conocimientos técnicos o ayuda de un desarrollador
Para todas las integraciones: tener claro qué datos quieres sincronizar
Tipos de integración
Integraciones predefinidas:
Conexión en un clic con las plataformas compatibles
Configuración guiada con mínimos conocimientos técnicos
Asignación automática de campos de datos
Ejemplos: los CRM, herramientas de email marketing y TPV más populares
Integraciones con la API:
Conexiones personalizadas mediante la API de Perkstar
Requieren implementación técnica
Flexibilidad total en el flujo de datos y la automatización
Ejemplos: sistemas propios, aplicaciones a medida, flujos de trabajo avanzados
Acceder a la sección de Integraciones
Cómo ir a Integraciones
Desde tu panel:
Inicia sesión en tu cuenta de Perkstar
Haz clic en Ajustes (icono ⚙️) en el menú de la izquierda
Haz clic en la pestaña Integraciones, en la parte superior de la pantalla de Ajustes
Nota: la pantalla de Integraciones muestra todas las herramientas y opciones de gestión de integraciones.
Distribución de la pantalla de Integraciones
La sección de Integraciones se organiza en cuatro áreas principales:
Recuadro de plan y capacidad: muestra tu plan actual y los límites de integración
Sección de clave API: tu clave API exclusiva para integraciones personalizadas
Integraciones activas: lista de las plataformas conectadas actualmente
Añadir integración: plataformas disponibles que puedes conectar
Tu capacidad de integración
Plan y límites de integración
En la parte superior de la pantalla de Integraciones verás un recuadro que muestra:
Plan de suscripción actual:
El nivel de tu plan (Starter, Professional, Business, etc.)
El número de integraciones que incluye tu plan
Uso de integraciones:
Número de integraciones activas conectadas actualmente
Número total de integraciones que permite tu plan
Espacios de integración disponibles que te quedan
Nota: ejemplo de lo que se muestra: «Plan Professional: 5 de 10 integraciones usadas» o «Plan Starter: 2 de 3 integraciones usadas»
Qué cuenta como una integración
Cada plataforma conectada cuenta como una integración dentro de tu límite:
Conexiones con plataformas predefinidas (CRM, email marketing, TPV)
Webhooks activos (si en tu plan se cuentan por separado)
Implementaciones personalizadas con la API (pueden contar de forma distinta según el plan)
Ampliar el plan para tener más integraciones
Si has alcanzado tu límite:
Revisa las integraciones activas y desconecta las que no uses
Pasa a un plan de nivel superior con más capacidad de integración
Contacta con soporte para preguntar por paquetes adicionales de integraciones (si están disponibles)
Para ampliar tu plan:
Ve a Ajustes → pestaña Plan
Selecciona «Amplía tu plan actual»
Elige un plan con límites de integración más altos
Trabajar con tu clave API
¿Qué es una clave API?
Información: tu clave API es un identificador exclusivo que permite a las aplicaciones de terceros y al código personalizado acceder de forma segura a los datos de tu cuenta de Perkstar. Piensa en ella como una contraseña pensada para que los sistemas (no las personas) interactúen con tu cuenta de forma programática.
Para qué sirven las claves API:
Integraciones personalizadas con sistemas propios
Transferencias automáticas de datos entre plataformas
Sincronización en tiempo real de los datos de clientes y transacciones
Crear aplicaciones personalizadas sobre Perkstar
Automatización avanzada más allá de las integraciones predefinidas
Acceder a tu clave API
Para ver y copiar tu clave API:
Ve a Ajustes → pestaña Integraciones
Localiza el recuadro Clave API (debajo de la información del plan)
Tu clave API se muestra como una larga cadena alfanumérica
Haz clic en el botón Copiar para copiar la clave al portapapeles
Cómo usar tu clave API:
Pégala en las aplicaciones de terceros compatibles con la API de Perkstar
Facilítala a los desarrolladores que creen integraciones personalizadas
Inclúyela en las solicitudes a la API como cabecera de autenticación
Nunca la compartas públicamente ni la subas a sistemas de control de versiones
Documentación de la API
Consejo: junto a tu clave API encontrarás un enlace a la Documentación de la API, con los endpoints disponibles, los requisitos de autenticación, los formatos de solicitud/respuesta, ejemplos de código, los límites de uso, los códigos de error y las mejores prácticas de implementación.
Cuándo usar la documentación de la API:
Al crear integraciones personalizadas desde cero
Para resolver problemas de conexión con la API
Para entender los campos de datos y los endpoints disponibles
Al implementar flujos de trabajo de automatización avanzados
Para formar a los desarrolladores sobre las capacidades de la API de Perkstar
Mejores prácticas de seguridad para la clave API
Cómo proteger tu clave API:
Nunca compartas tu clave API:
No la publiques en foros ni documentación pública
No la subas a repositorios públicos de GitHub
No la incluyas en JavaScript del lado del cliente (sería visible para cualquiera)
No la compartas por email o mensajería sin cifrar
Almacenamiento seguro:
Guárdala en variables de entorno, no la dejes escrita directamente en el código
Usa sistemas de gestión de secretos (AWS Secrets Manager, Azure Key Vault)
Limita el acceso solo a los miembros del equipo que lo necesiten
Documenta dónde se guarda la clave API para que el equipo la tenga localizada
Control de acceso:
Facilita la clave API solo a desarrolladores y sistemas de confianza
Usa claves API distintas para diferentes integraciones siempre que sea posible
Revoca y vuelve a generar las claves si se ven comprometidas
Revisa periódicamente quién tiene acceso a las claves API
Supervisión del uso:
Haz un seguimiento de las llamadas a la API para detectar actividad inusual
Configura alertas para patrones de uso inesperados
Revisa los registros de la API de forma periódica
Investiga de inmediato cualquier acceso no autorizado
Volver a generar tu clave API
Cuándo regenerarla:
La clave API se ha visto comprometida o se ha expuesto públicamente
Un desarrollador que tenía acceso ha dejado tu organización
Se ha detectado actividad sospechosa en la API
Rotación de seguridad periódica (se recomienda cada 6-12 meses)
Hay que reconstruir las integraciones desde cero
Cómo regenerarla:
Contacta con el soporte de Perkstar (puede que la regeneración no esté disponible en la interfaz)
Solicita una nueva clave API
Actualiza todas las integraciones activas con la nueva clave
Prueba todas las integraciones para asegurarte de que siguen funcionando
Revoca la clave antigua tras confirmar que la nueva funciona
Advertencia: al regenerar tu clave API, todas las integraciones existentes con la API dejarán de funcionar hasta que las actualices con la nueva clave. Planifícalo con cuidado y actualiza las integraciones de inmediato.
Gestionar las integraciones activas
La tabla de integraciones activas
La sección de Integraciones activas muestra todas las plataformas conectadas en este momento, en forma de tabla con las siguientes columnas:
Nombre:
El nombre de la plataforma o el servicio
Ejemplos: «Mailchimp», «Salesforce», «Shopify», «Integración CRM personalizada»
ID de integración:
Identificador exclusivo de esta integración concreta
Se usa para la resolución de problemas técnicos y las referencias en la API
Se genera automáticamente al crear la integración
Fecha:
Cuándo se conectó la integración por primera vez
Te ayuda a saber cuánto tiempo lleva activa la integración
Útil para auditorías y revisiones
Estado:
Estado operativo actual de la integración
Estados habituales:
Activa: la integración funciona con normalidad
Error: problema de conexión o fallo de sincronización
En pausa: la integración está temporalmente desactivada
Reconexión necesaria: la autorización ha caducado y hay que volver a autenticarse
Detalles:
Enlace o botón para ver más información sobre la integración
Haz clic para ver la configuración detallada, el historial de sincronización y los ajustes
Ver los detalles de una integración
Para ver la información detallada de una integración:
Localiza la integración en la tabla de Integraciones activas
Haz clic en Detalles, en la columna de la derecha
Revisa la página de detalles de la integración
Los detalles de la integración suelen incluir:
Ajustes de configuración y asignaciones de campos
Fecha y hora de la última sincronización
Frecuencia de sincronización (en tiempo real, cada hora, a diario)
Datos que se sincronizan (clientes, transacciones, tarjetas)
Registros de errores (si se han producido incidencias)
Métricas del estado de la conexión
Opciones para editar, pausar o desconectar
Supervisar el estado de las integraciones
Señales de una integración saludable:
El estado muestra «Activa»
La hora de la última sincronización es reciente (dentro de la frecuencia prevista)
No hay mensajes de error en los registros
Los datos aparecen correctamente en ambos sistemas
Señales de alarma:
El estado muestra «Error» o «Reconexión necesaria»
La hora de la última sincronización es antigua (de hace horas o días)
Hay mensajes de error en los registros de la integración
Faltan datos o son incoherentes entre los sistemas
Qué hacer si la integración muestra errores:
Haz clic en Detalles para ver los mensajes de error
Comprueba los problemas habituales:
Autorización caducada (vuelve a autorizar)
Límites de uso de la API superados (espera y vuelve a intentarlo)
Credenciales no válidas (actualízalas)
Servicio temporalmente caído (consulta el estado del tercero)
Sigue los pasos de resolución de problemas del mensaje de error
Contacta con soporte si el error persiste
Pausar una integración
Cuándo pausar una integración:
Problemas temporales de calidad de los datos en uno de los sistemas
Para resolver problemas de sincronización
Al hacer cambios en las asignaciones de campos o en los ajustes
Al probar cambios en la configuración de la integración
Pausa estacional durante periodos de inactividad del negocio
Cómo pausarla (si está disponible):
Abre los detalles de la integración
Haz clic en el botón Pausar o Desactivar
Confirma la pausa
La integración deja de sincronizar, pero se conserva la configuración
Para reanudarla:
Abre los detalles de la integración
Haz clic en Reanudar o Activar
La integración reanuda la sincronización desde el estado actual
Desconectar una integración
Antes de desconectar:
Exporta los datos que necesites de la integración
Ten claro qué pasa con los datos sincronizados (normalmente se conservan en ambos sistemas)
Avisa a los miembros del equipo que dependen de la integración
Documenta por qué la desconectas para futuras referencias
Cómo desconectarla:
Abre la página de detalles de la integración
Localiza el botón Desconectar, Quitar o Eliminar
Revisa la advertencia sobre el impacto de la desconexión
Confirma la eliminación
La integración se elimina de la tabla de Integraciones activas
Después de desconectar:
La integración deja de contar dentro del límite de tu plan
Los datos dejan de sincronizarse entre los sistemas
El historial de datos suele permanecer en ambos sistemas
Puedes volver a conectarla más adelante si lo necesitas (quizá tengas que reconfigurarla)
Añadir nuevas integraciones
Ver las integraciones disponibles
Información: la sección Añadir integración muestra todas las plataformas y servicios compatibles con conexiones predefinidas con Perkstar.
Categorías de integración habituales:
Gestión de relaciones con clientes (CRM):
Salesforce, HubSpot, Zoho CRM, Pipedrive
Sincroniza los perfiles de clientes y el historial de interacciones
Vista unificada del cliente en todas las plataformas
Email marketing:
Mailchimp, Constant Contact, Klaviyo, SendGrid
Añade automáticamente a los clientes del programa de fidelización a tus listas de email
Activa campañas en función de la actividad de fidelización
Segmenta a los clientes por nivel de fidelización o por puntos
Terminal punto de venta (TPV):
Square, Clover, Toast, Lightspeed
Asignación automática de puntos de fidelización al pagar
Sincronización de transacciones en tiempo real
Identificación del cliente en la caja
Plataformas de e-commerce:
Shopify, WooCommerce, BigCommerce, Magento
Recompensas de fidelización por compras online
Sincronización de las cuentas de los clientes
Seguimiento unificado de la fidelización online y en tienda
Analítica e inteligencia de negocio:
Google Analytics, Tableau, Power BI
Los datos de fidelización en paneles completos
Seguimiento del ROI y del valor de vida del cliente
Métricas de fidelización y de negocio combinadas
Contabilidad y finanzas:
QuickBooks, Xero, FreshBooks
Seguimiento de los ingresos del programa de fidelización
Categorización de gastos para los costes de fidelización
Integración de informes financieros
Conectar una nueva integración
Proceso de conexión paso a paso:
1. Ve a la sección Añadir integración:
Baja hasta la parte inferior de la pantalla de Integraciones
Explora las plataformas disponibles
2. Selecciona la plataforma que quieras conectar:
Busca la plataforma que quieras integrar
Haz clic en el botón Conectar de la fila de esa plataforma
3. Autoriza la conexión:
Se te redirigirá a la página de inicio de sesión de la plataforma de terceros
Inicia sesión con tus credenciales de esa plataforma
Revisa con atención las solicitudes de permisos
Haz clic en Autorizar, Permitir o Conectar
4. Configura los ajustes de la integración:
Selecciona qué datos sincronizar (clientes, transacciones, tarjetas)
Elige la frecuencia de sincronización (en tiempo real, cada hora, a diario)
Asigna los campos de datos entre los sistemas (email, teléfono, ID de cliente)
Configura cualquier opción específica de la plataforma
5. Prueba la integración:
Lanza una sincronización de prueba (normalmente hay un botón para ello)
Verifica que los datos aparecen correctamente en ambos sistemas
Comprueba que no se produce ningún error
6. Activa la integración:
Haz clic en Guardar o Activar
La integración pasa a la tabla de Integraciones activas
Comienza la sincronización automática
Asignación de campos
Información: la asignación de campos conecta los campos de datos entre Perkstar y la plataforma de terceros, lo que garantiza que la información llegue a los lugares correctos.
Asignaciones de campos habituales:
«Email del cliente» de Perkstar → «Dirección de email» del CRM
«Número de teléfono» de Perkstar → «Teléfono móvil» del email marketing
«Nombre del cliente» de Perkstar → «Nombre completo del cliente» del TPV
«Saldo de puntos» de Perkstar → «Puntos de fidelización» del CRM
«Fecha de última visita» de Perkstar → «Última transacción» de la analítica
Mejores prácticas para la asignación de campos:
Empareja los campos con cuidado (una asignación incorrecta provoca incoherencias en los datos)
Usa identificadores de cliente coherentes (email o teléfono) en todos los sistemas
Haz pruebas con datos de muestra antes de activar
Documenta tu asignación de campos para que el equipo la tenga de referencia
Revisa la asignación cuando cambien los campos de cualquiera de los sistemas
Opciones de frecuencia de sincronización
Sincronización en tiempo real:
Los datos se transfieren al instante cuando se producen cambios
Ideal para: integraciones de TPV, datos de clientes en directo
Mayor uso de la API; puede tener costes o límites
Sincronización cada hora:
Los datos se actualizan cada hora
Ideal para: la mayoría de operaciones del negocio, un enfoque equilibrado
Buen equilibrio entre frescura de los datos y uso de la API
Sincronización diaria:
Los datos se actualizan una vez al día a una hora programada
Ideal para: informes históricos, datos menos urgentes
Uso mínimo de la API, adecuada para grandes conjuntos de datos
Sincronización manual:
Tú lanzas la sincronización cuando lo necesitas
Ideal para: pruebas, resolución de problemas, actualizaciones poco frecuentes
Control total, sin llamadas automáticas a la API
Casos de uso de las integraciones por tipo de negocio
Tiendas físicas
Integraciones recomendadas:
TPV (Square, Clover):
Puntos de fidelización automáticos al pagar
Identificación del cliente por teléfono o email
Sincronización del historial de transacciones
Email marketing (Mailchimp):
Emails de bienvenida para los nuevos miembros del programa de fidelización
Campañas de reactivación para clientes inactivos
Ofertas de cumpleaños y promociones especiales
CRM (Salesforce):
Historial de compras completo del cliente
Visibilidad del nivel de fidelización para el personal de ventas
Comunicación dirigida según el comportamiento de compra
Restaurantes y cafeterías
Integraciones recomendadas:
TPV (Toast, Square):
Puntos por compras de comida y bebida
Integración de la fidelización con los pedidos online
Asignación de puntos al dividir la cuenta
Google Analytics:
Mide el impacto del programa de fidelización en los ingresos
Análisis del valor de vida del cliente
Medición de la eficacia de las campañas
Contabilidad (QuickBooks):
Categorización de ingresos (fidelización frente a normales)
Seguimiento de gastos del programa de fidelización
Informes financieros
Peluquerías y centros de estética
Integraciones recomendadas:
Sistema de reservas (Mindbody, Vagaro):
Puntos por las citas reservadas
Integración con el historial de servicios
Puntos de fidelización automáticos al hacer el check-in
Email marketing (Constant Contact):
Recordatorios de citas con el saldo de fidelización
Campañas de promoción de servicios
Ofertas de cumpleaños y aniversario
CRM (HubSpot):
Seguimiento de las preferencias de servicio del cliente
Visibilidad del nivel de fidelización para ofrecer un servicio personalizado
Automatización del seguimiento tras las citas
Negocios de e-commerce
Integraciones recomendadas:
Plataforma de e-commerce (Shopify, WooCommerce):
Puntos por compras online
Descuentos por nivel de fidelización al pagar
Sincronización de las cuentas de los clientes
Email marketing (Klaviyo):
Recuperación de carritos abandonados con incentivos de fidelización
Campañas posteriores a la compra
Segmentación de clientes VIP
Analítica (Google Analytics):
Seguimiento del ROI del programa de fidelización
Valor de vida del cliente por segmento
Análisis del impacto en la tasa de conversión
Mejores prácticas para la gestión de integraciones
Estrategia de integración
Empieza por las integraciones de mayor impacto:
Identifica qué integraciones te ahorrarán más tiempo
Prioriza los sistemas que usas con más frecuencia
Conecta una integración cada vez para no agobiarte
Pruébala a fondo antes de añadir la siguiente integración
Planifica la calidad de los datos:
Asegúrate de que los datos de los clientes están limpios antes de integrar
Establece estándares de datos (formato de nombre, formato de teléfono, etc.)
Elimina los duplicados en todos los sistemas antes de sincronizar
Documenta las reglas de calidad de datos para el equipo
Ten en cuenta la dirección del flujo de datos:
Perkstar → otro sistema (exportar datos de fidelización)
Otro sistema → Perkstar (importar datos de clientes)
Bidireccional (ambos sistemas se actualizan mutuamente)
Elige según cuál sea el sistema que actúa como «fuente de verdad»
Mantenimiento periódico
Comprobaciones semanales:
Revisa las Integraciones activas en busca de estados de error
Verifica que las horas de sincronización recientes están al día
Revisa los registros de las integraciones en busca de avisos
Prueba las integraciones críticas con transacciones de muestra
Auditorías mensuales:
Revisa todas las integraciones activas: ¿siguen siendo necesarias?
Desconecta las integraciones que no uses para liberar capacidad
Actualiza las credenciales que estén a punto de caducar
Verifica la calidad de los datos en ambos sistemas
Revisiones trimestrales:
Evalúa el ROI de las integraciones (tiempo ahorrado, errores evitados)
Busca nuevas oportunidades de integración
Actualiza las asignaciones de campos si han cambiado las estructuras de datos
Revisa la seguridad (rotación de claves API, auditoría de accesos)
Coordinación del equipo
Documentación:
Mantén una lista de todas las integraciones activas y para qué sirven
Documenta la asignación de campos de cada integración
Anota quién es responsable de cada integración
Guarda un registro de los pasos de resolución de problemas que han funcionado
Gestión de accesos:
Limita la gestión de integraciones al personal técnico
No compartas las claves API con todo el equipo
Da acceso de solo lectura siempre que sea posible
Crea un proceso para solicitar nuevas integraciones
Comunicación de los cambios:
Avisa al equipo antes de añadir o quitar integraciones
Prueba los cambios en periodos de poco tráfico
Ten un plan de marcha atrás por si la integración da problemas
Documenta todos los cambios para el registro de auditoría
Privacidad de los datos y cumplimiento normativo
Consideraciones de privacidad:
Sincroniza solo los datos necesarios para el objetivo de la integración
Revisa la política de privacidad de la plataforma de terceros
Asegúrate de que las integraciones cumplen el RGPD, la CCPA, etc.
Obtén el consentimiento del cliente para compartir datos si es necesario
Seguridad:
Usa plataformas con buenas prácticas de seguridad
Activa la autenticación en dos pasos en las cuentas integradas
Revisa con regularidad los permisos de las integraciones
Revoca el acceso cuando un miembro del equipo se vaya
Conservación de los datos:
Entiende cuánto tiempo conservan los datos las plataformas de terceros
Ten claro qué pasa con los datos si desconectas una integración
Planifica la eliminación de datos si lo exige la normativa
Exporta los datos importantes antes de desconectar
Resolución de problemas de integraciones
La integración muestra el estado «Error»
Resolución de problemas paso a paso:
Haz clic en Detalles para ver el mensaje de error
Lee la descripción concreta del error
Anota el código de error si lo hubiera
Causas y soluciones habituales:
«Autorización caducada»: vuelve a autorizar la integración haciendo clic en Reconectar
«Límite de uso de la API superado»: espera a que se restablezca el límite (normalmente cada hora o cada día)
«Credenciales no válidas»: actualiza la clave API o las credenciales de acceso
«Servicio no disponible»: consulta la página de estado de la plataforma de terceros por si hay caídas
Prueba la conexión:
Intenta una sincronización manual (si está disponible)
Comprueba que puedes iniciar sesión en la plataforma de terceros por separado
Comprueba si la plataforma de terceros está teniendo problemas
Contacta con soporte:
Si el error persiste tras la resolución de problemas básica
Facilita el ID de la integración, el mensaje de error y la marca de tiempo
Describe lo que ya has probado
Los datos no se sincronizan
Problema: la integración muestra «Activa», pero los datos no aparecen en el otro sistema
Pasos de resolución de problemas:
Comprueba el momento de la sincronización:
¿Cuándo fue la última sincronización? (Consúltalo en los detalles de la integración)
¿Cuál es la frecuencia de sincronización? (En tiempo real, cada hora, a diario)
Si no es en tiempo real, espera a la siguiente sincronización programada
Verifica la asignación de campos:
¿Están bien asignados los campos?
¿Hay campos vacíos que deberían tener datos?
Prueba a sincronizar un registro de prueba con datos completos
Comprueba los filtros o condiciones:
Algunas integraciones solo sincronizan los registros que cumplen ciertos criterios
Revisa los ajustes de la integración en busca de filtros
Asegúrate de que los datos de prueba cumplen las condiciones del filtro
Busca límites de uso:
¿Has superado los límites de llamadas a la API?
Revisa los registros de la integración en busca de mensajes de limitación
Reduce la frecuencia de sincronización si estás alcanzando los límites
Verifica los permisos:
¿Tiene la integración permiso para escribir datos?
Comprueba los permisos del usuario en la plataforma de terceros
Vuelve a autorizar la integración para actualizar los permisos
Registros de clientes duplicados
Problema: el mismo cliente aparece varias veces en uno de los sistemas o en ambos
Causas:
Identificadores de cliente incoherentes (email frente a teléfono)
Formatos de nombre distintos (Juan Pérez frente a J. Pérez)
Varias cuentas en un mismo sistema
Problemas de mayúsculas y minúsculas (juan@email.com frente a Juan@email.com)
Soluciones:
Estandariza los criterios de coincidencia:
Elige el email o el teléfono como identificador principal
Configura la integración para que haga la coincidencia por ese campo
Usa el mismo formato en ambos sistemas
Limpia los duplicados existentes:
Fusiona los duplicados en ambos sistemas antes de sincronizar
Usa herramientas de deduplicación si están disponibles
Exporta, limpia y vuelve a importar si es necesario
Evita futuros duplicados:
Impón identificadores únicos en ambos sistemas
Estandariza la introducción de datos (email todo en minúsculas, formato de teléfono coherente)
Configura alertas de detección de duplicados
La integración se conecta pero no funciona
Problema: la integración se conecta correctamente, pero no funciona como se esperaba
Resolución de problemas:
Revisa la configuración de la integración:
¿Estás sincronizando los tipos de datos correctos?
¿Está bien configurada la sincronización bidireccional?
¿Están bien definidos los activadores de actualización?
Prueba con datos conocidos:
Crea un cliente de prueba en Perkstar
Verifica que aparece en el sistema de terceros
Haz un cambio y verifica que se sincroniza de vuelta
Elimina los datos de prueba tras la verificación
Consulta la documentación de la integración:
Revisa la guía de integración de Perkstar para esa plataforma concreta
Consulta la documentación de integración de la plataforma de terceros
Busca problemas conocidos o limitaciones
Verifica la clave API y los permisos:
Confirma que la clave API es correcta (copia y pega con cuidado)
Comprueba que la clave API no se ha regenerado
Asegúrate de que la clave API tiene los permisos necesarios
Preguntas frecuentes
¿Cuántas integraciones puedo conectar?
El número depende de tu plan de suscripción. El límite de integraciones de tu plan se muestra en la parte superior de la pantalla de Integraciones. Los planes Starter suelen permitir 2-3 integraciones, mientras que los niveles superiores permiten 10-20 o más.
¿Las integraciones cuentan dentro de mis límites de clientes o de tarjetas?
No. Los límites de integración son independientes del tamaño de tu base de datos de clientes y del límite de tarjetas de fidelización. Eso sí, las integraciones pueden sincronizar clientes hacia Perkstar, lo que contaría dentro de tu límite de clientes.
¿Puedo usar mi clave API con varias integraciones?
Sí. Tu clave API se puede usar para varias integraciones personalizadas y herramientas de terceros. Cada conexión que use la misma clave API se autenticará como tu cuenta.
¿Qué pasa con mis datos si desconecto una integración?
Al desconectarla se detiene la sincronización futura, pero los datos que ya están en ambos sistemas suelen permanecer. Por ejemplo, los clientes sincronizados desde tu CRM seguirán en Perkstar. Verifica siempre la documentación de la integración concreta antes de desconectar.
¿Puedo volver a conectar una integración tras desconectarla?
Sí. Puedes volver a conectarla en cualquier momento haciendo clic de nuevo en el botón Conectar. Tendrás que reconfigurar los ajustes y las asignaciones de campos, pero la integración funcionará con normalidad una vez reconectada.
¿Mi clave API es la misma que mi contraseña de acceso?
No. Tu clave API es específica para las conexiones entre sistemas, no para iniciar sesión en Perkstar. Nunca compartas tu clave API públicamente, pero sí puedes facilitarla a desarrolladores o aplicaciones de terceros de confianza.
¿Con qué frecuencia se sincronizan los datos entre sistemas?
La frecuencia de sincronización depende de la configuración de la integración. Las opciones suelen incluir tiempo real (inmediata), cada hora, a diario o manual. Normalmente puedes ajustar la frecuencia en los ajustes de la integración.
¿Puedo personalizar qué datos se sincronizan?
La mayoría de las integraciones te permiten seleccionar qué tipos de datos sincronizar (clientes, transacciones, tarjetas de fidelización, etc.) y cómo se asignan los campos entre los sistemas. Las opciones de configuración varían según la integración.
¿Qué hago si una integración está usando datos antiguos?
Lanza una sincronización manual para actualizar los datos. En los detalles de la integración, busca el botón «Sincronizar ahora» o similar. Si la sincronización manual no ayuda, desconecta y vuelve a conectar la integración para forzar una resincronización completa.
¿Puedo ver un historial de los datos sincronizados?
La mayoría de las integraciones ofrecen registros de sincronización en la vista de Detalles, donde se muestra cuándo se hicieron las sincronizaciones, cuántos registros se transfirieron y los errores que hubiera. El nivel de detalle del registro varía según la integración.
¿Necesito conocimientos técnicos para configurar las integraciones?
Las integraciones predefinidas (botón Conectar) requieren mínimos conocimientos técnicos: basta con las credenciales de acceso de la otra plataforma. Las integraciones personalizadas con la API requieren conocimientos de programación o la ayuda de un desarrollador.
¿Puedo integrarme con una plataforma que no esté en la lista de Añadir integración?
Sí, usando la clave API. Si una plataforma admite API REST o webhooks, puedes crear una integración personalizada. Consulta la documentación de la API de Perkstar para orientarte, o contacta con un desarrollador.
¿Qué pasa si regenero mi clave API?
Todas las integraciones que usen la clave API antigua dejarán de funcionar de inmediato. Tendrás que actualizar cada integración personalizada con la nueva clave API. Las integraciones predefinidas (basadas en OAuth) no suelen verse afectadas.
¿Cómo de seguras son las integraciones?
Las integraciones usan prácticas de seguridad estándar del sector, como el cifrado HTTPS, la autenticación OAuth 2.0 y la protección de la clave API. Sigue siempre las mejores prácticas de seguridad: no compartas las claves API, usa contraseñas seguras y audita las integraciones con regularidad.
¿Pueden varios miembros del equipo gestionar las integraciones?
Los propietarios de la cuenta y los administradores suelen poder acceder a la sección de Integraciones. Lo mejor es limitar la gestión de integraciones al personal técnico, que entiende las implicaciones de conectar y desconectar sistemas.
Consejo: ¿Necesitas más ayuda? Contacta con el soporte de Perkstar para que te ayude con integraciones concretas, con la documentación de la API, con la resolución de problemas de conexión o con recomendaciones para tu tipo de negocio.