> ## Documentation Index
> Fetch the complete documentation index at: https://docs.westhetics.io/llms.txt
> Use this file to discover all available pages before exploring further.

# A anamnese pelo seu WhatsApp

> Peça o link da anamnese com o canal link e mande pela ferramenta de WhatsApp que a clínica já usa. A Westhetics avisa quando a paciente responder.

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**.

**1. Crie a anamnese com o canal link**

```bash theme={null}
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.

**2. Mande o link pelo seu canal**

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

```javascript theme={null}
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.

**3. Espere a resposta**

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

```json theme={null}
{
  "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.

```bash theme={null}
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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.