Saltar para o conteúdo principal
Olá! Neste guia você aprenderá como conectar o Treble com o Google Sheets para atualizar e obter variáveis de uma planilha do Google. Esta integração permite automatizar o gerenciamento de dados das suas conversas no Treble usando uma planilha do Google Sheets como banco de dados.

​
Ativar a integração

  1. Crie uma planilha no Google Sheets. Recomendado: deixe com permissão pública para editar.
Se preferir mantê-la privada, você encontrará as instruções para fazer isso abaixo.
  1. No Editor de Fluxos de Conversa do Treble, clique no ícone do quebra-cabeças .
  2. Selecione a opção Google Sheets.
  3. Cole a URL da sua planilha no campo de texto.
Ativar integração sheets

​
Formato exigido na planilha

Esta integração exige que sua planilha tenha as seguintes duas colunas na primeira linha: country_code e cellphone que são usadas para identificar cada usuário. As colunas seguintes são usadas para obter ou salvar informações sobre esse usuário.
Existe uma terceira coluna opcional, business_scope_id, para contatos que escrevem sem compartilhar o número de telefone. Veja contatos sem número de telefone abaixo.
Formato planilha sheets

​
Consultar variáveis da Sheets

Para obter uma variável da planilha, você deve usar o seguinte formato dentro da conversa: sheets_nombre_variable Por exemplo, se você tem uma coluna name, pode usar a variável sheets_name para cumprimentar o usuário:
Consultar variável sheets

​
Salvar respostas na Sheets

Para salvar o que o usuário responde na conversa, use o mesmo formato de variável sheets_nombre_variable, e marque a opção “Salvar resposta como variável” no fluxo. Salvar variável sheets

​
Salvar o horário da resposta

Se quiser registrar quando uma resposta foi salva, crie outra coluna com o prefixo time_ Por exemplo:
  • Se você tem a variável name, crie outra coluna chamada time_name.
O Treble salvará automaticamente a data e hora quando o usuário responder. Salvar horário resposta sheets

​
Planilhas com permissões restritas

Se não quiser que sua planilha seja pública, você deve compartilhá-la com os três endereços de email oficiais do Treble:
Salvar horário resposta sheets

​
Contatos sem número de telefone

Desde que o WhatsApp passou a permitir que as pessoas escrevam usando um nome de usuário, alguns contatos chegam sem número de telefone. Para esses casos a Meta fornece um identificador chamado BSUID, e a integração com o Sheets tem suporte a ele. A regra é simples: se houver número de telefone, a linha é identificada pelo telefone; quando não houver, é identificada pelo BSUID.

​
Como funciona

  • A Treble procura na sua planilha uma coluna chamada exatamente business_scope_id.
  • Se ela não existir, a Treble a cria automaticamente na primeira vez que chega um contato sem número. Não é preciso preparar nada com antecedência.
  • Uma linha é considerada válida se tiver telefone ou BSUID. Linhas sem nenhum dos dois são tratadas como vazias.
  • Ao adicionar um contato identificado apenas por BSUID, as células country_code e cellphone ficam vazias e business_scope_id é preenchida.
Se a Treble não conseguir criar a coluna — por exemplo, porque a planilha está compartilhada apenas como leitura — o contato não é adicionado e a linha é ignorada.Se você espera contatos sem número, crie você mesmo a coluna business_scope_id e confirme que as contas de serviço têm permissão de edição (veja planilhas com permissões restritas).
O nome da coluna deve ser exatamente business_scope_id, em minúsculas.

Nomes de usuário e BSUID no WhatsApp

​
Limitações

  • Máximo de colunas suportadas: até a coluna ZZ.
  • Limites de velocidade (rate limit) do Google Sheets:
    • G Suite: 5 solicitações por segundo
    • Gmail normal: 1 solicitação por segundo
Se esses limites forem excedidos, alguns dados podem ser perdidos.