Saltar al contenido principal

Conector

Módulo Conector: Guía de Configuración Amigable

¡Bienvenido a la configuración del Conector! Esta herramienta permite que tu bot se conecte a otros sistemas—como sitios web o aplicaciones—para enviar o recibir información. Piensa en ello como el mensajero de tu bot hacia el mundo exterior. Lo configurarás en una ventana emergente (llamada "modal") que es fácil de usar—¡sin necesidad de programar!

¿Qué hace el Conector?​

El Conector ayuda a tu bot a:

  • Obtener información (como consultar el clima).
  • Enviar información (como crear una tarea).
  • Actualizar o eliminar cosas (como cambiar una nota o eliminar un archivo).

Completarás algunos campos en la ventana emergente para indicarle dónde ir, qué hacer y cómo manejar la respuesta.

Configuración Paso a Paso en la Ventana Emergente​

Cuando abres la herramienta Conector, aparece una ventana emergente titulada "Connector" desde la parte inferior. Así es como se utiliza:

1. Dale un Nombre a tu Conector​

  • Dónde: El cuadro de texto "Name" en la parte superior.
  • Qué hace: Es una etiqueta para recordarte para qué sirve este Conector (por ejemplo, "Verificador del Clima" o "Enviador de Tareas").
  • Cómo configurarlo: Escribe un nombre corto y claro. Es obligatorio, ¡así que no puedes dejarlo en blanco!

Ejemplo: Escribe "Email Sender" si es para enviar correos electrónicos.

2. Establece el Destino (Url)​

  • Dónde: El cuadro de texto "Url".
  • Qué hace: Esta es la dirección web donde tu bot envía su mensaje—como un enlace (por ejemplo, https://api.tasks.com).
  • Cómo configurarlo: Pega la dirección del servicio al que te estás conectando. Si depende de la entrada del usuario (como una ciudad), usa un marcador como {user_city} vinculado a un paso anterior. ¡También es obligatorio!

Ejemplo: Para un servicio meteorológico, escribe https://api.weather.com/today.

3. Elige una Acción (Method)​

  • Dónde: El menú desplegable "Method".
  • Qué hace: Le dice al Conector qué hacer en el destino. Las opciones son:
    • GET: Solicitar información (por ejemplo, "¿Cuál es el clima?").
    • POST: Enviar nueva información (por ejemplo, "Crear una tarea").
    • PUT: Actualizar algo (por ejemplo, "Cambiar el título de una tarea").
    • PATCH: Hacer un pequeño ajuste (por ejemplo, "Corregir la fecha de una tarea").
    • DELETE: Eliminar algo (por ejemplo, "Eliminar una tarea").
  • Cómo configurarlo: Haz clic en el menú desplegable y elige la acción correcta. El servicio al que te estás conectando debería indicarte cuál usar. ¡Es obligatorio!

Ejemplo: Elige "POST" para crear una nueva tarea.

4. Agrega Detalles Adicionales (Params)​

  • Dónde: La tabla "Params" (una cuadrícula con columnas).
  • Qué hace: Son notas adicionales para hacer que tu mensaje sea claro. La tabla tiene:
    • Name: Cómo se llama la nota (por ejemplo, "password" o "city").
    • Value: Lo que dice la nota (por ejemplo, "xyz123" o "London").
    • Key: Dónde va—"Header" (reglas especiales) o "Query Params" (añadido a la URL).
  • Cómo configurarlo:
    1. Haz clic en el botón "+" (signo más) para añadir una fila.
    2. En "Name", escribe el nombre del detalle (por ejemplo, "Authorization").
    3. En "Value", escribe la información (por ejemplo, "your_api_key" o {user_input}).
    4. En "Key", haz clic en el menú desplegable y elige "Header" o "Query Params".
    5. Para editar o eliminar, usa los íconos de lápiz o papelera junto a cada fila.

Ejemplo:

  • Fila 1: Name = "Authorization", Value = "xyz123", Key = "Header".
  • Fila 2: Name = "city", Value = "New York", Key = "Query Params".

5. Escribe el Mensaje (BODY)​

  • Dónde: El cuadro "BODY" (un área de texto formateado con llaves {}).
  • Qué hace: Esta es la información principal que tu bot envía—como detalles de una tarea. Es necesario para "POST", "PUT" o "PATCH", y es obligatorio (deja como {} si está vacío).
  • Cómo configurarlo:
    1. Para "GET" o "DELETE", déjalo como {}.
    2. Para otras acciones, escribe información en este formato: 
      {
        "title": "New Task",
        "description": "Do this today"
      }
    3. Usa marcadores (por ejemplo, {task_title}) para entradas de usuario o pasos anteriores.

Ejemplo: Para una tarea:

{
  "summary": "Fix the bug",
  "description": "Urgent!"
}

Consejo: Se ve como una lista con llaves—pregunta a tu administrador por un ejemplo si el servicio necesita un formato específico.

6. Maneja la Respuesta (Javascript function body)​

  • Dónde: El cuadro "Javascript function body" (un área de texto grande con texto tipo código).
  • Qué hace: Le dice al bot qué hacer con la respuesta—como guardarla o mostrarla. ¡No necesitas ser programador!
  • Cómo configurarlo:
    1. Por defecto, dice: 
      //here we need to return a pure JavaScript object 
      return {};
      Reemplaza return {}; con return data; para guardar la respuesta completa.
    2. Para algo específico (como un ID de tarea), prueba {return id;}.
    3. Pide ayuda a tu administrador si necesitas un ajuste más elaborado.

Ejemplo: Para guardar un ID de tarea, escribe:

return {id};

7. Prueba y Guarda tu Conector​

  • Dónde: Los botones en la parte inferior: "Test", "Save", "Save and close", "Close".
  • Qué hace: Te permite verificar y almacenar tu configuración.
  • Cómo configurarlo:
    1. Test: Haz clic en "Test" para probarlo. Aparece una pequeña ventana que muestra si funcionó (por ejemplo, "Success" o un error). Necesitas guardar primero si has hecho cambios.
    2. Save: Haz clic en "Save" para mantener tu configuración sin cerrar la ventana emergente.
    3. Save and close: Haz clic en "Save and close" para guardar y salir.
    4. Close: Haz clic en "Close" para salir sin guardar (si no presionaste "Save" antes, los cambios no se mantendrán).

Consejo: ¡Prueba primero! Si la ventana emergente de prueba muestra un "Success" verde (como "200" o "201"), estás listo para guardar.

Trucos Especiales Simplificados​

Manteniéndolo Seguro (Encriptación)​

  • Qué hace: Codifica tu mensaje para que solo el destino pueda leerlo.
  • Cómo configurarlo: En la tabla "Params":
    1. Añade una fila: Name = "isEncrypted", Value = "true", Key = "Header".
    2. Añade otra: Name = "key", Value = "your_secret_word" (por ejemplo, "mykey123"), Key = "Header".

Ejemplo:

  • Fila 1: Name = "isEncrypted", Value = "true", Key = "Header".
  • Fila 2: Name = "key", Value = "task123", Key = "Header".

Conectando con Jira (Herramienta de Tareas)​

  • Qué hace: Simplifica la comunicación con Jira, un gestor de tareas.
  • Cómo configurarlo: En la tabla "Params":
    1. Añade: Name = "isJira", Value = "true", Key = "Query Params".
    2. Añade más filas como:
      • Name = "project", Value = "12345", Key = "Query Params".
      • Name = "summary", Value = "New Task", Key = "Query Params".

Ejemplo:

  • Fila 1: Name = "isJira", Value = "true", Key = "Query Params".
  • Fila 2: Name = "summary", Value = "Fix this", Key = "Query Params".

Búsqueda con Palabras​

  • Qué hace: Divide una frase en palabras para buscar (por ejemplo, "arreglar error" se convierte en "arreglar" y "error").
  • Cómo configurarlo: En la tabla "Params":
    • Añade: Name = "phrase", Value = "tus palabras aquí", Key = "Query Params".

Ejemplo: Name = "phrase", Value = "rain forecast", Key = "Query Params".

¿Qué Sucede Cuando Se Ejecuta?​

  1. El bot envía tu mensaje a la Url con el Method que elegiste.
  2. Espera una respuesta (como "¡Tarea creada!" o "Aquí está el clima").
  3. El "Javascript function body" decide qué guardar de la respuesta.
  4. Si funciona (por ejemplo, "200" o "201" en la ventana de Test), el bot pasa al siguiente paso. Si no, verás un error.

Consejos para Solucionar Problemas​

  • ¿No puedes guardar? Completa Name, Url, Method y BODY—son obligatorios (BODY puede ser {}).
  • ¿La prueba falla? Verifica que la Url sea correcta y que el servicio esté en línea. Guarda los cambios primero si editaste algo.
  • ¿Respuesta extraña? Asegúrate de que Params y BODY coincidan con lo que espera el servicio—pide ayuda a tu administrador.

¡Eso es todo! Has configurado un Conector para vincular tu bot con otras herramientas. Completa la ventana emergente, pruébala y guárdala para ver tu bot en acción. Si estás atascado, ¡tu administrador está a solo un paso de distancia!