Saltar al contenido principal
¡Hola! En esta guia aprenderás como conectar Treble con Google Sheets para actualizar y obtener variables desde una hoja de cálculo de Google. Esta integración te permite automatizar la gestión de datos de tus conversaciones en Treble usando una hoja de Google Sheets como base de datos.

​
Activar la integracion

  1. Crea una hoja de cálculo en Google Sheets. Recomendado: déjala con permiso público para editar.
Si prefieres mantenerla privada, más abajo encontrarás las instrucciones para hacerlo.
  1. En el Editor de Flujos de Conversación de Treble, haz click en el ícono del rompecabezas .
  2. Selecciona la opción Google Sheets.
  3. Pega la URL de tu hoja de cálculo en el campo de texto.
Activar integración sheets

​
Formato requerido en la hoja

Esta integración requiere que tu hoja de cálculo tenga las siguientes dos columnas en la primera fila: country_code y cellphone que se usan para identificar a cada usuario. Las siguientes columnas se usan para obtener o guardar información sobre ese usuario.
Hay una tercera columna opcional, business_scope_id, para los contactos que escriben sin compartir su número de teléfono. Ver contactos sin número de teléfono más abajo.
Formato hoja sheets

​
Consultar variables desde Sheets

Para obtener una variable desde la hoja de cálculo, debes usar el siguiente formato dentro de la conversación: sheets_nombre_variable Por ejemplo, si tienes una columna name, puedes usar la variable sheets_name para saludar al usuario:
Consultar variable sheets

​
Guardar respuestas en Sheets

Para guardar lo que el usuario responde en la conversación, usa el mismo formato de variable sheets_nombre_variable, y marca la opción “Guardar respuesta como variable” en el flujo. Guardar variable sheets

​
Guardar la hora de la respuesta

Si quieres registrar cuándo se guardó una respuesta, crea otra columna con el prefijo time_ Por ejemplo:
  • Si tienes la variable name, crea otra columna llamada time_name.
Treble guardará automáticamnete la fecha y hora cuando el usuario responda. Guardar hora respuesta sheets

​
Hojas con permisos restringidos

Si no quieres que tu hoja sea pública, debes compartirla con los tres correos oficiales de Treble:
Guardar hora respuesta sheets

​
Contactos sin número de teléfono

Desde que WhatsApp permite escribir usando un nombre de usuario, hay contactos que llegan sin número de teléfono. Para esos casos Meta entrega un identificador llamado BSUID, y la integración con Sheets lo soporta. La regla es simple: si hay número de teléfono, se identifica la fila por el teléfono; si no lo hay, se identifica por el BSUID.

​
Cómo funciona

  • Treble busca en tu hoja una columna llamada exactamente business_scope_id.
  • Si no existe, Treble la crea automáticamente la primera vez que llega un contacto sin número. No tienes que preparar nada por adelantado.
  • Una fila se considera válida si tiene teléfono o BSUID. Las filas sin ninguno de los dos se tratan como vacías.
  • Al agregar un contacto identificado solo por BSUID, las celdas country_code y cellphone quedan vacías y se llena business_scope_id.
Si Treble no puede crear la columna —por ejemplo, porque la hoja está compartida solo como lectura— el contacto no se agrega y la fila se omite.Si esperas contactos sin número, crea tú mismo la columna business_scope_id y confirma que las cuentas de servicio tengan permiso de edición (ver hojas con permisos restringidos).
El nombre de la columna debe ser exactamente business_scope_id, en minúsculas.

Nombres de usuario y BSUID en WhatsApp

​
Limitaciones

  • Máximo de columnas soportadas: hasta la columna ZZ.
  • Límites de velocidad rate limit de Google Sheets:
    • G Suite: 5 solicitudes por segundo
    • Gmail normal: 1 solicitud por segundo
Si se superan esos límites, es posible que algunos datos se pierdan.