[Extensión] Cómo enviar datos de Blip a BigQuery

1. Introducción

2. Funcionalidades

3. Requisitos previos

4. Instalación y configuración

5. Cómo llegan los datos a BigQuery

6. Soporte

Descripción breve: Envía los contactos, mensajes y eventos de tracking de tu bot de Blip a Google BigQuery y crea reportes, dashboards y análisis en tu propia infraestructura.

Introducción

La extensión BigQuery envía los datos de conversación de tu bot de Blip a un dataset en Google BigQuery. Cada vez que hay un nuevo contacto, mensaje o evento de tracking, Blip envía el registro a BigQuery, donde puedes consultarlo con SQL, cruzarlo con otras fuentes y alimentar herramientas de BI, conservando un historial propio de la operación en tu infraestructura.

Por ejemplo, una operación de atención en WhatsApp puede acumular todos los mensajes intercambiados en una tabla de BigQuery y usar estos datos para medir el tiempo de respuesta, el volumen por periodo y los temas más frecuentes, sin depender únicamente de los reportes nativos de Blip.

Funcionalidades

• Envío de contactos a la tabla contacts, con nombre, grupo, ciudad, correo electrónico, teléfono, origen, documento y campos adicionales.

• Envío de mensajes a la tabla messages, con remitente, destinatario, tipo, contenido y metadatos.

• Envío de eventos de tracking a la tabla trackings, con categoría, acción y campos adicionales.

• Creación automática del dataset y de las tablas en BigQuery al momento de la instalación.

Compatible con los siguientes canales: todos los canales disponibles en la plataforma Blip.

Requisitos previos

Antes de configurar la extensión, asegúrate de tener:

• Un proyecto activo en Google Cloud. Consulta la documentación de Google para crear un proyecto.

• La API de BigQuery habilitada en ese proyecto.

• Permiso para crear cuentas de servicio en el proyecto.

Instalación y configuración

1. Accede a BigQuery en Blip Store y haz clic en Iniciar prueba gratis.

2. Instala la extensión en el bot cuyos datos quieres enviar a BigQuery.

3. Abre el bot y accede a la extensión desde el menú de extensiones.

Crea el proyecto en Google Cloud

La extensión guarda los datos en un proyecto de Google Cloud. Si aún no tienes uno:

1. Accede a Google Cloud Console y crea un proyecto nuevo.

2. Asigna un nombre al proyecto y confirma la creación.

3. Selecciona el proyecto creado.

4. Habilita la API de BigQuery en el proyecto.

Crea la cuenta de servicio y genera la clave JSON

La extensión se autentica en BigQuery con una cuenta de servicio. Para crearla:

1. En el panel del proyecto, abre IAM y administración > Cuentas de servicio.

2. Haz clic en Crear cuenta de servicio e indica el nombre, el ID y la descripción.

3. Asigna los roles Usuario de trabajos de BigQuery y Propietario de datos de BigQuery a la cuenta. Estos roles permiten que la extensión cree el dataset, cree las tablas e inserte los registros.

4. Finaliza la creación de la cuenta.

5. Abre la cuenta creada y ve a Claves > Agregar clave > Crear clave nueva > Crear. Google genera un archivo JSON con la clave de la cuenta de servicio. Guarda este archivo en un lugar seguro y no lo compartas.

Configura la extensión en Blip

En la página de la extensión, en Blip, completa los campos:

1. Dataset: el nombre del dataset que recibirá los datos. Usa únicamente letras y guiones bajos. Si el dataset aún no existe, la extensión lo crea.

2. Ubicación: la región donde se creará el dataset. Elige US o southamerica-east1 (São Paulo). Para reducir la latencia de una operación en Brasil, usa southamerica-east1.

3. Cuenta de servicio (JSON): carga el archivo JSON generado en el paso anterior. La extensión verifica que el archivo pertenezca a una cuenta de servicio.

4. Haz clic en Guardar. La extensión crea el dataset y las tablas en BigQuery, registra el webhook en Blip y comienza a enviar los datos.

Atención: los costos de uso y almacenamiento en Google Cloud son responsabilidad de la cuenta configurada. Las cuentas gratuitas tienen límites que pueden afectar el funcionamiento de la extensión.

Cómo llegan los datos a BigQuery

Después de guardar, la extensión registra un webhook de analytics en el bot. A partir de ese momento, cada nuevo contacto, mensaje y evento de tracking se guarda en el dataset en tres tablas:

• contacts: un registro por contacto del bot.

• messages: un registro por mensaje enviado o recibido.

• trackings: un registro por evento de tracking, agrupado por categoría.

El guardado es asíncrono, por lo que puede haber un pequeño retraso entre el evento en Blip y su llegada a BigQuery. Al comparar los números con los reportes de Blip, valida la zona horaria, el periodo y los filtros utilizados en cada consulta.

Soporte

Si tienes dudas o problemas con la extensión, comunícate por correo electrónico a support@wiv.com.br.

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃