Cómo configurar el endpoint de una Skill en Lia (sin ser programador)

El error más común: poner la URL de tu tienda

Cuando creas una Skill en Lia y te pedimos una "URL de endpoint", lo primero que hace casi todo el mundo es poner la dirección de su tienda:

❌ https://mitienda.com
❌ https://mitienda.myshopify.com

Y no funciona. Esto no es un fallo tuyo — es que el campo pide algo diferente a lo que parece.

¿Qué es un endpoint y por qué es diferente?

La URL de tu tienda es una página para humanos: cuando alguien la abre, ve productos, imágenes, un menú. Cuando Lia la llama, recibe todo ese HTML y no sabe qué hacer con él.

Un endpoint es una dirección especial de tu sistema pensada para recibir datos automáticos, no para mostrar páginas. Cuando Lia la llama, le envía un JSON con los datos del cliente y la acción a realizar, y tu sistema responde "OK" (HTTP 200).

Piénsalo así: la URL de tu tienda es la puerta principal del local. El endpoint es el teléfono directo del almacén para que el transportista avise de que llega un paquete — no entran por la puerta principal, tienen un canal directo.

Qué recibe tu endpoint cuando Lia ejecuta una Skill

Lia hará una llamada POST a tu URL con este JSON:

{
  "skillSlug": "cancelar-pedido",
  "skillName": "Cancelar Pedido",
  "sessionId": "ses_abc123",
  "parameters": {
    "orderId": "12345",
    "reason": "ya no lo necesito"
  },
  "endUser": {
    "name": "Juan García",
    "email": "juan@email.com"
  },
  "executedAt": "2026-03-21T10:30:00Z"
}

Tu sistema lee esos datos, ejecuta la acción, y responde HTTP 200. Lia confirma al cliente que todo fue bien.

Cómo hacerlo según tu situación

Opción 1: Sin programar — Make.com (recomendado para la mayoría)

Make.com es una herramienta de automatización gratuita para empezar. No necesitas saber programar.

1. Entra en make.com y crea una cuenta gratuita
2. Crea un nuevo Scenario
3. Añade el módulo Webhooks → Custom Webhook
4. Haz clic en "Add" y dale un nombre (ej: "Lia - Cancelar Pedido")
5. Make te dará una URL como: https://hook.eu2.make.com/abc123xyz
6. Esa URL es la que pones en la Skill de Lia
7. Conecta el módulo de tu plataforma (Shopify, WooCommerce, tu ERP...)
8. Activa el Scenario

Así funciona el flujo: Lia → Make → tu tienda. Make hace de puente y tú no tienes que tocar código.

Opción 2: Zapier

Muy similar a Make. Crea un Zap con trigger Webhooks by Zapier → Catch Hook y Zapier te dará una URL pública lista para usar en Lia.

Opción 3: Shopify

Shopify no permite crear endpoints propios directamente en la tienda sin desarrollo. La solución más fácil es usar Make.com como intermediario (opción 1). Make tiene módulos nativos para Shopify que te permiten cancelar pedidos, actualizar datos, etc. sin escribir código.

Opción 4: WooCommerce (WordPress)

Con WooCommerce puedes crear un endpoint añadiendo este código en el fichero functions.php de tu tema:

add_action('rest_api_init', function () {
  register_rest_route('lia/v1', '/cancelar-pedido', array(
    'methods'  => 'POST',
    'callback' => 'lia_cancelar_pedido',
    'permission_callback' => '__return_true',
  ));
});

function lia_cancelar_pedido(WP_REST_Request $request) {
  $params = $request->get_json_params();
  $order_id = $params['parameters']['orderId'];
  $order = wc_get_order($order_id);
  if ($order) {
    $order->update_status('cancelled', 'Cancelado por Lia');
    return new WP_REST_Response(array('ok' => true), 200);
  }
  return new WP_REST_Response(array('error' => 'No encontrado'), 404);
}

La URL resultante sería: https://mitienda.com/wp-json/lia/v1/cancelar-pedido

Opción 5: Tienes programador o backend propio

Tu programador solo necesita crear una ruta POST que reciba el JSON de arriba y devuelva HTTP 200. Es menos de 30 minutos de trabajo para cualquier desarrollador web.

Ejemplo en Node.js:

app.post('/api/lia/cancelar-pedido', async (req, res) => {
  const { parameters, endUser } = req.body
  await cancelarPedido(parameters.orderId)
  res.status(200).json({ ok: true })
})

Cómo probar que funciona antes de activar la Skill

En el dashboard de Lia, al crear o editar una Skill, hay un botón "Probar endpoint". Lia manda una petición de prueba y te muestra si recibe HTTP 200 o un error. Úsalo siempre antes de activar la Skill para evitar sorpresas.

¿Tienes dudas?

Escríbenos a soporte@hellolia.es indicando qué plataforma usas y te ayudamos a configurarlo paso a paso.