Tools Globales

1. Solicitar Datos al Usuario (requestDataInputFromUser)

Propósito: Solicitar múltiples datos estructurados en un solo formulario.

Casos de uso:

• Recopilar datos personales para contacto.
• Captura de información para cotizaciones o calificación de leads.

2. Escalar a Soporte Humano (requestManualSupport)

Propósito: Transferir la conversación a un agente humano.

Casos de uso:

• Cuando el usuario pide hablar con una persona.
• Consultas complejas fuera del alcance de la IA.

3. Buscar en Base de Conocimiento (searchKnowledgeBase)

Propósito: Consultar la base de conocimiento para responder con información validada.

Casos de uso: FAQs, políticas internas y datos de producto.

4. Clasificar Tipo de Usuario (setUserType)

Propósito: Etiquetar al usuario como cliente o lead.

Casos de uso: Segmentación y ruteo automático de conversaciones.

5. Agendar Llamada (agendarLlamada)

Propósito: Programar llamadas telefónicas.

Formato requerido: YYYY-MM-DD HH:MM.

6. Spreadsheets (spreadsheets)

Propósito: Leer, escribir, ejecutar fórmulas y agregar filas en Google Sheets.

Casos de uso: Inventarios, reportes operativos, carga de pedidos y contactos.

Nota: Reemplaza a readGoogleSheet y writeGoogleSheet; ambas siguen disponibles pero su uso está desaconsejado.

7. Enviar Request HTTP (sendRequest)

Propósito: Integrarse con APIs externas mediante GET, POST o PUT.

Requerimiento: URL, método, headers y esquema de entrada.

8. Ejecutar JavaScript (runJavascript)

Propósito: Ejecutar código para transformaciones y automatizaciones complejas.

Casos de uso: Procesamiento de archivos, cálculos avanzados y lógica custom.

9. Ejecutar SQL (executeSql)

Propósito: Ejecutar consultas de solo lectura (SELECT) en MySQL/PostgreSQL.

Características: Operaciones de escritura bloqueadas por seguridad.

10. Alarm (alarm)

Propósito: Crear o cancelar alarmas para recordatorios de seguimiento.

Casos de uso: Recontactos programados y tareas internas temporizadas.

11. Admin (admin)

Propósito: Operaciones administrativas sobre cuentas, workers y workspaces.

Casos de uso: Listar entidades y gestionar instrucciones de workspace.

12. Chatwoot (chatwoot)

Propósito: Gestionar conversaciones en Chatwoot desde el worker.

Casos de uso: Cambiar estado, etiquetar y asignar usuarios o equipos.

13. Tienda Nube (tiendanube)

Propósito: Consultar productos y órdenes de la tienda.

Requerimiento: Conexión OAuth activa.

14. Wix (wix)

Propósito: Buscar clientes e historial de compras en Wix.

Requerimiento: siteId y apiKey.