Cole isto no seu prompt de sistema
O protocolo do questionário conversacional
1
Iniciar
hidoctor_questionnaire_start com um category_slug (weight-loss,
hair-growth, sexual-health, …). Devolve a primeira pergunta por
responder, mais answered_count e applicable_total, para que possa
mostrar o progresso.Se o paciente já tinha um questionário a meio, é retomado no ponto em que
ficou.2
Responder, repetidamente
hidoctor_questionnaire_answer regista uma resposta e devolve a pergunta
seguinte. É o servidor que decide o que vem a seguir, pelo que a
ramificação é tratada por si — nunca avalia uma condição por sua conta.As respostas são fundidas, não substituídas. Nada se perde entre chamadas, e
o paciente pode parar e voltar mais tarde.3
Rever e corrigir
hidoctor_questionnaire_review devolve todas as respostas dadas até ao
momento, em formato legível. hidoctor_questionnaire_back recua para a
pergunta anterior, para que uma resposta possa ser alterada.Alterar uma resposta pode fechar um ramo. Quando isso acontece, a resposta
do servidor enumera dropped_question_keys — as respostas que deixaram de
se aplicar e foram removidas. Mencione-o se for relevante para o paciente.4
Submeter
hidoctor_questionnaire_submit devolve um outcome:Formatos de resposta
É a própria pergunta que indica como responder-lhe. Leia o campokind:
Os nós de seguimento trazem uma cadeia de texto
answer_instructions que
indica exatamente onde o valor deve ser colocado. Siga-a.
As regras acima não são impostas tecnicamente
A Hi-Doctor não consegue distinguir se uma resposta veio do paciente ou foi inferida pelo assistente. Nada na API valida isso. O que o servidor impõe de facto é a elegibilidade.A elegibilidade é decidida pelo servidor
As contraindicações, o limiar de IMC, o limite de idade e a verificação do país abrangido são impostos quando o questionário é submetido — não pelo assistente nem pelo site.Coisas que o vão apanhar desprevenido
Envie os valores das opções, não as etiquetas
Envie os valores das opções, não as etiquetas
As etiquetas são texto para humanos e são traduzidas para a língua do
paciente.
value é o identificador estável que o servidor espera.O questionário vem na língua do paciente
O questionário vem na língua do paciente
O texto das perguntas é devolvido na língua definida no perfil do paciente.
Faça as perguntas nessa língua.
O pagamento acontece na Stripe, não no chat
O pagamento acontece na Stripe, não no chat
hidoctor_checkout_create devolve um link. Nunca peça dados do cartão — não
tem forma de os receber, e pedi-los habitua os pacientes a entregar números
de cartão a chatbots.O registo do progresso é exclusivo da perda de peso
O registo do progresso é exclusivo da perda de peso
Numa ligação normal de paciente todas as permissões são concedidas, o
pagamento incluído. Mas o diário de progresso é construído à volta do peso,
das injeções e de um plano de injeções, pelo que só está disponível no
tratamento de perda de peso — não nos planos de crescimento capilar ou de
saúde sexual.Chame
hidoctor_progress_status antes de propor registar seja o que for. Se
uma ferramenta estiver totalmente ausente, o paciente recusou essa permissão
no momento da ligação — diga-o, em vez de tentar adivinhar um contorno.O peso é um registo por dia; as notas e as injeções não
O peso é um registo por dia; as notas e as injeções não
Registar o peso numa data substitui o registo desse dia. As notas e as
injeções acumulam-se, pelo que registar duas vezes cria dois registos.