Toda integración falla alguna vez: una credencial caduca, el proveedor tarda, cambia un identificador o una petición queda a medias. La fiabilidad depende menos de negar esa posibilidad que de preparar una respuesta segura.

El objetivo es proteger el estado de la reserva, informar sin confundir y permitir que el equipo retome el caso con evidencias.

Lectura rápida

Ideas clave

  • Distingue error técnico, ausencia de disponibilidad y dato inválido.
  • Repite solo operaciones que sean seguras de repetir.
  • Avisa con contexto y prioridad.
  • Registra la secuencia para poder reconstruirla.

Clasificar antes de responder

Un tiempo de espera agotado no significa que no haya plazas. Un identificador desconocido no significa que la actividad esté cerrada. Traducir todos los errores al mismo mensaje produce decisiones equivocadas.

La integración debe conservar el código original y asignar una categoría operativa: reintentar, pedir un dato, revisar configuración o escalar.

Reintentos que no dupliquen acciones

Consultar disponibilidad suele poder repetirse; crear o modificar una reserva exige más cuidado. Utiliza identificadores de operación y comprueba el estado antes de enviar de nuevo.

Los reintentos necesitan límites y pausas progresivas. Repetir sin control puede agravar una caída y ocultar el problema al equipo.

Qué decir al viajero

Explica lo que sí sabes: no ha sido posible comprobar el dato o completar la acción. Evita mensajes técnicos y confirma que no se ha registrado una reserva cuando ese sea el caso.

Ofrece un siguiente paso realista: revisión humana, volver a intentar o utilizar el checkout si sigue operativo. No prometas un tiempo de respuesta que el equipo no pueda cumplir.

Qué necesita recibir el equipo

Incluye viajero, actividad, fecha, participantes, acción intentada, hora, error y reintentos. Señala si existe riesgo de duplicado y qué debe comprobarse primero.

Después de resolver, revisa la causa y ajusta alertas o mapeos. Un incidente documentado puede prevenir repeticiones; uno resuelto por intuición vuelve a aparecer.

Fuentes consultadas

  1. FareHarbor: webhooks para integraciones