Integraciones, API y webhooks
Luradesk ofrece una API REST y webhooks para que tus otros sistemas creen tickets y reaccionen a los eventos de soporte. Esta página separa lo que ya está disponible de lo que está planificado.
Arquitectura
Cada empresa en Luradesk tiene su propia base de datos. Un token de API pertenece a una sola empresa, y el servidor identifica la empresa a partir del token antes de abrir cualquiera de sus datos. Un token de una empresa nunca puede leer tickets de otra.
Disponible hoy
| Integración | Qué hace | Planes |
|---|---|---|
| API REST | Crea, lista y consulta tickets por HTTPS con un token bearer | Professional, Business |
| Webhooks | Envía notificaciones HTTP POST firmadas cuando se crean o actualizan tickets | Professional, Business |
| Notificaciones por correo | Avisa al solicitante por correo cuando un agente responde | Starter y superiores |
API REST
Los tokens los crea un administrador en Configuración → Tokens de API. Solo se guarda un hash de cada token, y los tokens pueden revocarse en cualquier momento.
GET /api/v1/tickets lista tickets (filtros: status, page)
POST /api/v1/tickets crea un ticket
GET /api/v1/tickets/{number} consulta un ticket y sus mensajes públicos
Las peticiones usan Authorization: Bearer <token> y cuerpos JSON. Se aplican límites de frecuencia.
Webhooks
Un webhook envía un JSON a tu endpoint HTTPS en eventos como ticket.created y ticket.updated. Cada petición incluye la cabecera X-Luradesk-Signature con un HMAC-SHA256 del cuerpo, para que tu sistema compruebe que proviene de Luradesk. Los envíos fallidos se reintentan con intervalos crecientes.
Notificaciones por correo
El solicitante recibe un correo cuando el equipo responde públicamente a su ticket. Las notas internas nunca generan correos a los solicitantes.
Planificado
Estas integraciones están en la hoja de ruta y todavía no están disponibles:
- Correo a ticket: crear tickets a partir de mensajes enviados a una dirección de soporte.
- WhatsApp: recibir y responder solicitudes por WhatsApp dentro del ticket. Los costes de mensajería podrán facturarse aparte.
- Asistencia con IA: respuestas sugeridas, resúmenes y clasificación. El consumo podrá facturarse aparte.
- Aplicaciones móviles.
- Inicio de sesión único (SSO).
Si la integración que necesitas no aparece, cuéntanoslo: las peticiones de equipos como el tuyo orientan la hoja de ruta.
Reúne todas las solicitudes de soporte en un solo lugar
Crea tu help desk con el plan Free, invita a tu equipo y abre el primer ticket en pocos minutos.