A anamnese pelo seu WhatsApp

Muitas clínicas já têm o próprio atendimento por WhatsApp. Com o canal link, a Westhetics cria a anamnese e devolve o endereço, sem mandar mensagem nenhuma. O seu sistema manda, com a voz da clínica. Escopo: Anamneses · Ler e escrever.

Crie a anamnese com o canal link

curl https://api.westhetics.io/v1/anamneses \
  -H "Authorization: Bearer $WESTHETICS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "patientId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "channel": "link",
    "procedureId": "b8e2c1d0-1a2b-4c3d-8e9f-0a1b2c3d4e5f"
  }'

procedureId e practitionerId são opcionais: quando vêm, a ficha de saúde mostra para que procedimento ela foi pedida.

Mande o link pelo seu canal

A resposta traz o endereço em link.url. Ele é pessoal: abre a anamnese desta paciente, sem senha.

const anamnesis = body.data
const firstName = patient.name.split(' ')[0]
await whatsapp.send(patient.whatsapp, [
  `Olá, ${firstName}. Antes do seu atendimento na Clínica Aurora,`,
  `preencha sua ficha de saúde: ${anamnesis.link.url}`,
  'Leva poucos minutos. O link vale 7 dias.',
].join(' '))

O link só aparece nesta resposta e na do reenvio. Ele não sai em nenhuma leitura nem em evento: guarde se precisar mandar de novo, ou peça outro com o reenvio.

Espere a resposta

Quando a paciente enviar, sai anamnesis.completed, com o protocolo:

{
  "type": "anamnesis.completed",
  "data": {
    "anamnesisId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "patientId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "protocolNumber": "WX-2210-QX"
  }
}

A partir daqui o contrato pode ser gerado. As respostas em si só saem com o escopo Ler as respostas da anamnese, por GET /v1/anamneses/{id}/answers.

Venceu ou a paciente perdeu o link

O link vale 7 dias. Depois disso a anamnese aparece como expired. Reenvie: o link anterior deixa de valer, o rascunho que ela já tinha preenchido continua, e a resposta traz o endereço novo.

curl https://api.westhetics.io/v1/anamneses/a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/resend \
  -H "Authorization: Bearer $WESTHETICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "channel": "link" }'

Evento: anamnesis.resent.

Os canais

`channel`	O que a Westhetics faz
`link`	nada: a resposta traz o endereço para você mandar
`email`	manda o e-mail com o link para o e-mail da ficha
`whatsapp`	manda pelo WhatsApp da Westhetics, quando o provedor estiver ligado para a clínica
`both`	os dois acima

O canal precisa do contato na ficha: email sem e-mail na ficha responde 422 em channel. Quando nenhum canal pedido conseguiu entregar, a resposta é 503 unavailable, mas a anamnese já foi criada: o corpo do erro traz anamnesisId e link.url. Mande o link pelo seu canal.

Começar

Guias

Como a API funciona

Venceu ou a paciente perdeu o link

Os canais