Visão geral
O que é Integração Externa?
A Integração Externa é um modelo onde você ou sua empresa desenvolve e mantém uma API que conecta o sistema de gestão do cliente com a plataforma Clinia. Em vez da Clinia desenvolver integrações internas para cada sistema de gestão, você assume essa responsabilidade.
Como funciona
O conceito de "integração"
Uma integração é uma ponte entre dois sistemas que não se comunicam nativamente. No nosso caso:
- Sistema de gestão de agendamentos: Onde os agendamentos são criados, editados e gerenciados
- Plataforma Clinia: Sistema de comunicação e notificações para pacientes
A integração permite que a Clinia acesse dados de agendamentos (como lista de pacientes, horários, status) para enviar notificações automáticas.
O que significa "Externa"
- Interna: A Clinia desenvolve a integração dentro de sua própria infraestrutura
- Externa: Você desenvolve e hospeda a integração, seguindo especificações definidas pela Clinia
O que você precisa desenvolver
API de Integração
Você deve criar uma API REST que:
- Segue nossa especificação: Todos os endpoints, parâmetros e respostas devem seguir exatamente o que definimos
- Conecta com o sistema de consultas: Busca dados reais do sistema de gestão de consultas do cliente
- Transforma dados: Converte o formato do sistema de consultas para o formato que a Clinia espera
Exemplo prático
Quando a Clinia precisa enviar lembretes de agendamentos para amanhã:
- A Clinia chama seu endpoint:
GET /appointments?start=2024-01-15&end=2024-01-16 - Sua API consulta o sistema de gestão de consultas do cliente
- Sua API retorna os dados no formato que a Clinia espera
- A Clinia usa esses dados para enviar mensagens aos pacientes
Para mais detalhes sobre a API de agendamentos, veja a documentação do endpoint.
Para mais casos de uso, veja a documentação de casos de uso.
Benefícios
- Desenvolvimento de Expertise: Sua equipe se posiciona como referência em integrações para o setor de saúde, agregando valor ao seu portfólio de soluções.
- Parceria estratégica: Estreitamento do relacionamento com o cliente final, promovendo colaboração contínua e entendimento aprofundado das necessidades do negócio.
- Novas oportunidades de negócio: Possibilidade de oferecer serviços diferenciados e personalizados, ampliando o alcance e a relevância da sua empresa no mercado.
- Crescimento escalável: Capacidade de replicar e adaptar a solução para múltiplos clientes, potencializando ganhos e consolidando sua atuação como parceiro da Clinia.
Próximos Passos
O próximo passo é ler toda a documentação para compreender o escopo completo do projeto. Em seguida, analise cuidadosamente os endpoints que precisam ser implementados e planeje a arquitetura da sua API de acordo com as necessidades identificadas.
Após esse planejamento, implemente a solução seguindo exatamente as especificações fornecidas na documentação. É fundamental testar a API utilizando dados reais do sistema de consultas do cliente para garantir que tudo funcione conforme esperado.
Caso surjam dúvidas durante a implementação, não hesite em entrar em contato para obter esclarecimentos.