API e integraciones

La API de SeeItLive te permite iniciar sesiones y recibir los resultados directamente desde tu propio producto o backend, para que una vista en vivo sea un solo botón dentro de tu helpdesk, tu app de servicio de campo o tu CRM.

Fundamentos de la API

La API REST está organizada en torno a las sesiones. Creas una sesión (indicando opcionalmente cómo invitar al cliente) y luego consultas su estado o recibes actualizaciones por webhook. La referencia completa de los endpoints está en la documentación para desarrolladores.

  • Crear una sesión — devuelve un id de sesión y el enlace de invitación.
  • Consultar el estado — comprueba si el cliente se unió y qué se ha capturado.
  • Recibir capturas — entregadas a tu webhook a medida que se capturan.

Autenticación

Cada solicitud a la API se autentica con una clave API de tipo bearer creada dentro de tu equipo. Envíala en el encabezado Authorization:

Authorization: Bearer sil_live_xxxxxxxxxxxx

Atención

Las claves API son secretas. Guárdalas en tu servidor, nunca en código de navegador o de app móvil, y rótalas si alguna llega a exponerse. Consulta seguridad de las claves API.

SDK de cliente

En lugar de llamar a los endpoints REST a mano, puedes usar un SDK de cliente oficial. Encapsulan la autenticación, la creación de sesiones y la comprobación de estado en código idiomático. Hay SDK disponibles para:

Node.js, Go, Java, PHP, Rust, Perl y Ruby.

Nota

Cada SDK expone el mismo contrato — crear una sesión, comprobar su estado y verificar tokens OAuth — para que puedas cambiar de lenguaje sin volver a aprender el flujo.

Webhooks

Un webhook es un endpoint HTTPS de tu lado que SeeItLive llama cuando ocurre algo en una sesión — sobre todo cuando se captura una instantánea. En lugar de consultar el estado, recibes un evento en el momento en que ocurre.

  1. Registra la URL de tu endpoint en los ajustes del equipo.
  2. Enviamos una carga JSON firmada por POST para cada evento.
  3. Verifica la firma para confiar en que la solicitud realmente proviene de nosotros.
Consejo

Verifica la firma del webhook en cada solicitud — así sabes que la carga proviene de verdad de SeeItLive y no ha sido falsificada. Consulta seguridad de las claves API.

Entrega de capturas

Las capturas tomadas durante una sesión pueden entregarse automáticamente a tus sistemas a medida que ocurren — enviadas a tu webhook para que lleguen al ticket, registro o flujo de trabajo al que pertenecen, sin ningún paso de exportación manual.

Integraciones

Más allá de la API en bruto, SeeItLive se conecta con las herramientas que tu equipo ya usa, para que una sesión en vivo y sus capturas puedan fluir directamente hacia tu flujo de trabajo existente. Consulta la documentación de integraciones para ver la lista actual y los pasos de configuración.

API e integraciones