> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doko-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Herramientas

> Descubre y aprende a utilizar las potentes herramientas disponibles para tu chatbot.

## Generación de leads

Configura tu chatbot para recopilar información valiosa de leads durante las conversaciones. Esto le permitirá al chatbot poder recordar datos valiosos sobre el usuario para perfeccionar la experiencia de uso.

### Campos Personalizables

* Correo Electrónico
* Asunto de la consulta
* Motivo (agendar cita, ticket de soporte, etc.)
* Número de Teléfono

<Frame>
  <img src="https://mintcdn.com/doko/9rrzlpng10aHLOv7/images/tools/es/leads.png?fit=max&auto=format&n=9rrzlpng10aHLOv7&q=85&s=8df655640e99720a9ce30ae3281464eb" alt="Lead Fields" width="743" height="588" data-path="images/tools/es/leads.png" />
</Frame>

## Programación de citas

Permite a los usuarios programar citas directamente a través de tu chatbot. Varias de las características que incluye esta herramienta son:

* Correos de confirmación
* Plantillas para agendacion de citas
* Mensajes de confirmación
* Manejo de zonas horarias

<Frame>
  <img src="https://mintcdn.com/doko/9rrzlpng10aHLOv7/images/tools/es/meeting.png?fit=max&auto=format&n=9rrzlpng10aHLOv7&q=85&s=cfdc49cc370dddfb61c81c2fa5fa24b3" alt="Appointment Tool" width="752" height="805" data-path="images/tools/es/meeting.png" />
</Frame>

<Note>
  Si tu chatbot tiene la integración con Google Calendar, se agendaran tus citas en tu calendario
</Note>

### Agregar plantillas de reunion

Cada plantilla define la duración, ventana de disponibilidad y configuraciones del calendario para diferentes tipos de reuniones. Cuando un usuario consulta o agenda, el sistema usa estas plantillas para mostrar horarios disponibles y generar eventos bien formateados.

<Steps>
  <Step>
    * Añade el **nombre** de como se llamará la plantilla y la **duración** de la cita.

    <Frame>
      <img src="https://mintcdn.com/doko/Wg4IYUr-zcADJUz0/images/tools/es/plantilla-reunion.png?fit=max&auto=format&n=Wg4IYUr-zcADJUz0&q=85&s=5602611bfcca814641dc8381676d32ef" alt="Live Chat" width="476" height="417" data-path="images/tools/es/plantilla-reunion.png" />
    </Frame>
  </Step>

  <Step>
    * Define

    <Frame>
      <img src="https://mintcdn.com/doko/Wg4IYUr-zcADJUz0/images/tools/es/plantilla-reunion2.png?fit=max&auto=format&n=Wg4IYUr-zcADJUz0&q=85&s=d19d04ab4cd78d6d943a0f006e2fb1da" alt="Live Chat" width="476" height="292" data-path="images/tools/es/plantilla-reunion2.png" />
    </Frame>
  </Step>

  <Step>
    * Define la disponibilidad de tus citas

    <Frame>
      <img src="https://mintcdn.com/doko/Wg4IYUr-zcADJUz0/images/tools/es/plantilla-reunion3.png?fit=max&auto=format&n=Wg4IYUr-zcADJUz0&q=85&s=58d852bbac4f82b9d7cb0da244ce3e19" alt="Live Chat" width="477" height="338" data-path="images/tools/es/plantilla-reunion3.png" />
    </Frame>
  </Step>

  <Step>
    * Define la disponibilidad de tus citas

    <Frame>
      <img src="https://mintcdn.com/doko/Wg4IYUr-zcADJUz0/images/tools/es/plantilla-reunion4.png?fit=max&auto=format&n=Wg4IYUr-zcADJUz0&q=85&s=d2b8bcd7ea57c36c8d4bb5c1a31475f8" alt="Live Chat" width="477" height="596" data-path="images/tools/es/plantilla-reunion4.png" />
    </Frame>
  </Step>

  <Step>
    * Define la disponibilidad de tus citas

    <Frame>
      <img src="https://mintcdn.com/doko/Wg4IYUr-zcADJUz0/images/tools/es/plantilla-reunion5.png?fit=max&auto=format&n=Wg4IYUr-zcADJUz0&q=85&s=46404e95f960536de8dee324c4bf63ce" alt="Live Chat" width="477" height="677" data-path="images/tools/es/plantilla-reunion5.png" />
    </Frame>
  </Step>
</Steps>

## Tickets de soporte

Optimiza la eficiencia del soporte al cliente creando, organizando y gestionando automáticamente los tickets de soporte, garantizando una resolución más rápida, mejor comunicación y mayor satisfacción del cliente.

### Características Principales

* Creación automática de tickets
* Asignación de prioridad
* Clasificación por categorías
* Seguimiento de estado
* Asignación a equipos
* Seguimiento de resolución

<Frame>
  <img src="https://mintcdn.com/doko/9rrzlpng10aHLOv7/images/tools/es/ticket-soporte.png?fit=max&auto=format&n=9rrzlpng10aHLOv7&q=85&s=1e0c846bb5ce103b117490d12699cdc0" alt="Support Ticket" width="745" height="647" data-path="images/tools/es/ticket-soporte.png" />
</Frame>

## Chat en Vivo

Toma el control de las conversaciones cuando sea necesario con la función de chat en vivo.

La herramienta le permite al administrador del chatbot ejercer el dominio de la conversación para que un agente humano conteste las dudas o preocupaciones que tenga el usuario.

<Frame>
  <img src="https://mintcdn.com/doko/-p4Q5Mr8bh5M5OS8/images/live-chat.png?fit=max&auto=format&n=-p4Q5Mr8bh5M5OS8&q=85&s=d9873694dc0e97abb7b8c1df884dbf99" alt="Live Chat" width="1734" height="466" data-path="images/live-chat.png" />
</Frame>

### Características Principales

* Transferencia fluida de IA a humano
* Monitoreo de conversaciones en tiempo real
* Acceso al historial de chat
* Visualización de información del usuario

<Frame>
  <img src="https://mintcdn.com/doko/9rrzlpng10aHLOv7/images/tools/live-chat.png?fit=max&auto=format&n=9rrzlpng10aHLOv7&q=85&s=e6816cf877cc039fbdb071f781aeafaa" alt="Live Chat" width="541" height="327" data-path="images/tools/live-chat.png" />
</Frame>

## Procesar Pedidos

Deja que tu chatbot tome pedidos por ti, cantidad, datos del cliente, tipo de pago, etc.

### Características Principales

* Gestión de cantidad de pedidos
* Recopilación de datos del cliente
* Selección del tipo de pago
* Notificaciones de confirmación de pedido

<Frame>
  <img src="https://mintcdn.com/doko/-p4Q5Mr8bh5M5OS8/images/procesar-pedidos.png?fit=max&auto=format&n=-p4Q5Mr8bh5M5OS8&q=85&s=b7cc59348cd892ed422426934563a7ec" alt="Live Chat" width="1832" height="704" data-path="images/procesar-pedidos.png" />
</Frame>

## Formulario personalizado

Con esta herramienta, puedes personalizar la información que quieres captar de tu cliente

<Frame>
  <img src="https://mintcdn.com/doko/pKbjWpjWFDIh-Q-V/images/formulario-es.png?fit=max&auto=format&n=pKbjWpjWFDIh-Q-V&q=85&s=347254693ebbecb0343efbb48f4e3460" alt="Live Chat" width="1786" height="262" data-path="images/formulario-es.png" />
</Frame>

### Configura tu cuestionario

<Steps>
  <Step title="Configura el título del cuestionario">
    Pon la información relevante del cuestionario para que el chatbot sepa cuando activarse.

    <Frame>
      <img src="https://mintcdn.com/doko/wNz10e2dI8HDdsq4/images/configuracion-form-es.png?fit=max&auto=format&n=wNz10e2dI8HDdsq4&q=85&s=e04cb9f08239377c1904a1bed37cf34a" alt="Live Chat" width="1714" height="720" data-path="images/configuracion-form-es.png" />
    </Frame>
  </Step>

  <Step title="Configura los campos del cuestionario">
    Estos son los datos que el chatbot deberá recopilar del usuario

    <Frame>
      <img src="https://mintcdn.com/doko/wNz10e2dI8HDdsq4/images/campos-form-es.png?fit=max&auto=format&n=wNz10e2dI8HDdsq4&q=85&s=c9512609403c07e398796b5c320edd0a" alt="Live Chat" width="1722" height="978" data-path="images/campos-form-es.png" />
    </Frame>

    <Warning>Para que esta herramienta funcione debes añadir campos</Warning>
  </Step>
</Steps>

## Compartir archivos

La herramienta de compartir archivos te permite como administrador proporcionar archivos a tus usuarios de manera automática durante las conversaciones con el chatbot.

### Funcionalidades principales

* **Compartir archivos con usuarios**: Configura archivos (imágenes o PDFs) que el chatbot proporcionará automáticamente cuando se active una situación específica durante la conversación.

* **Subida de archivos por usuarios**: Los usuarios pueden subir archivos directamente al chatbot cuando esta funcionalidad está activada.

* **Gestión desde el dashboard**: Tienes la opción de subir archivos manualmente desde el dashboard, permitiendo al chatbot enviar información adicional a los usuarios cuando sea necesario.

<Frame>
  <img src="https://mintcdn.com/doko/9rrzlpng10aHLOv7/images/tools/es/shareFiles.png?fit=max&auto=format&n=9rrzlpng10aHLOv7&q=85&s=29ce9f5d0ee2d44ee7cfc9d928e4df81" alt="custom-tool" width="742" height="515" data-path="images/tools/es/shareFiles.png" />
</Frame>

### Configurar archivo para compartir

Para configurar un archivo que el chatbot proporcionará a los usuarios, necesitas completar el siguiente formulario:

* **Nombre del archivo**: Ingresa el nombre con el cual se identificará y enviará el archivo a los usuarios.

* **Situación de activación**: Describe cuándo se debe proporcionar este archivo a los usuarios. Por ejemplo, "cuando el usuario pregunte por el catálogo" o "cuando soliciten información de contacto". Esta descripción ayuda al chatbot a reconocer cuándo debe compartir el archivo.

<Frame>
  <img src="https://mintcdn.com/doko/P8Uor09ppmhnOjtD/images/tools/es/agregarFile.png?fit=max&auto=format&n=P8Uor09ppmhnOjtD&q=85&s=d04cac34f97451457a95558a11e6f99e" alt="Agregar archivo" width="418" height="278" data-path="images/tools/es/agregarFile.png" />
</Frame>

* **Descripción** (opcional): Proporciona una descripción opcional de lo que contiene el archivo.

* **Subir archivo**: Selecciona el archivo que deseas compartir. Puedes subir imágenes o archivos PDF con un tamaño máximo de 10MB.

<Frame>
  <img src="https://mintcdn.com/doko/9rrzlpng10aHLOv7/images/tools/es/descripcion-file.png?fit=max&auto=format&n=9rrzlpng10aHLOv7&q=85&s=8cb02a5526021df0f1254cb7ca9f0047" alt="Agregar archivo" width="430" height="633" data-path="images/tools/es/descripcion-file.png" />
</Frame>

### Cómo funciona

Cuando configuras un archivo para compartir, el proceso funciona de la siguiente manera:

1. **La situación de activación ocurre en la conversación**: El usuario menciona o pregunta algo que coincide con la situación de activación que configuraste.

2. **El chatbot reconoce la situación y responde**: El chatbot identifica que debe proporcionar el archivo basándose en la situación de activación configurada.

3. **El usuario recibe el archivo o enlace de descarga**: El chatbot automáticamente proporciona el archivo al usuario, ya sea como archivo adjunto o como enlace de descarga, dependiendo de la plataforma de integración.

<Tip>
  Asegúrate de ser específico en la situación de activación.
</Tip>

## Herramienta personalizada (API)

Con esta herramienta puedes habilitar a tu chatbot para que use cualquier API

<Frame>
  <img src="https://mintcdn.com/doko/pKbjWpjWFDIh-Q-V/images/custom-tool-es.png?fit=max&auto=format&n=pKbjWpjWFDIh-Q-V&q=85&s=7fc6ec870b28aa4660c73192b5c908a4" alt="custom-tool" width="1776" height="134" data-path="images/custom-tool-es.png" />
</Frame>

### Configura tu herramienta

<Steps>
  <Step title="Crear nueva herramienta">
    Haz clic en el botón "Crear herramienta" para comenzar a configurar tu herramienta personalizada.

    <Frame>
      <img src="https://mintcdn.com/doko/pKbjWpjWFDIh-Q-V/images/create-tool-es.png?fit=max&auto=format&n=pKbjWpjWFDIh-Q-V&q=85&s=a94f1723538ec20500c2722dacd1e2d9" alt="create-tool" width="1238" height="1556" data-path="images/create-tool-es.png" />
    </Frame>
  </Step>

  <Step title="Configurar información básica">
    Completa los campos principales de tu herramienta:

    * **Nombre**: Dale un nombre descriptivo a tu herramienta
    * **Método**: Selecciona el método HTTP (GET, POST, PUT, DELETE)
    * **Descripción**: Explica qué hace esta herramienta para que el chatbot sepa cuándo usarla
    * **URL**: Ingresa la URL del endpoint de tu API
  </Step>

  <Step title="Configurar body (para POST, PUT, DELETE)">
    Si seleccionaste POST, PUT o DELETE, podrás configurar los campos del cuerpo de la solicitud:

    Para cada campo del body puedes configurar:

    * **Nombre**: El nombre del campo (ej: userData, user\_data, items)
    * **Tipo**: El tipo de dato (Cadena, Número, Booleano, etc.)
    * **Es un array**: Marca esta opción si el campo debe ser un arreglo
    * **Descripción**: Explica qué información contiene este campo

    Ejemplos de configuración:

    * Campo simple: `nombre` (Cadena) - Para enviar un nombre de usuario
    * Campo array: `productos` (Cadena, Es un array ✓) - Para enviar una lista de productos
    * Campo numérico: `cantidad` (Número) - Para enviar cantidades
    * Campo booleano: `activo` (Booleano) - Para indicar si un usuario está activo
    * Campo objeto: `direccion` (Objeto) - Para enviar la dirección completa de un usuario

    <Note>El body solo es necesario para métodos POST, PUT y DELETE. GET no utiliza body.</Note>
  </Step>

  <Step title="Agregar parámetros (opcional)">
    Si tu API requiere parámetros de consulta, haz clic en "Agregar parámetro" y configura:

    * Nombre del parámetro
    * Tipo de dato
    * Si es requerido u opcional
      <Note>Los parámetros se envían como query strings en la URL</Note>
  </Step>

  <Step title="Configurar encabezados (opcional)">
    Para APIs que requieren autenticación o encabezados específicos, haz clic en "Agregar encabezado":

    * Nombre del encabezado (ej: Authorization, Content-Type)
    * Valor del encabezado (ej: Bearer token, application/json)
      <Warning>Mantén seguros tus tokens y claves API. No compartas esta información.</Warning>
  </Step>

  <Step title="Guardar herramienta">
    Una vez completada la configuración, haz clic en "Crear herramienta" para guardar y activar tu herramienta personalizada.
  </Step>
</Steps>

### Ejemplos de uso

<Accordion title="API de clima">
  **Nombre**: Consultar clima\
  **Método**: GET\
  **URL**: `https://api.openweathermap.org/data/2.5/weather`\
  **Parámetros**:

  * `q` (ciudad)
  * `appid` (tu API key)
  * `units` (metric)
</Accordion>

<Accordion title="API de inventario">
  **Nombre**: Consultar stock\
  **Método**: GET\
  **URL**: `https://tu-api.com/inventory/check`\
  **Encabezados**:

  * `Authorization`: `Bearer tu-token`
  * `Content-Type`: `application/json`
</Accordion>

<Tip>
  Tu chatbot automáticamente sabrá cuándo usar esta herramienta basándose en la descripción que proporciones. Sé específico sobre cuándo y cómo debe usarse.
</Tip>