Primeros pasos
Integra Priority Hunter en tu producto en menos de 10 minutos. Al final de esta guía tendrás el widget instalado, con usuarios identificados y listo para recibir feedback de tus usuarios.
¿Qué es Priority Hunter?
Priority Hunter es una plataforma de gestión de feedback B2B. Permite a los equipos de producto recopilar ideas de sus usuarios, priorizarlas mediante votos, gestionar un roadmap público y publicar anuncios — todo desde un único panel.
El widget embebible es el punto de contacto principal con los usuarios finales: un iframe aislado que se carga de forma asíncrona en tu producto y no afecta el rendimiento de tu app. Los usuarios pueden enviar ideas, votar las existentes, explorar el roadmap y leer los últimos anuncios sin salir de tu interfaz.
Ideas
Los usuarios envían y votan sugerencias de mejora.
Roadmap
Publica el estado de las funciones en desarrollo.
Anuncios
Comunica novedades directamente en tu producto.
Inicio rápido
Sigue estos tres pasos para tener el widget funcionando en tu producto.
Crea un proyecto en Studio
Accede a Studio y crea una cuenta o inicia sesión. Una vez dentro:
- Haz clic en Nuevo proyecto en el panel principal.
- Elige un nombre y un slug para tu proyecto (el slug define la URL del portal público).
- Haz clic en Crear proyecto.
El slug del proyecto define el subdominio del portal público:tu-slug.app.priorityhunter.com. Elige algo reconocible para tus usuarios.
Instala el widget en tu producto
Ve a Studio › tu proyecto › Editor de Widget › Cómo conectar. Copia tu Widget ID y pégalo en el snippet de instalación.
Añade el siguiente código dentro del <head> de cada página donde quieras que aparezca el widget:
<!-- Pega esto dentro del <head> de tu página -->
<script>
(function(w,d){
w.PH=w.PH||function(){(w.PH.q=w.PH.q||[]).push(Array.prototype.slice.call(arguments));};
function load(){var s=d.createElement('script');s.async=true;s.src='https://widget.priorityhunter.com/embed.js';d.head.appendChild(s);}
d.readyState==='loading'?d.addEventListener('DOMContentLoaded',load):load();
})(window,document);
PH('init', { widgetId: 'YOUR_WIDGET_ID' });
</script>El loader pesa solo ~300 bytes. El archivo embed.js completo (~6 KB) se descarga de forma asíncrona después de que la página se ha procesado, por lo que no bloquea el renderizado.
Identifica a tus usuarios (recomendado)
Llama a PH('identify', user) después de que el usuario haya iniciado sesión. Esto asocia sus ideas, votos y comentarios con su cuenta y permite mostrar actividad personalizada en el badge de notificaciones.
// Llama esto cuando el usuario esté autenticado
PH('identify', {
id: currentUser.id, // ID interno requerido
email: currentUser.email, // opcional
name: currentUser.name, // opcional
});Los campos email y name son opcionales. Si no quieres almacenar PII (información personal identificable), pasa solo el id — el widget funciona igualmente.
¿Usas React o Next.js? Consulta las guías de framework para ver el patrón recomendado con hooks: React hook · Next.js App Router
¡Widget instalado!
Abre tu producto y verás el botón lanzador del widget. Si no aparece, comprueba que el widgetId es correcto.
Conceptos clave
Antes de continuar, familiarízate con los términos fundamentales de Priority Hunter.
Organización
El nivel raíz de tu cuenta. Puede contener múltiples proyectos y miembros del equipo.
Proyecto
Un producto o servicio concreto dentro de tu organización. Cada proyecto tiene su propio portal público, widget y roadmap.
Widget
El iframe embebible que aparece en tu producto. Contiene las pestañas de Ideas, Roadmap y Anuncios.
Widget ID
Identificador único del widget. Se usa en el snippet de instalación para vincular el iframe a tu proyecto.
Portal público
La página pública accesible en tu subdominio (ej. mi-app.app.priorityhunter.com). Los usuarios pueden acceder a él directamente sin instalar nada.
SSO Token
Un JWT firmado en el servidor que identifica al usuario de forma segura sin exponer secretos en el cliente.
Próximos pasos
Con el widget instalado y los usuarios identificados, explora estas guías para sacar el máximo partido a Priority Hunter.
Guía completa del Widget
API JavaScript, SSO, eventos, PH.ready y más.
SSO seguro con JWT
Identifica usuarios en producción sin exponer secretos.
Personalizar el tema
Adapta el widget a los colores de tu marca.
Eventos y badge
Reacciona a eventos del widget y muestra tu propio badge.