Saltar al contenido principal

Llamada de API

Configure integraciones personalizadas para que el chatbot pueda buscar o enviar información en tiempo real (ej: consultar estado de pedido, buscar productos, registrar tickets).

Puede añadir múltiples endpoints, respetando el límite de acciones activas de su plan.

Detalles del Endpoint​

Defina la identidad base de su solicitud:

  • Nombre del endpoint: Un nombre descriptivo (Ej: Buscar cliente por correo electrónico).
  • Método: GET, POST, PUT, DELETE, etc.
  • URL: La dirección del recurso en la API externa.

Autenticación​

Si su API requiere seguridad, haga clic en el botón Autenticación para abrir el modal de configuración:

  • Método y URL de Autenticación: Define dónde WiseMind debe obtener el token.
  • Body y Headers: Envíe las credenciales necesarias (ej: username y password en formato JSON).
  • Ruta del token en la respuesta: Notación por puntos para extraer el token (ej: data.access_token).
  • Expira en (s): Tiempo de vida del token para que WiseMind sepa cuándo renovarlo.

Instrucciones de Uso y Post-ejecución​

Guíe a WiseMind sobre el comportamiento de la integración:

  • ¿Cuándo debe utilizarse esta acción?

    Explique el escenario ideal. Ej: "Use esta acción cuando el cliente quiera consultar el estado de un pedido. Pida el CPF antes de llamar a la API."

  • Instrucciones post-ejecución

    Indique cómo el asistente debe tratar la respuesta. Ej: "Resuma la respuesta de la API en formato de lista amigable y pregunte si el cliente necesita algo más."

Datos Adicionales​

Añada campos opcionales enviados en la solicitud cuando sea necesario. El panel está dividido en pestañas:

  • Headers, Body, Path Params, Querystring
  • Puede añadir múltiples elementos definiendo la Clave y el Valor en cada pestaña.

Datos del usuario identificado​

Si su sitio utiliza Identificación de Usuarios, los claims verificados del JWT quedan disponibles en cualquier campo de la solicitud (URL, Headers, Body, Path Params, Querystring) a través de la sintaxis {{identity.<claim>}}.

Ejemplos:

GET https://api.susitio.com/customers/{{identity.account_id}}/orders
Authorization: Bearer {{identity.api_token}}

Los valores solo se interpolan después de la verificación de la firma del token. Si el token está ausente, expirado o no es válido, la acción no se ejecuta.

Probar Endpoint

Antes de guardar, puede expandir la sección Probar Endpoint para simular una solicitud real con valores de ejemplo y asegurar que la configuración sea correcta.