O que você vai preparar

A agenda fica no Google Calendar; a API e as credenciais ficam no Google Cloud. Faça estas quatro etapas no Google e só depois conclua a conexão no Atendeu Rápido. Você não precisa publicar a agenda nem fornecer a senha da conta Google ao sistema.

Mapa ilustrativo: escolher agenda, habilitar Google Calendar API, configurar consentimento, criar cliente OAuth e conectar no Atendeu Rápido
Sequência ilustrativa; não é uma captura do Google Cloud. Os nomes dos menus podem variar conforme a conta e a interface.
Imagem ampliada

1. Confira a agenda no Google Calendar

Abrir Google CalendarEscolha a conta que fará a autorização e confira a agenda.
  1. 1

    Abra calendar.google.com com a conta que deverá autorizar a integração. Confirme que ela é a conta correta antes de continuar.

  2. 2

    Em Minhas agendas, escolha a agenda que será usada. Se precisar de uma agenda separada, em Outras agendas clique em + > Criar nova agenda, dê um nome claro e salve.

  3. 3

    Se a agenda pertencer a outra pessoa, peça ao proprietário que a compartilhe com a conta que fará a autorização. Para criar ou alterar eventos, essa conta precisa de permissão de edição; acesso somente de leitura não basta.

  4. 4

    Em Configurações da agenda, confira o fuso horário e compare com o usado pela equipe para evitar horários inesperados.

2. Selecione o projeto e ative a API

Abrir Google CloudSelecione o projeto antes de ativar a API e criar o cliente OAuth.
  1. 1

    Abra console.cloud.google.com com uma conta autorizada a administrar o projeto da empresa.

  2. 2

    No seletor de projetos, escolha um projeto existente ou crie um projeto para a integração. Confirme o nome do projeto no topo da página.

  3. 3

    Abra APIs e serviços > Biblioteca, pesquise Google Calendar API, abra o resultado oficial e clique em Ativar. Se aparecer Gerenciar, ela já está habilitada nesse projeto.

  4. 4

    Mantenha o mesmo projeto selecionado nas próximas etapas: a API, a configuração de consentimento e o cliente OAuth devem pertencer a ele.

3. Configure a autorização OAuth

  1. 1

    No Google Cloud, abra Google Auth Platform > Branding e preencha os dados solicitados da aplicação, como nome e e-mail de suporte.

  2. 2

    Em Audience, selecione Internal somente se o projeto estiver em uma organização Google Workspace e o uso for restrito aos membros dela. Nos demais casos, use External.

  3. 3

    Se o público for External e o status estiver em Testing, adicione em Test users o endereço exato da conta Google que autorizará a agenda.

  4. 4

    Em Data Access, revise os escopos de calendário solicitados pela integração e mantenha apenas os necessários. O acesso de leitura não permite criar ou editar eventos.

4. Crie o cliente OAuth de aplicativo da Web

  1. 1

    No Atendeu Rápido, abra Configuração > Configurações > Integrações > Google Calendar > Nova configuração. Copie a URI de Redirecionamento exibida no formulário atual.

  2. 2

    Volte ao Google Cloud: Google Auth Platform > Clients > Create client. Em Application type, escolha Web application e dê um nome reconhecível ao cliente.

  3. 3

    Em Authorized redirect URIs, adicione exatamente a URI copiada do Atendeu Rápido — incluindo https, caminho, letras e barra final, se houver. Não substitua pelo endereço da central de ajuda.

  4. 4

    Crie o cliente e copie o Client ID e o Client Secret. Guarde o segredo em local seguro; não o inclua em prints, e-mails ou chamados públicos.

Esquema dos campos OAuth: a URI de Redirecionamento sai do Atendeu Rápido e entra em Authorized redirect URIs no Google Cloud; Client ID e Client Secret seguem o caminho inverso
Mapa ilustrativo dos campos; não é uma captura do Google Cloud nem contém valores reais. Use a URI mostrada no seu formulário.
Imagem ampliada
Parte superior do formulário atual do Atendeu Rápido com os campos Nome, Client ID e Client Secret
Após criar o cliente no Google, preencha estes campos no Atendeu Rápido. A URI de Redirecionamento fica mais abaixo no mesmo formulário e deve ser copiada de lá.
Imagem ampliada

Após criar o cliente no Google, preencha estes campos no Atendeu Rápido. A URI de Redirecionamento fica mais abaixo no mesmo formulário e deve ser copiada de lá.

Abrir imagem original em nova aba ↗

Conecte e faça um teste curto

  1. 1

    No formulário do Atendeu Rápido, preencha Nome, Client ID e Client Secret e use Obter tokens via Google (OAuth).

  2. 2

    No Google, escolha a mesma conta que tem acesso à agenda, leia as permissões solicitadas e conclua a autorização apenas se reconhecer o projeto e o domínio apresentados.

  3. 3

    Salve a configuração. Depois selecione a agenda e busque eventos de um intervalo curto, como os próximos sete dias, para comparar com o Google Calendar.

Se a conexão não funcionar

  • redirect_uri_mismatch: abra o cliente OAuth cujo Client ID foi informado no Atendeu Rápido e compare a URI autorizada no Google com a exibida agora no formulário. https, caminho, letras e barra final devem coincidir.
  • invalid_client: confira se Client ID e Client Secret são do mesmo cliente OAuth e se o segredo foi copiado por completo. Não envie o segredo ao suporte por e-mail ou print.
  • Acesso bloqueado ou usuário não autorizado: confira Audience e, se estiver em Testing, inclua a conta em Test users. Verifique também se o Google exige a verificação do aplicativo.
  • A agenda não aparece: confirme que a conta autorizada tem acesso à agenda e que a Google Calendar API está ativada no mesmo projeto do cliente OAuth.
  • A conexão pede nova autorização depois de alguns dias: verifique se o aplicativo externo ainda está em Testing e se a autorização expirou.