Skip to main content
Las skills son flujos conversacionales que definen el comportamiento del bot. Puedes consultar las skills disponibles en tu bot y redirigir usuarios a una skill específica.

​
Obtener Skills

Consulta todas las skills disponibles en tu bot. 
GET https://api.jelou.ai/v1/bots/{botId}/skills

​
Parámetros de ruta

CampoUbicaciónTipoRequeridoDescripción
botIdPathstringSíIdentificador único del bot.

​
Ejemplo de solicitud

curl --request GET \
  --url 'https://api.jelou.ai/v1/bots/BOT_ID/skills' \
  --header 'Authorization: Basic {{Base64EncodedUsername:Password}}'

​
Respuestas

{
  "message": ["Skills retrieved successfully!"],
  "statusMessage": "success",
  "status": 1,
  "data": [
    {
      "id": 1,
      "name": "Skill Principal",
      "description": "Skill de bienvenida",
      "type": "BRAIN",
      "createdAt": "2024-10-24T11:18:05.000Z",
      "updatedAt": "2024-10-24T11:18:05.000Z",
      "state": true,
      "default": true
    },
    {
      "id": 2,
      "name": "Skill Ventas",
      "description": "Flujo de ventas",
      "type": "BRAIN",
      "createdAt": "2024-10-24T11:13:32.000Z",
      "updatedAt": "2024-10-24T11:17:44.000Z",
      "state": true,
      "default": false
    }
  ]
}

{
  "message": "Authentication failed"
}

{
  "message": ["Bot not found"],
  "status": "failed"
}

​
Detalle de la respuesta

PropiedadTipoDescripción
idintegerID de la skill. Este ID debe usarse para configurar redirecciones.
namestringNombre de la skill.
descriptionstringDescripción de la skill.
typestringTipo de skill.
statebooleanEstado de la skill. Solo las skills con estado true pueden ser utilizadas.
defaultbooleanIndica si la skill está seleccionada como predeterminada para el bot.
createdAtdateFecha de creación de la skill.
updatedAtdateFecha de última actualización de la skill.

​
Configurar Skill de usuario

Redirige a un usuario a una skill específica dentro del flujo conversacional. 
POST https://api.jelou.ai/v1/bots/{botId}/users/{userId}/skill/{skillId}

​
Requisitos

  • El usuario debe tener una sesión activa.

​
Parámetros de ruta

CampoUbicaciónTipoRequeridoDescripción
botIdPathstringSíIdentificador único del bot.
userIdPathstringSíIdentificador único del usuario.
skillIdPathstringSíIdentificador de la skill a la que será redirigido el usuario.

​
Cuerpo de la solicitud

CampoUbicaciónTipoRequeridoDescripción
memoryParamsBodyobjectNoParámetros opcionales que se pueden inyectar y utilizar posteriormente en la skill.

​
Ejemplo de solicitud

curl --request POST \
  --url 'https://api.jelou.ai/v1/bots/BOT_ID/users/USER_ID/skill/SKILL_ID' \
  --header 'Authorization: Basic {{Base64EncodedUsername:Password}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "memoryParams": {
      "test": 1
    }
  }'

​
Respuestas

{
  "message": "Skill set successfully",
  "status": "success"
}

{
  "message": "Invalid request",
  "status": "failed"
}

{
  "message": "Authentication failed"
}

{
  "message": "User or Skill not found",
  "status": "failed"
}