A conexão com o Gmail é feita pelo login Google (OAuth): você entra com a sua conta e
autoriza as permissões na tela de consentimento do próprio Google. Nenhuma senha é digitada
na Toca. A integração pode estar em liberação gradual: se o card não aparecer para a sua conta em Configurações → Integrações, fale com o suporte.
Antes de começar
- Tenha em mãos a conta Google da caixa de entrada que você quer usar. A conexão é com uma conta por vez.
- Saiba que a Toca sabe preparar rascunho, responder e enviar e-mail — mas nada sai da sua caixa sem você aprovar. Rascunho, resposta e envio passam, cada um, por uma aprovação sua dentro do chat.
- O consentimento do Google é por integração: conectar o Gmail não autoriza as outras integrações Google. Cada uma tem o próprio card e o próprio pedido de permissão.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Gmail e clique no botão de conexão.
- Na tela do Google, escolha a conta da caixa de entrada e autorize as permissões solicitadas.
- Ao voltar para a Toca, o card fica marcado como conectado e a Toca já consegue consultar seus e-mails.
O que a Toca acessa
Com a conexão ativa, a Toca busca e lê e-mails e conversas da sua caixa de entrada, vê o que está sem resposta e organiza mensagens por marcador. A permissão pedida cobre leitura e escrita, mas não a exclusão permanente de mensagens — o máximo que a Toca sabe fazer é mover para a lixeira, e mesmo isso só com a sua aprovação.
Enviar e-mail é um ato sério, e o fluxo trata assim: todo rascunho, resposta e envio só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat — você vê o destinatário e o conteúdo antes de aprovar. O conteúdo de um e-mail recebido também nunca autoriza uma ação: se uma mensagem lida pedir algo, isso vira no máximo uma proposta no chat, que depende da sua aprovação como qualquer outra.
Manutenção da conexão
A conexão usa tokens que a Toca renova automaticamente: ela permanece ativa até você
desconectar a integração na Toca ou revogar o acesso nas configurações da sua conta Google.
Se o acesso for revogado no Google, as consultas param de funcionar e é preciso refazer a
conexão pelo card em Configurações → Integrações.
Problemas comuns
- Aviso de app não verificado na tela do Google — enquanto a verificação do app junto ao Google estiver em andamento, a tela de consentimento pode exibir um aviso de app não verificado. Se tiver dúvida sobre como prosseguir, fale com o suporte.
- O envio não aconteceu — todo envio exige a sua aprovação no chat. Se o pedido de aprovação expirar sem resposta, nada é enviado; peça de novo e aprove o card.
- A busca não acha o e-mail — a Toca usa a mesma sintaxe da busca do Gmail (
from:,subject:,is:unread, recortes por data). Descreva remetente, assunto ou período; para a lista completa de operadores, confirme na documentação oficial do Google. - Conectei a conta errada — desconecte a integração na Toca e refaça a conexão escolhendo a conta certa na tela do Google.