# Integração G-Click

![Integração G-Click](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN3RsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3ae2a8c90c7978e68bcfd97b5b993c9418f9bc0b/simplesdesk-gclick.png)

Conecte o **G-Click** (gestão de tarefas contábeis do grupo Omie) ao SimplesDesk e atenda os clientes do escritório sem trocar de sistema: o Agente de IA localiza o cliente, consulta tarefas e obrigações, **envia guias e documentos das tarefas como anexo na conversa** e abre solicitações — e os nós de fluxo automatizam as mesmas ações. Só aparecem documentos do cliente vinculado à conversa, eliminando o risco de enviar arquivo para a pessoa errada.

## Quando utilizar

- Escritórios contábeis que usam o G-Click e atendem clientes pelo WhatsApp;
- Enviar **guias e documentos** das tarefas direto na conversa, com segurança;
- Cliente pedindo um serviço? Abra a **solicitação (pré-tarefa)** no G-Click sem sair do chat.

## Como conectar

1. No G-Click, acesse **Configurações → API**, crie uma nova aplicação e copie o **Client ID** e o **Client Secret** gerados.
2. No SimplesDesk, acesse **Configurações → Integrações**, clique no card **G-Click** e cole as credenciais.
3. Clique em **Testar e conectar** — a conexão é validada antes de salvar e o token de acesso é renovado automaticamente.

Na página da integração, um selo indica os **recursos de parceiro oficial** (registro de mensagens nas tarefas e links com rastreio de leitura): eles são habilitados automaticamente quando a homologação de parceiro é concluída. Consultar tarefas, enviar documentos e criar solicitações funcionam desde já.

---

## Agente de IA

Nas configurações do assistente (**Central IA → seu assistente → Integrações**), ative o **G-Click**. A IA passa a fazer:

| Capacidade | O que a IA passa a fazer |
| --- | --- |
| **Localizar cliente** | Busca por CNPJ/CPF ou nome e vincula o cliente à conversa |
| **Listar tarefas** | Tarefas e obrigações do cliente, com status e datas (por padrão, só as abertas/aguardando) |
| **Arquivos da tarefa** | Lista os documentos anexados às atividades de uma tarefa |
| **Enviar documento** | Envia o documento escolhido como **anexo na conversa** (com mensagem opcional) |
| **Criar solicitação** | Abre uma pré-tarefa no G-Click com assunto e descrição do pedido |
| **Registrar mensagens** ⭐ | Registra as últimas mensagens da conversa como resposta na atividade da tarefa (recurso de parceiro) |

> 🔒 A IA sempre **localiza o cliente antes** de listar tarefas ou enviar documentos — só documentos do cliente vinculado à conversa podem ser enviados.

### Exemplo: cliente pede a guia pelo WhatsApp

Cliente: "Preciso da guia do DAS deste mês." A IA localiza o cliente pelo CNPJ, lista as tarefas abertas, encontra os arquivos da tarefa da obrigação e envia a guia como anexo — em segundos, sem intervenção humana. Se o documento ainda não existir, ela abre uma **solicitação** descrevendo o pedido para o time do escritório.

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **G-Click** (visível com a integração conectada):

- **G-Click: Listar tarefas** — lista as tarefas do cliente e grava um resumo em variáveis; saída verde = encontrou, amarela = nenhuma tarefa/cliente. Config: janela em dias e "somente tarefas abertas/aguardando";
- **G-Click: Enviar documento** — localiza a tarefa e envia o(s) arquivo(s) como anexo na conversa (com mensagem opcional e máximo de arquivos); saídas: enviado × nada a enviar × erro;
- **G-Click: Criar solicitação** — abre a pré-tarefa com assunto e descrição (aceita variáveis); saídas: criada × erro.

Nos três nós, o cliente é resolvido nesta ordem: **ID do cliente** informado no nó → **CNPJ/CPF** (busca) → **vínculo salvo no contato** (feito pela IA ao localizar o cliente).

Variáveis gravadas para os próximos nós: `variables.gclick_tarefas_count` · `variables.gclick_tarefas_resumo` · `variables.gclick_primeira_tarefa_id` · `variables.gclick_primeira_tarefa` · `variables.gclick_primeira_tarefa_status` · `variables.gclick_documentos_enviados` · `variables.gclick_solicitacao_id` · `variables.gclick_erro`

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos**.

> 📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.