Descripción general de Herramientas

Una herramienta es una acción reutilizable que Connectly puede ejecutar por ti, como buscar un pedido, comprobar existencias, crear un ticket o guardar un registro. La creas una vez en la página Herramientas y luego la usas en tus agentes de IA, campañas y WhatsApp Flows dinámicos.

​

La página Herramientas

Abre Herramientas en la barra lateral. La página tiene cuatro pestañas: La pestaña Herramientas muestra estas columnas: Usa el cuadro de búsqueda para encontrar una herramienta por nombre o descripción. También puedes filtrar por tipo o campaña.

​

Crear una herramienta

​

¿Qué tipo debo usar?

​

Herramientas de llamada a API

Una herramienta de API envía una solicitud HTTP a un servicio cuando se ejecuta.

• Método y URL del endpoint: elige el método HTTP e introduce la URL. Usa {parameter} para valores que cambian en cada llamada, por ejemplo https://api.example.com/orders/{order_id}.
• Encabezados: agrega los encabezados que necesite el servicio.
• Autenticación: elige una credencial guardada o selecciona Nuevo recurso para crear una (consulta Autenticación).

​

Herramientas de script de JavaScript

Una herramienta de script ejecuta tu JavaScript cada vez que se invoca. Recibe los datos de entrada, realiza su trabajo y devuelve un resultado. El editor permite probar el script en tiempo real y consultar el resultado y los registros antes de publicarlo. Si el script importa otra herramienta, el editor te avisa cuando usa una versión anterior. Actualiza la importación, implementa y vuelve a probar para usar la versión más reciente.

​

Esquema de entrada y salida

Abre la pestaña Esquema para describir tu herramienta con JSON Schema:

• Esquema JSON de entrada: la información que espera la herramienta, por ejemplo, una cadena order_id.
• Esquema JSON de salida: la estructura de lo que devuelve.
• Resultado de ejemplo: un ejemplo de un resultado habitual.

Un buen esquema ayuda a los agentes de IA a completar los valores correctos y entender el resultado.

​

Autenticación

Las herramientas de API pueden autenticarse con tu servicio. Las credenciales se cifran y almacenan de forma segura. Después de guardarlas, no se vuelven a mostrar en texto sin formato. Las credenciales guardadas aparecen en la lista Seleccionar recurso de autenticación para que puedas reutilizarlas en distintas herramientas.

​

Probar una herramienta

Usa el panel Prueba, junto al editor.

1. En Entrada simulada, introduce el JSON que debe recibir la herramienta, por ejemplo { "order_id": "12345" }.
2. Selecciona Ejecutar prueba.
3. Consulta el resultado en la pestaña Salida y los detalles en Registros. El estado muestra SUCCESS o ERROR.

​

Versiones, borradores y publicación

Cada vez que guardas, se crea una nueva versión de la herramienta. Así puedes consultar los cambios y volver a una versión anterior.

• Usa el selector de versiones en la parte superior del editor para cambiar de versión.
• Al guardar o implementar, elige Incremento automático (Connectly selecciona el siguiente número) o Versión personalizada (por ejemplo, 2.0.0). Una versión personalizada debe ser superior a la actual.
• La herramienta empieza como Borrador. Selecciona Publicar para que esté disponible. Debes guardar o implementar los cambios más recientes antes de publicarla.

El editor también muestra quién creó la herramienta y quién modificó cada versión por última vez. Esto resulta útil cuando varias personas del equipo trabajan en la misma herramienta. Las ediciones asistidas por IA se etiquetan como Asistente de IA.

​

Supervisar tus herramientas

​

Ejecuciones

La pestaña Ejecuciones muestra cada ejecución, empezando por la más reciente, y se actualiza a medida que llegan nuevas. Para cada ejecución puedes consultar la hora, la herramienta, el estado, la duración y el código de estado. Selecciona una ejecución para abrir sus registros, incluidos los identificadores de ejecución, sesión y sala asociados. Acota la lista con estos filtros:

• Herramienta: elige una herramienta o busca por nombre (usa | para buscar varias).
• Estado: Correcta o Fallida.
• Intervalo de tiempo: desde 15 minutos hasta 15 días, o un intervalo personalizado.
• ID de ejecución, ID de sesión o ID de sala: ve directamente a una conversación o ejecución.

​

Tasa de éxito

La columna Actividad de la pestaña Herramientas muestra de un vistazo el estado de cada herramienta. Una caída en la tasa de éxito suele ser la primera señal de que un servicio externo no está disponible o de que una credencial ha caducado.

​

Datastore

El Datastore es un almacenamiento duradero de clave y valor que tus herramientas pueden leer y escribir durante la ejecución, por ejemplo, para recordar la última elección de un cliente.

• Explora y filtra las claves por prefijo, y consulta el valor, el tamaño y la última actualización de cada una.
• Agrega, edita o elimina claves. Los cambios se aplican de inmediato.
• Vuelve a un estado anterior. Puedes restaurar cualquier momento dentro del período de retroceso que se muestra en la página. Connectly guarda primero un punto de restauración del estado actual, por lo que también puedes deshacer una reversión.

​

Compartir una herramienta

Puedes compartir una herramienta con otro negocio.

1. Abre la acción Compartir de la herramienta en la lista.
2. Introduce el ID del otro negocio y selecciona Compartir.
3. Para dejar de compartirla, selecciona Dejar de compartir junto a ese negocio.

El otro negocio verá la herramienta en Herramientas compartidas. Podrá verla y probarla, pero no editarla. Las ejecuciones compartidas aparecen como Compartidas en Ejecuciones.

​

Eliminar una herramienta

Selecciona Eliminar en la fila de la herramienta. Esto elimina la herramienta y todas sus versiones de forma irreversible. Las herramientas que usa un WhatsApp Flow se gestionan con el flujo. Se eliminan automáticamente cuando el flujo se elimina o se deja de usar. Consulta WhatsApp Flow Builder.

​

Solución de problemas

​

Próximos pasos