Saltearse al contenido
Nappai Documentation

Meet

Este componente te permite interactuar directamente con tu cuenta de Google Meet. Es ideal para obtener información sobre tus reuniones, gestionar conferencias o consultar tu calendario de citas en el flujo de automatización de Nappai. Funciona como un puente entre tu dashboard y la API de Google, permitiendo que tus flujos de trabajo accedan a datos en tiempo real de tus videoconferencias.

¿Cómo funciona?

El componente se conecta a la plataforma de Google Meet utilizando una credencial de acceso segura. Una vez configurado, puedes utilizarlo para realizar acciones específicas según lo que necesites (consultar una reunión, obtener detalles, etc.).

Internamente, el componente recibe los datos que tú le proporcionas (como el ID de la reunión o el ID de tu calendario) y envía una solicitud a Google. Luego, procesa la respuesta y te devuelve la información estructurada para que puedas usarla en los siguientes pasos de tu flujo.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio de Google Meet:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Google Meet y guarda los campos requeridos:
    • Select Project
    • Client Id (Google Cloud Project Client Id)
    • Client Secret (Google Cloud Project Client Secret)
    • Google Meet access
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo Credential de este componente.

Entradas

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Operation: Selecciona el tipo de operación principal que deseas ejecutar en este nodo.

    • Visible en: Todas las operaciones configuradas

  • Input Type: Define el tipo de entrada a utilizar. Si seleccionas “Id”, el input será el identificador directo del calendario; si seleccionas “Selection”, el input será una selección específica.

    • Visible en: Todas las operaciones configuradas

  • Calendar Id: Introduce el ID de tu calendario de Google. Si no se proporciona, se utilizará el calendario principal por defecto.

    • Visible en: Operaciones de consulta de calendario

  • Calendar Selection: Permite seleccionar el calendario específico de tu cuenta de Google Calendar desde el que deseas obtener la información.

    • Visible en: Operaciones de consulta de calendario

  • Conference ID: Ingresa el ID de la conferencia de tu reunión de Google Meet. En operaciones de consulta, si no se proporciona, se devolverán todas las conferencias disponibles.

    • Visible en: Operaciones de gestión de reuniones

  • Start: Especifica la hora de inicio del rango de tiempo a consultar, en formato ‘YYYY-MM-DD HH:MM:SS AM/PM TZ’.

    • Visible en: Operaciones de consulta por rango

  • End: Especifica la hora de fin del rango de tiempo a consultar, en formato ‘YYYY-MM-DD HH:MM:SS AM/PM TZ’.

    • Visible en: Operaciones de consulta por rango

  • Limit: Define el número máximo de resultados que deseas recibir en la respuesta. El valor predeterminado es 10.

    • Visible en: Operaciones de consulta de lista

Salidas

Este componente produce la siguiente salida principal:

  • Data: Contiene la información completa y estructurada devuelta por Google Meet o Google Calendar después de ejecutar la operación. Esta salida es un objeto (JSON) que puedes mapear en componentes posteriores para leer datos específicos (como el estado de la reunión, hora de inicio, participantes, etc.).

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de cómo se ve la salida Data cuando el componente se ejecuta correctamente con una consulta de reunión: json { “conference_id”: “meet-abc123xyz”, “start_time”: “2023-10-27 10:00:00 AM UTC”, “end_time”: “2023-10-27 11:00:00 AM UTC”, “status”: “active”, “link”: “https://meet.google.com/abc-xyz-123”, “participants”: [ “usuario@empresa.com” ] }

Conectividad

Este componente suele conectarse a la salida del nodo Credential para autenticarse. Posteriormente, su salida Data se conecta típicamente a otros componentes que necesiten procesar información de las reuniones, como:

  • Componentes de Notificación: Para enviar alertas basadas en el estado de una reunión.
  • Base de Datos: Para registrar la historia de tus conferencias.
  • Filtros/Lógica: Para tomar decisiones en el flujo (ej. si la reunión está activa, enviar un correo).

Ejemplo de Uso

Imagina que necesitas verificar si una reunión de Google Meet está activa y obtener su enlace para compartirlo con tu equipo.

  1. Añade el componente Meet a tu flujo.
  2. Selecciona tu credencial de Google Meet configurada.
  3. En el campo Operation, elige la opción de consulta de reunión.
  4. En el campo Conference ID, ingresa el ID de la reunión específica.
  5. Conecta la salida Data a un componente de “Enviar Correo” para leer los datos y extraer el enlace de la reunión.

Consejos y Mejores Prácticas

  • Formato de Fechas: Al usar los campos Start y End, asegúrate de seguir estrictamente el formato de fecha y hora solicitado (YYYY-MM-DD HH:MM:SS AM/PM TZ) para evitar errores en la consulta.
  • IDs vs Selección: Usa Calendar Id si conoces el identificador específico de un calendario secundario. Si trabajas con el calendario principal, puedes dejar el campo vacío o usar Calendar Selection si está disponible en tu flujo.
  • Límite de Resultados: Utiliza el campo Limit si esperas obtener muchas conferencias y quieres optimizar el rendimiento de tu flujo, evitando recibir datos innecesarios.

Consideraciones de Seguridad

  • Protección de Credenciales: Asegúrate de no compartir las credenciales (Client Id y Client Secret) en público. En Nappai, estas se almacenan de forma segura en tu panel.
  • Acceso a Datos: El componente solo podrá acceder a la información de las reuniones a las que tu cuenta de Google Meet tenga permisos de visualización.