Ninguna herramienta de soporte opera en el vacío. Tu equipo ya usa Slack para la comunicación interna, herramientas de gestión de proyectos para el seguimiento de tareas y CRMs para los datos de clientes. Heedback se integra con tu stack existente a través de integraciones nativas, webhooks y una API REST — para que la información fluya donde se necesita sin copiar y pegar manualmente.

Requisitos previos

Antes de comenzar, asegúrate de tener:

Una cuenta de Heedback con permisos de administrador o propietario
Acceso a las herramientas que quieres integrar (administrador del espacio de trabajo de Slack, endpoint de webhook, etc.)
Para el uso de la API: familiaridad con APIs REST y un cliente HTTP (cURL, Postman o la librería HTTP de tu lenguaje)

Paso 1: Conecta Slack

Slack es la integración más popular, y Heedback la soporta de forma nativa. Así es como configurarla:

Ve a Configuración → Integraciones en tu panel de Heedback.
Encuentra Slack en la lista de integraciones y haz clic en Conectar.
Serás redirigido a la página de autorización OAuth de Slack. Selecciona el espacio de trabajo que quieres conectar y aprueba los permisos.
De vuelta en Heedback, elige qué canal de Slack debería recibir las notificaciones. Puedes elegir un canal existente o crear uno dedicado como #soporte-clientes.
Configura qué eventos generan mensajes en Slack — nuevas conversaciones, nuevos mensajes, cambios de estado o todos los anteriores.

Una vez conectado, tu equipo recibe notificaciones en Slack en tiempo real cuando los clientes se comunican. Cada notificación incluye el mensaje del cliente, su información de perfil (si está identificado) y un enlace directo a la conversación en Heedback.

Consejo: Crea un canal de Slack dedicado para las notificaciones de Heedback. Mezclar alertas de soporte en un canal general concurrido significa que quedarán enterradas.

Paso 2: Configura webhooks

Los webhooks te permiten enviar eventos de Heedback a cualquier endpoint HTTP — tu propio backend, una función serverless o una plataforma de automatización como Zapier o n8n.

Ve a Configuración → Webhooks y haz clic en Añadir webhook. Necesitarás proporcionar:

URL: El endpoint que recibirá las peticiones POST. Debe ser accesible públicamente y devolver un código de estado 200.
Eventos: Selecciona qué eventos activan el webhook. Los eventos disponibles incluyen:
- conversation.created — se abre una nueva conversación
- message.created — se envía un nuevo mensaje (por cliente o agente)
- conversation.status_changed — una conversación se abre, cierra o pospone
- post.created — se envía una nueva solicitud de función
- vote.created — un usuario vota en una solicitud de función
Secreto (opcional pero recomendado): Un secreto compartido usado para firmar los payloads del webhook. Verifica la firma en tu lado para asegurar que las peticiones provienen genuinamente de Heedback.

Cada entrega de webhook incluye un payload JSON con el tipo de evento, la marca de tiempo y los datos completos del recurso. Por ejemplo, un evento message.created incluye el contenido del mensaje, el ID de conversación, los detalles del remitente y el contexto de la organización.

Paso 3: Construye con la API REST

Para integraciones más profundas, Heedback proporciona una API REST versionada en /api/v1/. Los casos de uso comunes incluyen:

Sincronización de contactos: Extrae datos de usuarios finales a tu CRM o envía actualizaciones del CRM de vuelta a Heedback.
Creación de conversaciones programáticamente: Inicia conversaciones de soporte desde eventos en tu propia app (por ejemplo, un pago fallido, una alerta de error).
Exportación de datos: Obtén conversaciones, mensajes o votos de tableros de funciones para reportes y análisis.

Autenticación: Las peticiones a la API requieren una cookie de sesión (para integraciones del panel) o una clave API pasada en el encabezado Authorization. Genera claves API en Configuración → API.

Ejemplo — Obtener todas las conversaciones abiertas:

curl -H "Authorization: Bearer TU_CLAVE_API" \
  https://tu-instancia-heedback.com/api/v1/conversations?status=open

La API sigue las convenciones REST: los recursos son sustantivos, las acciones son verbos HTTP y las respuestas son JSON. La paginación usa los parámetros de consulta page y limit.

Paso 4: Automatiza con Zapier o n8n

Si prefieres automatización sin código, los webhooks son el puente entre Heedback y plataformas como Zapier, Make o n8n.

Ejemplo con Zapier — Crear un ticket de Jira por cada nueva solicitud de función:

Crea un Zap con un trigger Webhooks by Zapier (Catch Hook).
Copia la URL del webhook de Zapier y añádela en la configuración de webhooks de Heedback con el evento post.created.
Añade un paso de acción de Jira que cree un nuevo issue usando datos del payload del webhook (título, descripción, cantidad de votos).
Activa el Zap y pruébalo enviando una solicitud de función en Heedback.

Ejemplo con n8n — Publicar un resumen en Slack cuando se cierra una conversación:

Crea un flujo de trabajo en n8n con un nodo trigger Webhook.
Añade un nodo de filtro para verificar que event === "conversation.status_changed" y status === "closed".
Añade un nodo de Slack que publique un resumen (nombre del cliente, tema, tiempo de resolución) en tu canal #victorias-soporte.

Paso 5: Monitorea y depura

Las integraciones pueden fallar silenciosamente si los endpoints caen o los payloads cambian. Heedback te ayuda a mantenerte al tanto:

Logs de webhooks: En Configuración → Webhooks, cada webhook muestra un log de entregas con códigos de estado, tiempos de respuesta y payloads. Las entregas fallidas se destacan en rojo.
Reintentos automáticos: Las entregas fallidas de webhooks se reintentan hasta 3 veces con backoff exponencial. Si todos los reintentos fallan, el webhook se marca para tu atención.
Entregas de prueba: Haz clic en Enviar prueba en cualquier webhook para activar un payload de ejemplo. Úsalo para verificar que tu endpoint está recibiendo y procesando datos correctamente antes de ir a producción.

Consejos y buenas prácticas

Comienza con Slack y un webhook. No intentes conectar todo de una vez. Haz que una integración funcione de forma confiable, luego expande.
Siempre verifica las firmas de los webhooks. Sin verificación de firma, cualquiera que descubra la URL de tu endpoint podría enviar eventos falsos.
Usa manejadores idempotentes. Las entregas de webhooks pueden duplicarse ocasionalmente. Diseña tus manejadores para procesar el mismo evento dos veces de forma segura y sin efectos secundarios.
Mantén las claves API con alcance limitado y rotadas. No compartas una sola clave API en todas las integraciones. Crea claves separadas para cada caso de uso para poder revocar una sin romper todo.

Funciones relacionadas

Notificaciones — Los webhooks complementan las notificaciones en la app y por correo. Usa webhooks para automatización entre sistemas, notificaciones para alertas dirigidas a personas.
Tableros de funciones — Los eventos de webhook para votos y solicitudes de funciones te permiten canalizar el feedback de producto directamente a tus herramientas de planificación.
Bandeja de soporte — Las conversaciones que activan eventos de webhook se originan aquí. Una bandeja bien organizada hace que los datos de integración sean más significativos.
Gestión de equipo — Controla qué miembros del equipo pueden configurar integraciones a través de permisos basados en roles.