Tudo o que o seu agente usa da Google está num único mosaico Google em Integrações: Calendar, Gmail, Drive, Contacts e Tasks. Cada serviço liga-se separadamente e o agente só tem acesso aos que ativar.
| Serviço | O que o agente pode fazer |
|---|---|
| Google Calendar | Verificar disponibilidade e marcar consultas durante uma chamada |
| Gmail | Encontrar e ler emails, responder numa conversa, enviar um novo email, preparar um rascunho |
| Google Drive | Encontrar e ler um ficheiro, escrever uma nota, atualizar uma folha de cálculo, arrumar pastas |
| Google Contacts | Reconhecer quem liga pelo número, guardar um novo contacto |
| Google Tasks | Ver tarefas, adicionar uma tarefa com prazo, marcar uma tarefa como concluída |
Como funciona a ligação
- Abra Integrações e clique no mosaico Google.
- No painel que se abre, ligue os serviços de que precisa — cada um tem o seu botão Conectar.
- A Google mostra o seu ecrã de consentimento padrão para esse serviço. Inicie sessão com a conta Google a usar e clique em Permitir.
- De volta à HANC, o serviço mostra Conectado e o email da conta. O mosaico conta quantos serviços estão ligados.
A ligação pertence ao espaço de trabalho, não a um agente; cada espaço de trabalho liga o Google separadamente. Autoriza uma vez e depois adiciona a ferramenta correspondente a quantos agentes quiser no separador Ações de cada um (Ações e Ferramentas). Em cada ferramenta marca o que o agente pode fazer — as ações não marcadas não lhe estão de todo disponíveis — e pode acrescentar regras por palavras suas.
Acesso pedido pela HANC
| Serviço | Scope OAuth | O que permite |
|---|---|---|
| Google Calendar | calendar.events, calendar.calendarlist.readonly, calendar.freebusy | Ler e criar eventos, listar os seus calendários, verificar horários livres/ocupados |
| Google Drive | drive.file | Apenas os ficheiros e pastas que escolher no seletor de ficheiros da Google, mais os ficheiros criados pelo agente |
| Google Contacts | contacts, contacts.other.readonly, userinfo.email | Ler, criar e atualizar contactos; encontrar pessoas com quem trocou emails e que não estão guardadas como contactos; ver que conta Google está ligada |
| Google Tasks | tasks, userinfo.email | Ler listas de tarefas, adicionar e concluir tarefas; ver que conta Google está ligada |
| Gmail | — | Ligado através do nosso parceiro de email, não através de um scope Google; consulte Gmail |
Se a Google deixar de aceitar o acesso concedido a um serviço, a respetiva linha mostra Reconexão necessária. Clique em Conectar novamente para que o agente possa continuar a usá-lo.
Google Calendar
O agente verifica a disponibilidade e marca consultas reais enquanto quem liga ainda está em linha.
- Verificação de disponibilidade — o agente lê o seu calendário para confirmar se um horário pedido está livre.
- Criação de eventos — o agente marca uma consulta confirmada como novo evento, com o nome e o telefone de quem liga e as notas recolhidas durante a chamada.
- Links de cancelamento — Numa chamada telefónica, o SMS de confirmação inclui uma ligação para cancelar. As chamadas web não recebem ligação para cancelar.
A HANC pode ler os detalhes dos eventos nos calendários que ligar; o agente usa apenas o que precisa para responder a quem liga.
O Google Calendar está disponível em todos os planos, incluindo o Free.
Definições da ferramenta de calendário
Adicione a ferramenta Google Calendar no separador Ações do agente e configure-a:
| Definição | O que faz |
|---|---|
| Calendário | De que calendário o agente lê e em qual escreve |
| Fuso horário (opcional) | O fuso horário de todos os horários que o agente propõe |
| Adicionar um link do Google Meet ao agendamento | Cada evento marcado pelo agente recebe um link de videochamada |
| Início do trabalho, Fim do trabalho, dias úteis | Dias e horas que o agente oferece (ex.: seg–sex, 09:00–18:00) |
| Duração do intervalo | Duração da consulta: 15–120 minutos, em passos de 15 |
Cada agente pode configurá-las de forma independente — um agente pode marcar demos de 30 minutos e outro consultas de 90 minutos a partir do mesmo calendário. Referência completa dos campos: Ações e Ferramentas → Google Calendar.
Fusos horários
Todas as propostas de horário, confirmações e eventos criados usam o fuso horário configurado na ferramenta de calendário do agente (ex.: Europe/Vienna). O agente diz o fuso horário em voz alta quando propõe um horário — "Terça às 15h, hora de Viena, dá jeito?" — para que quem liga nunca tenha de adivinhar. A Google mostra o evento a cada participante na sua hora local.
Desligar e voltar a ligar
Quando desliga o Google Calendar:
- Os tokens guardados são removidos.
- Cada ferramenta Google Calendar de cada agente é desativada — fica no agente, mas deixa de ser acionada durante as chamadas.
- Os eventos já marcados na Google não são eliminados nem alterados.
Quando volta a ligar (ou liga outra conta Google), as ferramentas reativam-se automaticamente com as definições anteriores. Também pode revogar o acesso da HANC nas definições de segurança da sua conta Google — o efeito é o mesmo.
Cada evento criado pelo agente aparece também em CRM → Calendário, ao lado das marcações do Outlook. Consulte CRM.
Gmail
Ligue uma caixa Gmail ou Google Workspace para que o agente possa encontrar e ler emails, responder e enviar. O Gmail liga-se através do nosso parceiro de email, tal como as caixas Outlook e IMAP — consulte Email para saber o que o agente pode fazer e como o envio está protegido.
Google Drive
O agente trabalha apenas com os ficheiros e pastas que escolher no seletor de ficheiros da Google, mais os ficheiros que ele próprio cria. O resto do seu Google Drive fica-lhe fechado.
Escolher ficheiros:
- Ligue o Google Drive no mosaico Google.
- Clique em Escolher arquivos e pastas e escolha o que o agente pode usar. A lista Arquivos e pastas que o agente pode usar mostra a sua escolha.
- A Google não deixa as aplicações levar um disco inteiro de uma vez. Para dar ao agente tudo o que está numa pasta, clique em Selecionar tudo, prima a combinação de teclas mostrada no seletor e confirme.
Remover um item da lista apenas o oculta aí — a Google mantém o acesso concedido até desligar o Google Drive.
O que o agente pode fazer (marcado na ferramenta Google Drive):
| Ação | Notas |
|---|---|
| Encontrar arquivos e pastas | — |
| Ler arquivos | Documentos, folhas de cálculo, PDF |
| Criar arquivos | Por exemplo, escrever uma nota da chamada |
| Alterar o conteúdo de um arquivo (acrescentar ou substituir) | Acrescentar a um Google Doc mantém a formatação; acrescentar a um Google Sheet adiciona linhas |
| Organizar: criar pastas, renomear, mover e copiar | — |
| Excluir arquivos | Move o ficheiro para o lixo do Google Drive |
Antes de eliminar um ficheiro ou pasta ou de substituir o texto de um ficheiro, o agente nomeia o ficheiro, pergunta à pessoa em linha e só age depois de um "sim" claro.
O Google Drive também pode iniciar um gatilho quando um ficheiro aparece ou muda.
Google Contacts
Numa chamada recebida, o agente procura o número nos seus Google Contacts e cumprimenta quem liga pelo nome. Também pode encontrar contactos, guardar novos e atualizar os existentes.
| Definição / ação | Descrição |
|---|---|
| Reconhecer quem liga pelo número | Numa chamada recebida, o agente procura o número e cumprimenta quem liga pelo nome |
| Encontrar um contato pelo número de telefone | — |
| Encontrar contatos pelo nome ou outros dados | — |
| Salvar novos contatos | — |
| Alterar contatos existentes | — |
O agente trabalha com todos os contactos da conta Google ligada.
Google Tasks
O agente vê as suas listas do Google Tasks, adiciona tarefas com prazo e marca-as como concluídas.
| Definição / ação | Descrição |
|---|---|
| Lista de tarefas | Com que lista o agente trabalha; a lista predefinida se não escolher |
| Ver tarefas | — |
| Adicionar tarefas | Com prazo |
| Marcar tarefas como concluídas | — |
Relacionado
- Email — caixas Gmail, Outlook e IMAP
- Ações e Ferramentas — adicionar ferramentas Google a um agente
- Gatilhos — reagir em segundo plano a novos emails e ficheiros do Drive
- CRM — vista unificada das consultas marcadas