> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Perguntas Frequentes

> Aqui estão algumas das perguntas mais frequentes e suas respostas sobre nossa integração com Google Sheets.

### **Como salvar um registro diferente para cada conversa?**

* Adicione uma coluna chamada `treble_session_id`. Isso permite que cada conversa seja salva como um registro separado.

### **Como a informação chega à planilha?**

Quando um cliente responde, a planilha atualiza automaticamente a coluna que corresponde ao nome da variável.

* Se a pergunta for **aberta**, o texto digitado pelo usuário é salvo.
* Se a pergunta for **fechada**, a opção escolhida é salva.

> 💡 Se uma coluna com o mesmo nome da variável não existir, não será atualizada.

### **E se o contato não estiver na planilha?**

Se o número do cliente **não existir**, ele será adicionado na **primeira linha vazia disponível**.\
Certifique-se de sempre ter linhas vazias no final do documento.

### **Funciona em conversas inbound?**

Sim. Enquanto a planilha tiver o formato e as permissões corretos, também funciona para mensagens **inbound** recebidas.

### **Como devo escrever o `country_code`?**

É aceito com ou sem o sinal **+**:

Exemplo: `+57` ou `57`

### **Por que o valor não está sendo salvo na Sheets?**

As causas mais comuns são:

1. **O usuário existe, mas a coluna não corresponde.**\
   Verifique se o nome da coluna é exatamente o mesmo da variável.

2. **O usuário não existe e não há espaço.**\
   O Google Sheets tem um limite inicial de **1000 linhas**.\
   Se você atingir o limite, precisa adicionar mais linhas manualmente.

> ⚠️ **Importante:**\
> As colunas `country_code` e `cellphone` devem sempre existir.

### **Variável inbound**

* Não inclua o prefixo `sheets_` no nome.
* Só funciona para **mensagens de texto recebidas**, não para arquivos ou mídia.

### **Dicas finais**

* Use nomes de colunas **curtos e claros**.
* Mantenha sua planilha organizada (sem linhas vazias entre contatos).
* Verifique as permissões antes de testar a integração.