Documentação Técnica

Guia de Integração

Passo a passo para configurar a integração do Tic-Ticket com o ambiente Google Workspace ou Microsoft 365 da sua organização.

Configuração do Google Workspace

Configure uma Service Account com Domain-Wide Delegation para permitir que o Tic-Ticket gerencie contas, emails e grupos no Google Workspace da sua organização.

Pré-requisitos: Acesso de Super Admin ao Google Workspace da organização, e acesso ao Google Cloud Console (console.cloud.google.com).

Escopos/Permissões Necessários

admin.directory.user

Criar, suspender e gerenciar contas de usuários

admin.directory.group

Criar e gerenciar grupos de email

admin.directory.group.member

Adicionar e remover membros de grupos

gmail.settings.basic

Configurar mensagens de férias (out-of-office)

gmail.settings.sharing

Definir assinaturas de email dos colaboradores

Problemas Comuns

Erro "Insufficient permissions" ou "Access denied"

Google: Verifique se a Domain-Wide Delegation foi configurada correctamente com todos os escopos necessários, e se o email de admin informado é de um Super Admin do Workspace.

Microsoft: Verifique se o consentimento de administrador foi concedido para todas as permissões, e se são permissões de aplicativo (não delegadas).

Erro "Invalid credentials" ou "Authentication failed"

Google: Verifique se o JSON da Service Account está completo e correcto. Tente gerar uma nova chave.

Microsoft: Verifique se o Client Secret não expirou. Secrets têm validade de 6, 12 ou 24 meses.

Assinaturas de email não funcionam (Microsoft)

A Microsoft Graph API não suporta gestão de assinaturas de email programaticamente. Esta funcionalidade está disponível apenas para Google Workspace. Para Microsoft, use Transport Rules no Exchange Admin Center como alternativa.

Operações demoram para refletir

Tanto o Google quanto a Microsoft podem levar alguns minutos para propagar alterações (criação de contas, adição a grupos, etc.). Aguarde até 15 minutos antes de reportar um problema.

Precisa de ajuda? Entre em contato com o suporte técnico do Tic-Ticket.