Esta página do wiki foi descontinuada e pode estar desatualizada. A documentação oficial e atualizada do NicoChat está em docs.nicochat.com/p/464-feegow-gestao-clinicas-consultorios. Consulte sempre o link acima — o conteúdo abaixo é mantido apenas como histórico.

O Feegow é o NicoApp de integração com o Feegow Clinic, sistema de gestão usado por clínicas e consultórios médicos (agenda, pacientes, exames, convênios, profissionais). Com ele, seu bot consulta disponibilidade, cria/remarca/cancela agendamentos, cadastra e atualiza pacientes e consulta o catálogo da clínica (profissionais, locais, convênios, especialidades, procedimentos e pacotes) — tudo direto do fluxo do NicoChat.

Disponível na aba de NicoApps. Base da integração: API oficial Feegow Clinic (docs.feegow.com), autenticada via header x-access-token.

Como obter as credenciais (x-access-token)

A Feegow usa um token único (x-access-token) por licença, liberado dentro do próprio painel — não é preciso abrir chamado para gerar o token inicial:

Acesse, no painel Feegow Clinic, Configurações → Outras Configurações → API Pública.
Clique em Gerar novo Token.
Opcionalmente, edite o nome/descrição do token (ícone de lápis) e ajuste as permissões de acesso (ícone de cadeado) para os endpoints que o app vai usar (agenda, pacientes, exames, convênios, catálogo).
Copie o token gerado e cole no campo de credencial na instalação do NicoApp.

Somente usuários com perfil administrador conseguem gerar tokens de API na Feegow.

Fontes: Como integrar o Feegow via API com outros sistemas? (Central de Ajuda Feegow) e Feegow REST API v1.0 — Autorização (documentação de referência para desenvolvedores, com todos os parâmetros de cada endpoint).

A Central de Ajuda da Feegow reforça que integrações via API são de responsabilidade do cliente, que deve contar com uma empresa ou profissional técnico para configurá-las — a Feegow não implementa a integração nem indica parceiros.

Limitações

Limite de requisições (rate limit) e exigência de plano/módulo específico para a API não são divulgados publicamente pela Feegow. Confirme com o suporte Feegow (sucesso@feegow.com.br) antes de dimensionar fluxos de alto volume.

Se o seu fluxo passar a depender de volume alto de chamadas (bot de atendimento com muitas conversas simultâneas), confirme diretamente com o suporte Feegow (sucesso@feegow.com.br) se existe throttling, cota mensal ou requisito de plano/módulo para a API Pública antes de escalar o uso.
O token é único por licença/permissões — não há OAuth por usuário; trate-o como uma credencial sensível (fica salvo na instalação do NicoApp).
Como não há confirmação de rate limit público, adote como boa prática as mesmas recomendações de outras integrações: evite reconsultar catálogo (profissionais/locais/convênios/especialidades/procedimentos/pacotes) a cada mensagem e prefira cachear esses dados em variáveis do bot.

O que o miniapp faz

01 Agendamentos

Ação	Endpoint	O que faz	Entradas principais	Saídas

Ação	Endpoint	O que faz	Entradas principais	Saídas
Criar novo agendamento	`POST /appoints/new-appoint`	Cria um agendamento na agenda da clínica	local_id, paciente_id, profissional_id, especialidade_id, procedimento_id, data, horario (obrigatórios); valor, plano, convenio_id, convenio_plano_id, canal_id, tabela_id, notas, celular, telefone, email (opcionais)	ID do Agendamento (agendamento_id)
Remarcar agendamento	`POST /appoints/reschedule`	Altera data/horário de um agendamento existente	agendamento_id, motivo_id, data, horario (obrigatórios); obs (opcional)	Conteúdo da resposta da Feegow
Cancelar agendamento	`POST /appoints/cancel-appoint`	Cancela um agendamento	agendamento_id, motivo_id (obrigatórios); obs (opcional)	—
Atualizar Status Agendamento	`POST /appoints/statusUpdate`	Atualiza o status de uma sessão agendada (ex.: confirmado, presente, falta)	AgendamentoID, StatusID (obrigatórios); Obs (opcional)	Confirmação (success)
Disponibilidade de horários	`GET /appoints/available-schedule`	Lista horários livres num período, filtrando por profissional/especialidade/procedimento/unidade/convênio	tipo; especialidade_id, procedimento_id, data_start, data_end, unidade_id, profissional_id, convenio_id (todos opcionais, ao menos um filtro recomendado)	Horários disponíveis por data (já reordenados da data mais próxima para a mais distante)
Listar agendamentos	`GET /appoints/search`	Busca agendamentos por paciente e/ou período	data_start, data_end, paciente_id (opcionais)	Lista de agendamentos (agendamento_id, data, horario, paciente_id, procedimento_id, profissional_id, agendado_em)

02 Pacientes

Ação	Endpoint	O que faz	Entradas principais	Saídas

Ação	Endpoint	O que faz	Entradas principais	Saídas
Criar paciente	`POST /patient/create`	Cadastra um novo paciente na Feegow	nome_completo (obrigatório); cpf, data_nascimento, genero, celular(es), telefone(s), email(s), endereço completo, convenio_id, plano_id, matrícula, entre outros (opcionais)	ID do Paciente (paciente_id)
Atualizar paciente	`POST /patient/edit`	Atualiza os dados de um paciente existente	paciente_id (obrigatório) + qualquer um dos campos de Criar paciente para atualizar	Conteúdo da resposta da Feegow
Recuperar informações do paciente	`GET /patient/search` (com fallback para `GET /patient/list` por telefone)	Busca um paciente por ID, CPF ou telefone	paciente_id ou cpf ou telefone (ao menos um obrigatório)	Nome, nascimento, celulares, telefones, e-mails, documentos (RG/CPF), convênios, observação e paciente_id

03 Exames

Ação	Endpoint	O que faz	Entradas principais	Saídas

Ação	Endpoint	O que faz	Entradas principais	Saídas
Listar pedidos de exames	`GET /patient/exam-requests`	Lista os pedidos de exame de um paciente	paciente_id ou cpf (obrigatório); data_inicio, data_fim, tipo_pedido (opcionais)	Lista de pedidos (PedidoExameID, PacienteID, DataPedido, PedidoExame)

04 Catálogo da clínica

Ação	Endpoint	O que faz	Entradas principais	Saídas

Ação	Endpoint	O que faz	Entradas principais	Saídas
Listar Profissionais	`GET /professional/list`	Lista os profissionais cadastrados	—	Profissionais encontrados (JSON), total
Listar Locais	`GET /company/list-local`	Lista as unidades/locais de atendimento	—	Locais encontrados (JSON), total
Listar Convênios	`GET /insurance/list`	Lista os convênios cadastrados	—	Convênios encontrados (JSON, sem dados de endereço), total
Listar Especialidades	`GET /specialties/list`	Lista as especialidades médicas cadastradas	—	Especialidades encontradas (JSON), total
Listar Canais	`GET /appoints/list-channel`	Lista os canais de agendamento (origem do agendamento)	—	Canais encontrados (JSON), total
Listar Procedimentos	`GET /procedures/list`	Lista os procedimentos/serviços da clínica	tipo_procedimento, procedimento_id, unidade_id, paciente_id, especialidade_id, profissional_id, tabela_id, nome_procedimento (todos opcionais)	Procedimentos encontrados (JSON), total
Listar Pacotes	`GET /procedures/bundles`	Lista os pacotes de procedimentos	procedimento_id, pacote_id (opcionais)	Pacotes encontrados (JSON), total

Dicas e observações

Tratamento de erros: quando a Feegow recusa a operação, a ação falha e devolve a mensagem de erro real da Feegow através do bloco action_failed — use o caminho de erro do bloco no fluxo para tratar isso (ex.: horário indisponível, campo obrigatório faltando, token sem permissão para o endpoint).
Preenchimento automático de notas/obs: se o campo de observação ficar vazio, o app preenche automaticamente com um texto padrão antes de enviar — "Agendamento da Automação" em Criar novo agendamento, e "Desmarcado pela automação" em Cancelar agendamento. Isso facilita identificar depois, no painel Feegow, quais registros vieram do bot.
Disponibilidade de horários reordenada por data: a resposta bruta da Feegow chega agrupada por profissional/local; o app reprocessa o retorno e reordena os horários por data (da mais próxima para a mais distante), já unificados num único objeto por data — pronto para apresentar ao contato.
Recuperar paciente por telefone: quando não há paciente_id nem CPF, a ação cai para GET /patient/list filtrando por telefone e trata os três cenários: nenhum encontrado, um encontrado (segue normalmente) ou múltiplos encontrados (retorna aviso para desambiguar com o contato).
IDs encadeados: paciente_id sai de Criar paciente ou Recuperar informações do paciente e alimenta Criar/Remarcar/Cancelar agendamento, Atualizar paciente e Listar pedidos de exames. agendamento_id sai de Criar novo agendamento e alimenta Remarcar, Cancelar e Atualizar Status.
Economize requisições: como a Feegow não publica limites de rate limit, ainda assim é boa prática não reconsultar o catálogo (profissionais/locais/convênios/especialidades/procedimentos/pacotes) a cada mensagem — esses dados mudam pouco; guarde IDs em variáveis do bot.
Formato de datas: a maioria dos endpoints de agenda usa DD-MM-AAAA (ex.: 16-12-2025) e horário separado em HH:MM:SS; confira o formato esperado de cada campo ao montar o fluxo.

Feegow (Gestão de Clínicas e Consultórios)