# Integração Feegow

![Integração Feegow](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOEJsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3ad90229cf0f1252ce6f3dbc179c133d8803d1e6/simplesdesk-feegow.png)

Conecte a **Feegow Clinic** ao SimplesDesk e transforme o WhatsApp da clínica em um canal completo de agendamento: o Agente de IA busca pacientes, consulta horários e agenda consultas sozinho, e os fluxos automatizam confirmação, remarcação e cancelamento — tudo direto na conversa, sem sair da plataforma.

## Quando utilizar

- Clínicas que operam no Feegow e querem **agendamento e autoatendimento pelo WhatsApp**;
- Réguas de **confirmação de consulta** (véspera ou 48h antes) com botões de confirmar/cancelar;
- Atendimento com **Agente de IA** que responde preços, convênios, endereços e agenda de ponta a ponta.

## Qual recurso usar em cada tarefa

| Você quer… | Use | Por quê |
| --- | --- | --- |
| Mostrar os **horários livres** e o paciente **escolher e agendar** na conversa | **Agente de IA** com o grupo **Agendamento** | A IA apresenta as opções, entende respostas como "quinta de manhã", agenda, remarca e cancela |
| **Confirmar** consultas já marcadas (véspera, 48h antes) | **Fluxo** com a fonte **"Feegow: Consultas do dia"** + nó **Confirmar Consulta** | Dispara sozinho no horário, sem ninguém iniciar a conversa |
| Lembrete, pesquisa pós-consulta ou aviso para quem já tem agendamento | **Fluxo** com a mesma fonte | Cada consulta da data-alvo vira um disparo com as variáveis prontas |
| Buscar/cadastrar paciente, listar convênios, unidades ou profissionais dentro de um fluxo | **Nós de fluxo Feegow** | Passos fixos, sem conversa livre |

> ⚠️ **Atenção:** a fonte **"Feegow: Consultas do dia"** (o nó de origem do gatilho de disparo agendado) lista **consultas já marcadas** — ela **não** traz horários disponíveis. Para oferecer horários livres ao paciente, use o **Agente de IA** (recomendado) ou, em fluxos, o nó **Verificar Horários**.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **Feegow**.
2. Preencha a **API Key** (você a encontra no painel administrativo da Feegow Clinic).
3. Clique em **Conectar** — a conexão é testada antes de salvar e fica ativa para toda a conta.

Com a conta conectada, três frentes ficam disponíveis: **Agente de IA**, **nós de fluxo** e **fonte de contatos para disparos agendados**.

---

## Agente de IA

Nas configurações do assistente (**Central IA → seu assistente → Integrações**), ative a Feegow e escolha as **capacidades habilitadas** por grupo:

| Grupo | O que a IA passa a fazer |
| --- | --- |
| **Paciente** | Buscar por CPF ou nome, criar e editar cadastro, listar dependentes, listar pedidos de exames e enviar arquivos ao prontuário |
| **Agendamento** | Listar especialidades, consultar preços de procedimentos, verificar horários disponíveis, agendar, remarcar e cancelar consultas |
| **Profissionais** | Listar os profissionais da clínica e detalhar CRM, conselho e especialidades |
| **Informações da Clínica** | Unidades com endereço e telefone, consultórios e convênios aceitos |

Dois recursos aceleram a configuração:

- **Agendamento automático** — com o toggle ativado, a IA conclui o agendamento sozinha, sem depender de aprovação de um atendente. Desativado, ela prepara tudo e pede confirmação humana antes de gravar na agenda.
- **Criar cenário modelo** — um clique cria um cenário pronto com o fluxo completo de agendamento (listar horários agrupados por profissional, desambiguar quando há mais de um médico no mesmo horário, coletar dados do paciente e agendar). Depois é só ajustar os textos em **Cenários**.

> 💡 A IA consulta preços direto da tabela de procedimentos da Feegow — informa o valor correto e já agenda com o procedimento escolhido.

### Como a IA conduz um agendamento

1. O paciente escreve, por exemplo: *"Quero marcar uma consulta com dermatologista"*.
2. A IA identifica o paciente (busca por CPF ou nome; se não existir, cadastra).
3. Consulta os **horários disponíveis** da especialidade/profissional e envia as opções agrupadas por profissional.
4. O paciente escolhe (*"quinta às 14h"*); a IA confirma os dados e **agenda** na Feegow — sozinha, se o **Agendamento automático** estiver ligado.
5. Se o paciente pedir para **remarcar** ou **cancelar** depois, a IA faz direto na conversa.

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **Feegow** com nós prontos — combine-os com os nós padrão (Enviar Mensagem, Condição, Coletar Dados) para montar jornadas de passos fixos:

**Pacientes**

- **Buscar Paciente** — por CPF ou nome; com 1 resultado, salva os dados em variáveis individuais;
- **Criar Paciente** e **Editar Paciente** — cadastro e atualização (nome, nascimento, celular, e-mail…);
- **Listar Dependentes**, **Listar Pedidos de Exames** e **Upload Prontuário** — gestão do prontuário na conversa.

**Agendamento**

- **Listar Especialidades** — especialidades da clínica (use o ID nos nós seguintes);
- **Verificar Horários** — agenda disponível por especialidade (obrigatória), profissional e período (padrão: próximos 7 dias). O retorno fica em `context.feegow_available_slots`, com data, hora, profissional, local e procedimento de cada horário;
- **Agendar Consulta** — cria o agendamento (exige paciente, profissional, especialidade, procedimento, data e hora); o ID fica em `context.feegow_agendamento_id` para os próximos nós;
- **Remarcar Consulta**, **Cancelar Consulta** e **Confirmar Consulta** — gestão completa do agendamento existente.

**Clínica e profissionais**

- **Listar Profissionais** e **Info do Profissional** — equipe da clínica com CRM e especialidades;
- **Listar Convênios**, **Listar Unidades** (com endereço formatado) e **Listar Locais** — informações institucionais;
- **Código Feegow** — nó avançado pré-configurado para lógicas customizadas em JavaScript.

Cada nó tem o campo **"Salvar resultado em"**: o retorno fica acessível como `variables.nome_variavel` nos nós seguintes. **Listar Profissionais**, **Listar Unidades** e **Listar Locais** também expõem variantes `_text` já formatadas, prontas para usar num **Enviar Mensagem**. Datas usam o formato `AAAA-MM-DD` e horários `HH:MM`.

> 💡 Para o paciente **escolher entre os horários livres** na conversa, prefira o **Agente de IA**: ele apresenta as opções, entende a resposta em linguagem natural e agenda. Os nós de fluxo são ideais para passos fixos (confirmar, cancelar, cadastrar, consultar informações).

---

## Fonte de contatos: consultas do dia

No gatilho **Disparo agendado**, a fonte **"Feegow: Consultas do dia"** busca as consultas **já marcadas** para a data-alvo e dispara o fluxo para cada paciente. Configure:

- **Antecedência (dias)** — 0 = hoje, 1 = amanhã, 2 = 48h antes;
- **Status** (opcional) — filtre por status do agendamento na Feegow.

Cada disparo chega com as variáveis do agendamento prontas para usar nas mensagens e condições (sintaxe `{{variables.nome}}`):

`variables.feegow_paciente_nome` · `variables.feegow_data` · `variables.feegow_horario` · `variables.feegow_profissional_nome` · `variables.feegow_profissional_id` · `variables.feegow_especialidade` · `variables.feegow_valor` · `variables.feegow_telemedicina` · `variables.feegow_agendamento_id` · `variables.feegow_status_id`

### Exemplo: régua de confirmação de consulta

1. Gatilho **Disparo agendado** + fonte **Feegow: Consultas do dia** (antecedência 1 dia);
2. **Enviar Mensagem** com template: "Olá {{variables.feegow_paciente_nome}}, sua consulta com {{variables.feegow_profissional_nome}} é amanhã às {{variables.feegow_horario}}. Confirma?" com botões **Confirmar** e **Remarcar**;
3. Na resposta, **Condição** → botão **Confirmar** leva ao nó **Confirmar Consulta** (usa `variables.feegow_agendamento_id`) e a uma mensagem de "Consulta confirmada ✅"; botão **Remarcar** transfere para o **Agente de IA** (que remarca na hora) ou para um time humano.

> 📌 No **WhatsApp oficial**, a mensagem do passo 2 sai fora da janela de 24h — use um **modelo (template) aprovado** com botões de resposta rápida.

---

## Como testar antes de colocar no ar

1. **Agendamento:** numa conversa de teste, peça ao agente *"quero marcar com [profissional]"* → escolha um dos horários sugeridos → confira o agendamento no painel da Feegow.
2. **Confirmação:** marque uma consulta de teste para **amanhã**, crie o fluxo de confirmação (antecedência 1) e aguarde o horário do disparo → clique em **Confirmar** no WhatsApp → confira na Feegow se o status mudou para confirmado.
3. Se algo não disparar, abra **Fluxos → seu fluxo → Execuções** para ver cada passo e a mensagem de erro da Feegow.

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de disparo agendado.

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