Integrações/NicoApps (MiniApps) Nativos/Sistemas de Negócios Locais/Feegow (Gestão de Clínicas e Consultórios)
Feegow (Gestão de Clínicas e Consultórios)
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).
Nota
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.
Atenção
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).
Nota
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
Atenção
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 pública sobre rate limit, 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 NicoApp faz
01 Agendamentos
Ação
Endpoint
O que faz
Entradas principais
Saídas
Criar novo agendamento
POST /appoints/new-appointCria 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/rescheduleAltera 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-appointCancela um agendamento
agendamento_id, motivo_id (obrigatórios); obs (opcional)
—
Atualizar Status Agendamento
POST /appoints/statusUpdateAtualiza 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-scheduleLista 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/searchBusca 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
Criar paciente
POST /patient/createCadastra 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/editAtualiza 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
Listar pedidos de exames
GET /patient/exam-requestsLista 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
Listar Profissionais
GET /professional/listLista os profissionais cadastrados
—
Profissionais encontrados (JSON), total
Listar Locais
GET /company/list-localLista as unidades/locais de atendimento
—
Locais encontrados (JSON), total
Listar Convênios
GET /insurance/listLista os convênios cadastrados
—
Convênios encontrados (JSON, sem dados de endereço), total
Listar Especialidades
GET /specialties/listLista as especialidades médicas cadastradas
—
Especialidades encontradas (JSON), total
Listar Canais
GET /appoints/list-channelLista os canais de agendamento (origem do agendamento)
—
Canais encontrados (JSON), total
Listar Procedimentos
GET /procedures/listLista 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/bundlesLista 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 recorre a
GET /patient/listfiltrando 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: mesmo que a Feegow não publique limites de rate limit, é 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 emHH:MM:SS; confira o formato esperado de cada campo ao montar o fluxo.