> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # Conectando o Outlook ao seu app > Envie e leia emails e gerencie eventos da agenda pelo seu app, usando uma conta compartilhada ou a conta de cada pessoa. Conecte seu app ao Outlook para enviar e ler emails, gerenciar eventos da agenda e executar fluxos de trabalho quando um email ou evento mudar. Use uma conta compartilhada para todo o app ou deixe cada pessoa conectar a própria conta Microsoft. > [!NOTE] > > Você precisa de um [plano Builder](https://base44.com/pricing) ou superior para usar conectores no seu app. *** ## O que você pode fazer Traga seus emails e sua agenda do Outlook para os fluxos de trabalho do seu app. > [card] Enviar emails > > Envie emails pela sua conta do Outlook quando algo acontecer no seu app, como uma nova reserva. > [card] Ler e organizar emails > > Leia mensagens recentes, resuma-as e mova ou atualize-as pelo seu app. > [card] Gerenciar sua agenda > > Mostre seus eventos do Outlook no seu app e crie ou atualize eventos quando algo for agendado. > [card] [Executar fluxos de trabalho](https://docs.base44.com/pt-BR/Building-your-app/Creating-workflows.md#connector) > > Inicie um fluxo de trabalho quando um email chegar na sua caixa de entrada ou quando um evento da agenda for criado, atualizado ou excluído. **Prompts de exemplo** Descreva no chat de IA a caixa de correio ou a agenda, o que dispara a ação e os campos dinâmicos. Por exemplo: ```text wrap theme={null} Envie emails do meu app usando o Outlook. ``` ```text wrap theme={null} Mostre os eventos da minha agenda do Outlook no painel. ``` ```text wrap theme={null} Crie eventos na agenda do Outlook quando algo for agendado no meu app. ``` ```text wrap theme={null} Leia os emails recentes do Outlook e resuma-os. ``` > [!TIP] > > Quer que seu Superagent participe das suas reuniões do Outlook e faça anotações? Veja [Conectando sua agenda](https://docs.base44.com/pt-BR/superagents/meeting-notes.md#connecting-your-calendar). *** ## Conectando o Outlook Escolha como as pessoas se conectam: uma conta compartilhada para todo o app ou a conta de cada pessoa. > [tab] Conector compartilhado > > Conecte uma conta, e todos que usam seu app compartilham essa conta e os dados dela. > > **Para adicionar um conector compartilhado do Outlook:** > > 1. Clique em **Conectores** na barra lateral do seu workspace. > > 2. Clique em **Adicionar conector**. > > 3. Pesquise **Outlook** e clique no resultado. > > 4. Selecione **Conector compartilhado** e clique em **Avançar**. > > 5. Insira um **Nome da conexão**. > > 6. Em **Quem pode acessar**, escolha onde a conexão pode ser usada: **Apps e Super agent** (o padrão), **Apenas apps** ou **Super agent only**. > > 7. Em **Permissões**, escolha **Somente leitura** (o padrão), **Leitura e escrita** ou **Personalizado**. Para enviar emails, escolha **Leitura e escrita**. Saiba mais sobre [escopos e permissões](#scopes-and-permissions). > > ![Configuração do conector compartilhado do Outlook com Connection name, Who can access e as permissões Read-only selecionadas](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-shared-setup.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5638130e25a42638151162b63b297ef3) > > Configurando um conector compartilhado do Outlook > > 8. Clique em **Adicionar conector**. > > 9. Entre com a conta Microsoft que você quer compartilhar. > [tab] Conector de usuário do app > > Cada pessoa conecta a própria conta Microsoft, para que seu app possa trabalhar com os emails e a agenda dela. > > > [!TIP] > > > > **Antes de começar:** Somente donos e admins do workspace podem configurar isso. Você precisa de um registro de app da Microsoft com o Client ID e o Client Secret dele. A menos que você vá inserir um [Microsoft Tenant ID](#using-a-microsoft-tenant), defina os **Supported account types** dele como contas em qualquer diretório organizacional e contas Microsoft pessoais. Veja [Usando seu próprio cliente OAuth](https://docs.base44.com/pt-BR/Integrations/Connectors.md#using-your-own-oauth-client). > > **Para adicionar um conector de usuário do app do Outlook:** > > 1. Clique em **Conectores** na barra lateral do seu workspace. > > 2. Clique em **Adicionar conector**. > > 3. Pesquise **Outlook** e clique no resultado. > > 4. Selecione **Conector de usuário do app** e clique em **Avançar**. > > 5. Copie a **Callback URL**. > > 6. No registro do seu app da Microsoft, adicione a Callback URL às redirect URIs permitidas. > > 7. De volta ao formulário **Add Outlook Connection**, insira um **Nome do conector**, o **ID do cliente** e o **Segredo do cliente**. > > ![Formulário Add Outlook Connection com Callback URL, Connector name, Client ID e Client Secret](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-credentials.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5fb6f375d00995fabb114eb4e9dd463c) > > Inserindo as credenciais do seu app da Microsoft > > 8. (Opcional) Revise os escopos pré-selecionados em **Escopos** e remova os que seu app não precisa. > > ![Campo Scopes do Outlook com escopos bloqueados e padrão, e Additional scopes abaixo](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-scopes.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=2d9c8f72c63f63496b4f8f45aae8daf4) > > Escolhendo escopos para um conector de usuário do app > > 9. Clique em **Adicionar conector**. > > Depois, peça ao chat de IA no seu app para adicionar uma forma de as pessoas conectarem a própria conta do Outlook. *** ## Escopos e permissões Os escopos controlam o que seu app pode fazer no Outlook. Você os escolhe ao configurar um conector. > [card] > > **1. A Base44 adiciona** > > Estes escopos são sempre incluídos, então aparecem como escopos bloqueados em **Personalizado** em um conector compartilhado ou em **Escopos** em um conector de usuário do app. > > * `User.Read`: Fazer login e ler o perfil da conta que se conecta > * `offline_access`: Manter a conexão funcionando sem precisar entrar de novo > > **2. Você configura** > > Selecione os escopos de que seu app precisa em **Personalizado** em um conector compartilhado ou em **Escopos** em um conector de usuário do app. > > Em um conector compartilhado, **Somente leitura** dá ao seu app `Mail.Read` e `Calendars.Read`. **Leitura e escrita** dá `Mail.ReadWrite`, `Calendars.ReadWrite` e `Mail.Send`. > > * `Mail.Read`: Ler emails > * `Mail.ReadWrite`: Ler, criar, atualizar e excluir emails, sem enviá-los > * `Mail.Send`: Enviar emails em nome da conta > * `Calendars.Read`: Ler eventos da agenda > * `Calendars.ReadWrite`: Ler, criar, atualizar e excluir eventos da agenda > > **Acesso:** Seu app trabalha com a caixa de correio e a agenda da conta Microsoft que autoriza a conexão. ### Usando um tenant da Microsoft Em um conector de usuário do app, você pode inserir um **Microsoft Tenant ID** no formulário de configuração, em Connection Configuration. Deixe vazio para usar `common`. Se você inserir um, a configuração de tipos de conta compatíveis do registro do seu app da Microsoft não se aplica. *** ## Usando funções de backend Depois que o Outlook está conectado, suas funções de backend podem obter um token de acesso e chamar a Microsoft Graph API diretamente. A Base44 cuida do login e mantém o token atualizado para você. * 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. Chame a Microsoft Graph API em `graph.microsoft.com` e passe o token no cabeçalho `Authorization`: ```javascript theme={null} // Shared connection: one account the whole app uses const { accessToken } = await base44.asServiceRole.connectors.getConnection("outlook"); const response = await fetch( "https://graph.microsoft.com/v1.0/me/messages?$top=10", { headers: { Authorization: `Bearer ${accessToken}` } }, ); const { value: messages } = await response.json(); ``` > [card] [Conectores compartilhados](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/shared-connectors.md) > > Configure, implante e chame uma conexão compartilhada a partir de uma função de backend. > [card] [Conectores de usuário do app](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/app-user-connectors.md) > > Obtenha um token por usuário e chame a API como a pessoa conectada. *** ## Solução de problemas Verifique a conexão e os escopos dela se o Outlook parar de funcionar no seu app. > [accordion] A conexão precisa ser reconectada > > Se o acesso ao Outlook for perdido ou expirar, a conexão mostra **Esta conexão precisa ser reconectada**. Em um conector compartilhado, [reconecte-o](https://docs.base44.com/pt-BR/Integrations/Connectors.md#managing-your-connectors) e entre com a mesma conta Microsoft. Todos os apps que o usam voltam a funcionar. Em um conector de usuário do app, cada pessoa reconecta a própria conta dentro do seu app. > [accordion] Seu app não consegue enviar emails > > Seu app precisa do escopo `Mail.Send` para enviar emails. O escopo `Mail.ReadWrite` permite que seu app leia e altere mensagens, mas não que as envie. > > * Em um conector compartilhado, as permissões são definidas quando você adiciona a conexão. Clique em **Add another connector** na página do conector do Outlook e escolha **Leitura e escrita** para a nova conexão. > * Em um conector de usuário do app, abra-o na página do conector do Outlook, adicione `Mail.Send` aos escopos dele e clique em **Salvar alterações**. As pessoas que já se conectaram mantêm o acesso anterior até se conectarem de novo. > [!NOTE] > > Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.