Saltar para o conteúdo principal

Ligar Contas de Email

O Campbooks liga-se ao seu fornecedor de email via OAuth — nunca vê a sua palavra-passe, e o token de atualização que armazena é encriptado em repouso. Suporta Zoho Mail, Google Workspace (Gmail) e Microsoft 365.

O calendário vem incluído. Ao ligar uma caixa de correio Google ou Zoho, são solicitados âmbitos de calendário na mesma autorização, pelo que o calendário sincroniza automaticamente — não há um fluxo de ligação de calendário separado. Consulte Calendário.

Fornecedores suportados​

FornecedorAPIConsolaCallback de email
Zoho MailZoho Mail REST APIZoho API Console/oauth/zoho/callback
Google WorkspaceGmail APIGoogle Cloud Console/oauth/gmail/callback
Microsoft 365Microsoft GraphCentro de administração do Entra/oauth/microsoft/callback

Coloque cada URL de callback na lista de permissões como <url-da-sua-aplicação>/oauth/<fornecedor>/callback — por exemplo, http://localhost:3000/oauth/gmail/callback localmente, ou https://app.example.com/oauth/gmail/callback em produção.

Zoho Mail​

1. Criar um cliente Zoho API​

  1. Aceda à Zoho API Console.
  2. Crie uma nova Server-based Application.
  3. Adicione o URI de redirecionamento: <url-da-sua-aplicação>/oauth/zoho/callback.
  4. Anote o seu Client ID e Client Secret.

2. Configurar variáveis de ambiente​

ZOHO_CLIENT_ID=your_client_id
ZOHO_CLIENT_SECRET=your_client_secret
ZOHO_REGION=eu   # eu | com | in | au | jp — corresponda ao seu centro de dados Zoho

3. Ligar no Campbooks​

  1. Aceda a Definições → Contas de Email e clique em Adicionar Conta de Email.
  2. Escolha Zoho Mail e autorize a ligação no Zoho.
  3. Após a autorização, o Campbooks armazena um token de atualização encriptado e inicia a primeira digitalização.

Google Workspace (Gmail)​

1. Criar um projeto Google Cloud​

  1. Aceda à Google Cloud Console e crie um projeto.
  2. Ative a Gmail API e a Google Calendar API.
  3. Crie credenciais OAuth 2.0 (tipo: Web application).
  4. Adicione o URI de redirecionamento: <url-da-sua-aplicação>/oauth/gmail/callback.

2. Configurar variáveis de ambiente​

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret

3. Ligar no Campbooks​

  1. Aceda a Definições → Contas de Email e clique em Adicionar Conta de Email.
  2. Escolha Google Workspace e autorize através do ecrã de consentimento do Google.

A ligação Gmail e a integração interativa Enviar para o Drive são aplicações Google separadas — o Drive usa o âmbito restrito drive completo do Google e tem o seu próprio /oauth/google/callback. Consulte Google Drive.

Microsoft 365​

1. Registar uma aplicação Entra​

  1. Aceda ao centro de administração do Entra → Registos de aplicações → Novo registo.
  2. Tipos de conta suportados: Contas em qualquer diretório organizacional (contas profissionais/escolares — a aplicação usa o endpoint /organizations/).
  3. Adicione um URI de redirecionamento Web: <url-da-sua-aplicação>/oauth/microsoft/callback.
  4. Crie um segredo de cliente.

2. Configurar variáveis de ambiente​

MICROSOFT_CLIENT_ID=your_client_id
MICROSOFT_CLIENT_SECRET=your_client_secret
ENABLE_MICROSOFT_MAILBOX=1   # revela o botão "Ligar Microsoft 365"

3. Ligar no Campbooks​

  1. Aceda a Definições → Contas de Email e clique em Adicionar Conta de Email.
  2. Escolha Microsoft 365 e autorize através do ecrã de consentimento da Microsoft.

Partilhar contas​

Uma caixa de correio ligada pode ser partilhada com outras pessoas do seu espaço de trabalho com permissões de visualização ou envio por utilizador, para que uma equipa possa trabalhar uma caixa de entrada sem partilhar uma palavra-passe. Todas as superfícies — a aplicação web, o Scout e os fluxos de trabalho — aplicam o mesmo controlo de permissões.

Após ligar​

Uma vez ligada uma conta, o Campbooks mantém-na sincronizada automaticamente. Consulte Digitalização de Email para saber como funcionam a digitalização e o processamento.

Última atualização em