Conectando o Gmail ao seu app

Conecte seu app Base44 ao Gmail para enviar, ler e gerenciar emails. Use o Gmail para entregar alertas, aprovações e relatórios, transformar mensagens recebidas em registros no seu app e disparar fluxos quando um novo email chega, a partir de uma conta compartilhada ou da caixa de entrada de cada pessoa.

Qual tipo usar? Use um conector para criadores de apps quando seu app envia email de uma única conta do Gmail para todos, por exemplo uma caixa de operações que envia relatórios semanais. Use um conector para usuários do app quando cada pessoa envia email da própria conta do Gmail.

Você precisa do Builder plan ou superior para usar conectores no seu app.

O que você pode fazer

Envie emails automaticamente

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

Leia emails recebidos

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

Gerencie a caixa de entrada

Organize os emails conforme seu app os processa, por exemplo marcando mensagens como lidas ou aplicando marcadores.

Prompts de exemplo para o AI chat

Envie emails de confirmação automáticos quando um novo pedido for feito.

Leia e interprete emails recebidos para criar tickets de suporte.

Dispare um fluxo de trabalho automaticamente quando um novo email chegar.

Envie emails de follow-up personalizados para novos leads.

Notifique membros do time por email quando tarefas forem atribuídas.

Visão rápida

Identificador de tipo

gmail

Modelo de autenticação

OAuth

Tipos de conector

Para criadores de apps, Para usuários do app

Configuração da conexão

Nenhuma

Guia de permissões

Escopos e permissões do Gmail

Como conectar

Para criadores de apps
Para usuários do app

Conecte uma conta do Gmail que todos os fluxos do seu app usam.Para conectar o Gmail:

Vá para o editor do seu app.
Descreva no AI chat o que você quer fazer com o Gmail, por exemplo: Conecte este app ao Gmail e me envie um email quando um novo ticket for criado.
Revise o que o AI chat solicita em We need your permission to access.
Clique em Connect to Gmail.
Na janela do Google, selecione a conta que você quer conectar, revise as permissões e clique em Allow.
Volte ao editor e deixe a IA terminar de criar os fluxos que usam o Gmail.

Deixe cada pessoa que usa seu app conectar a própria conta do Gmail. Um admin configura o conector uma vez no nível do workspace, pelas configurações do workspace ou pelo AI chat. Depois, cada pessoa conecta a própria conta dentro do seu app.

Trate seu Client Secret como uma senha. Não o compartilhe nem o inclua em capturas de tela. Insira-o apenas quando a Base44 pedir durante a configuração.

Prepare seu conector

Configure um app OAuth do Google e reúna os detalhes dele antes de adicionar o conector na Base44.Para preparar seu conector:

Crie um app OAuth do Google no Google Cloud para obter um Client ID e um Client Secret.
Anote os escopos que seu app precisa. Veja Escopos e permissões do Gmail.
Registre suas redirect URIs no app OAuth. Veja o card abaixo.

Registre sua callback URL

Registre esta callback URL no seu app OAuth do Google. Ela funciona para todos os apps do seu workspace, incluindo as URLs live, de preview, de compartilhamento e de domínio personalizado:https://connectors.base44.com/api/oauth/callbackSe você configurou este conector antes de a Base44 migrar para uma callback URL única, ele ainda usa uma URI separada para cada host de app. Abra Workspace Settings → Connectors, clique em View redirect URIs for your apps em Connectors For App Users, selecione seu app e registre todas as URIs listadas em Per-app URLs (for legacy connectors).

Adicione o conector

Para adicionar o conector:

Clique no nome do seu workspace no canto inferior esquerdo.
Clique em Settings.
Clique em Connectors em Plugins.
Em Connectors For App Users, clique em Add Connector.
Clique em Gmail.
Nos detalhes do conector, clique em Add Connector.
Insira um Connector name e depois o Client ID e o Client Secret do seu app OAuth do Google.
Em Scopes, abra a lista de escopos sugeridos e selecione os que seu app precisa. Use Additional scopes apenas para escopos que não estão na lista.
Clique em Add Connector.

Deixe as pessoas conectarem

Cada pessoa conecta a própria conta do Gmail dentro do seu app. Peça ao AI chat para adicionar um recurso em que as pessoas entram com o Gmail. Depois, cada uma conecta a própria conta ao usá-lo.

Usando em uma backend function

Depois que o Gmail está conectado, suas backend functions podem obter um access token e chamar a API do Gmail diretamente. A Base44 cuida do fluxo OAuth e do armazenamento de tokens.

Para uma conexão compartilhada, use getConnection() para obter o token.
Para uma conexão de usuário do app, use getCurrentAppUserConnection() para que cada requisição use o token da pessoa conectada.

// Shared connection: one account the whole app uses
const connection = await base44.asServiceRole.connectors.getConnection("gmail");
// Use the connection's access token to call the Gmail API.

Shared connectors

Configure, faça deploy e chame uma conexão compartilhada a partir de uma backend function.

App user connectors

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

Escopos e permissões do Gmail

Quando você conecta o Gmail, o conector solicita permissões (escopos) que controlam o que seu app pode fazer com sua conta do Gmail. Abaixo está a lista atual de escopos do Gmail que o conector pode solicitar.

Escopos do Gmail

email: Identificar a conta do Google que está sendo conectada.
https://www.googleapis.com/auth/gmail.readonly: Ler mensagens e metadados.
https://www.googleapis.com/auth/gmail.send: Enviar mensagens.
https://www.googleapis.com/auth/gmail.labels: Gerenciar marcadores.
https://www.googleapis.com/auth/gmail.modify: Modificar mensagens, por exemplo marcar como lida ou aplicar um marcador.
https://www.googleapis.com/auth/gmail.compose: Criar e atualizar rascunhos.
https://www.googleapis.com/auth/gmail.settings.basic: Gerenciar configurações básicas de email, como filtros, assinaturas e a resposta automática de férias.

As listas de escopos podem mudar com o tempo. Sempre revise as permissões mostradas durante o fluxo de conexão.

Solução de problemas

A conexão falha com um erro de redirect URI

Confira se https://connectors.base44.com/api/oauth/callback está registrada no seu app OAuth do Google, exatamente como mostrada. Se o conector ainda usa URLs por app, a URI no seu app OAuth deve corresponder a uma das mostradas em Per-app URLs (for legacy connectors) em View redirect URIs for your apps. Nesse caso, registre todas as URIs listadas lá para o app que você está conectando.

Algumas pessoas não conseguem conectar a conta

Se seu app OAuth do Google está em modo de teste, apenas usuários de teste aprovados podem 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.

Perguntas frequentes

Como mudo qual conta do Gmail está conectada?

Vá para o dashboard do seu app.
Clique em Integrations.
Clique na aba My integrations.
Encontre Gmail, clique no ícone More Actions e depois em Switch account.

Posso personalizar o conteúdo dos emails enviados do meu app?

Sim. No AI chat, especifique o assunto, o corpo da mensagem, a formatação, os destinatários e quaisquer campos dinâmicos.Você também pode editar as backend functions geradas em Dashboard → Code → Functions para personalizar ainda mais o conteúdo do email.

Cada pessoa que usa meu app pode enviar da própria caixa do Gmail?

Sim. Use um conector para usuários do app para que cada pessoa conecte a própria conta do Gmail. Veja a visão geral dos conectores.

Como gerencio o conector do Gmail no meu app?

Clique no ícone More actions no conector na aba Integrations do seu app e escolha uma opção, como trocar de conta, reconectar ou desconectar. Saiba mais sobre como gerenciar conectores.

Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.

Começando

Superagentes

Criando seu app

Protegendo seu app

Promovendo seu app

Conectores

Integrações

O que você pode fazer

Envie emails automaticamente

Leia emails recebidos

Gerencie a caixa de entrada

Visão rápida

Como conectar

Prepare seu conector

Registre sua callback URL

Adicione o conector

Deixe as pessoas conectarem

Usando em uma backend function

Shared connectors

App user connectors

Escopos e permissões do Gmail

Escopos do Gmail

Solução de problemas

Perguntas frequentes

​O que você pode fazer

Envie emails automaticamente

Leia emails recebidos

Gerencie a caixa de entrada

​Visão rápida

​Como conectar

​Prepare seu conector

Registre sua callback URL

​Adicione o conector

​Deixe as pessoas conectarem

​Usando em uma backend function

Shared connectors

App user connectors

​Escopos e permissões do Gmail

Escopos do Gmail

​Solução de problemas

​Perguntas frequentes

O que você pode fazer

Visão rápida

Como conectar

Prepare seu conector

Adicione o conector

Deixe as pessoas conectarem

Usando em uma backend function

Escopos e permissões do Gmail

Solução de problemas

Perguntas frequentes