Skip to main content
Conecte seu app ao Gmail para enviar, ler e gerenciar emails, usando uma conta compartilhada ou a caixa de entrada de cada pessoa.
Você precisa de um Builder plan ou superior para usar conectores no seu app.

​
O que você pode fazer

Leve as tarefas de email para os fluxos do seu app.

Enviar emails automaticamente

Envie confirmações, alertas e follow-ups personalizados quando algo acontecer no seu app.

Ler emails recebidos

Leia e analise as mensagens que chegam e transforme-as em registros, como tickets de suporte.

Gerenciar a caixa de entrada

Organize os emails conforme seu app os processa, por exemplo marcando mensagens como lidas ou aplicando marcadores.
Prompts de exemplo Descreva no chat de IA o assunto, o corpo da mensagem, a formatação, os destinatários e os campos dinâmicos. Por exemplo:

​
Conectando o Gmail

Conecte o Gmail para que seu app possa enviar e ler emails.
Você conecta uma conta uma única vez, e todos que usam seu app compartilham essa conexão e os dados dela.Para adicionar um conector compartilhado do Gmail:
  1. Clique em Connectors na barra lateral do seu workspace.
  2. Clique em Add connector.
  3. Pesquise Gmail e clique no resultado.
  4. Selecione Shared connector e clique em Next.
  5. Insira um Connection name.
  6. Em Who can access, selecione onde a conexão pode ser usada. O padrão é Apps and Super agent.
  7. Em Permissions, selecione Read-only ou Read & write. O padrão é Read-only.
  8. Clique em Add connector e entre com a conta do Gmail que você quer compartilhar.

​
Escopos e permissões

Os escopos controlam o que seu app pode fazer no Gmail. Você os escolhe ao configurar um conector de usuário do app. Em um conector compartilhado, você seleciona Read-only ou Read & write.
1

A Base44 adiciona

  • email: Identifica a conta do Google. Aparece em Always included.
2

Você configura

Em Scopes, estes vêm selecionados por padrão. Remova os que seu app não precisa. Os nomes dos escopos do Gmail começam com https://www.googleapis.com/auth/:
  • gmail.compose: Criar e atualizar rascunhos
  • gmail.labels: Gerenciar marcadores
  • gmail.modify: Marcar como lido ou aplicar marcadores
  • gmail.readonly: Ler mensagens e metadados
  • gmail.send: Enviar mensagens
  • Em Additional scopes, gmail.settings.basic vem preenchido para gerenciar filtros, assinaturas e a resposta automática de férias.
Acesso: Seu app trabalha com os emails da conta do Gmail que autoriza a conexão.
Ler o conteúdo de emails é um escopo restricted do Google. Veja como o Google agrupa esses escopos antes de colocar seu app no ar.

​
Usando o Gmail em uma função de backend

Depois que o Gmail está conectado, suas funções de backend podem obter um token de acesso e chamar a Gmail API diretamente. A Base44 cuida do fluxo OAuth e do armazenamento do token.
  • Em uma conexão compartilhada, use getConnection() para obter o token.
  • Em uma conexão de usuário do app, use getCurrentAppUserConnection() para que cada requisição use o token da pessoa conectada.

Conectores compartilhados

Configure, implante e chame uma conexão compartilhada a partir de uma função de backend.

Conectores de usuário do app

Obtenha um token por usuário e chame a API como a pessoa conectada.

​
Solução de problemas

Verifique o acesso da conta se as pessoas não conseguirem conectar o Gmail.
Se seu app OAuth do Google estiver em modo de teste, somente os usuários de teste aprovados podem se conectar. Publique ou tire seu app OAuth do modo de teste para que qualquer pessoa que use seu app possa conectar a própria conta.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.