Qué son los servicios vinculados
Un servicio vinculado es un puntero con nombre a uno de tus endpoints HTTP. Cada entrada tiene:
- un Service ID: el identificador corto que usan las acciones para llamarlo (por ejemplo
orders_api); - un Method:
GET,POST,PUToDELETE; - una URL: el endpoint al que se envía la petición;
- una cabecera de autenticación opcional y su valor secreto.
Cuando una acción invoca un servicio vinculado, el backend de Seekdown hace la petición en nombre del asistente, adjunta la cabecera de autenticación si la configuraste y devuelve la respuesta a la conversación. Como el asistente solo se refiere al servicio por su id, la URL real y cualquier credencial se quedan en el servidor: nunca forman parte de la configuración pública del asistente que descarga el widget.
Cuándo usar un servicio vinculado
- Obtener datos en directo que el dataset no puede contener —el estado de un pedido, el nivel de stock o el saldo
de una cuenta— en respuesta a la pregunta de un usuario.
- Enviar una petición a tus sistemas —crear un ticket, registrar un interés, lanzar un
flujo de trabajo— desde un formulario que muestra el asistente.
- Mantener una clave de API fuera de la página: quieres llamar a un endpoint autenticado sin
exponer la clave en el código front-end.
Documentación relacionada
- Personalización avanzada: dónde viven las acciones y el
helper executeProxyRequest.
- Formularios del asistente: recoge datos que el asistente puede enviar a un servicio vinculado.