Este tipo de notificação envia uma mensagem a um paciente para que ele confirme ou não o comparecimento a um exame previamente agendado. Além de confirmar ou cancelar o agendamento o paciente também pode solicitar o reagendamento do exame.
Para os exames que forem confirmados o paciente vai ser informado dos procedimentos de peparação que ele tem de observar antes de ir para o exame. As instruções para o paciente são repassadas a ele de acordo com o canal de comunciação usado na confirmação.
Confirmar
Notifications (POST) /notifications
Nenhum
Sim
medical
examwithprepare
{
"entity_id": "cjth5ux7n000001l1zmd7tk99",
"external_id": "76458",
"category": "medical",
"target": "examwithprepare",
"scheduler_type": "auto",
"when": "2019-07-09T20:15:00Z",
"timezone": "America/Sao_Paulo",
"webhook": "https://webhook.site/4bcb79b9-aabe-4f90-ac34-647a6b833f96",
"contact": {
"external_id": "3946",
"language": "pt_BR",
"country": "BR",
"birth_date": "1953-03-30",
"citizen_id": "12345678901",
"gender": "M",
"name": "José da Silva",
"channels": [
{
"type": "phone",
"uid": "027-30709999"
},
{
"type": "phone",
"uid": "+5527999999999"
},
{
"type": "email",
"uid": "jose.silva@dominio.com.br"
}
]
},
"params": {
"event_date": "2019-07-12T16:27:00Z",
"prepare_id": "cjx2jzrti000001gl4k45xxpc",
"exam": "Holter 24 horas"
}
}
| Campo | Finalidade |
|---|---|
| entity_id | Código da clínica, consultório, ou hospital cadastrado na API que é o gerador da notificação. |
| external_id | ID único do agendamento no sistema da clínica, hospital ou consultório - coloque aqui, preferencialmente, a chave primária da tabela de agendamentos do seu banco de dados. |
| category | Categoria da notificação. |
| target | Objetivo da notificação. |
| contact | Dados da pessoa que receberá a notificação. |
| params | Dados específicos para o tipo da notificação (mais detalhes). |
| … | Todos os demais campos são explicados na documentação da API Notifications (POST) /notifications. |
Os campos category e target definem o tipo da notificação que será enviada.
"params": {
"event_date": "2019-07-12T16:27:00Z",
"prepare_id": "cjx2jzrti000001gl4k45rtgc",
"exam": "Holter 24 horas"
}
| Campo | Finalidade |
|---|---|
| event_date | Data e hora do exame. |
| prepare_id | Código do arquivo com instruções de preparo previamente cadastradco na API. |
| exam | Nome do exame. |
Informação
Para saber quais os prepare_id estão cadastrados para uma entidade use está API Files (GET) /files/{entity_id}.
Existem vários recursos na API para criar, alterar, excluir e listar os arquivos que podem ser usados nas notificações. Veja a documentação sobre a API de arquivos para maiores informações.