Diferenciar Agenda, lembrete e mensagem agendada

appointment representa um compromisso da Agenda. scheduleReminder representa uma regra de lembrete aplicada pela operação. Nenhuma rota de lembrete publicada recebe appointmentId, portanto não trate a regra como vinculada a uma consulta específica. O recurso separado de mensagem agendada possui outro fluxo.

Formulário de nova consulta na Agenda
Crie a consulta de homologação fora da agenda real e use dados claramente identificados como teste.

Criar, consultar e atualizar compromissos

  • POST .../appointment/create publica title, description, contactId, contactName, contactPhone, whatsappId, startAt, endAt, status e notes.
  • GET .../appointment/list aceita page, limit, status, startFrom, startTo e search.
  • GET .../appointment/show/{id} consulta um compromisso.
  • POST .../appointment/update/{id} publica os mesmos campos da criação.
  • POST .../appointment/delete/{id} usa corpo JSON vazio e remove o compromisso.
  • Na listagem, os estados descritos são pending, confirmed, cancelled e completed.

Criar e ativar regras de lembrete

  • POST .../scheduleReminder/create recebe name, description, hoursBeforeEvent, messageType, messageContent, whatsappId e active.
  • GET .../scheduleReminder/list consulta as regras.
  • POST .../scheduleReminder/update/{id} publica os mesmos campos da criação.
  • POST .../scheduleReminder/toggle/{id} alterna o estado usando corpo vazio.
  • POST .../scheduleReminder/delete/{id} remove a regra usando corpo vazio.
Configuração de lembretes automáticos da Agenda
Confira antecedência, conteúdo, canal e estado antes de ativar a regra.

Homologar sem afetar a agenda real

  1. 1

    Liste compromissos e regras antes de alterar qualquer registro.

  2. 2

    Crie um compromisso fictício fora do expediente real e consulte seu ID.

  3. 3

    Compare horário e fuso na API e na interface.

  4. 4

    Crie a regra de lembrete inicialmente inativa.

  5. 5

    Valide mensagem, antecedência e whatsappId.

  6. 6

    Antes de ativar, use canal e ambiente controlados e confirme que não existem outras consultas elegíveis para a regra.

  7. 7

    Ative com estado explícito, acompanhe a consulta fictícia e verifique se ocorreram efeitos inesperados em outros registros.

  8. 8

    Exclua somente os registros de homologação depois da conferência.

Resolver datas e lembretes incorretos

  • Consulta não aparece: revise período, status, paginação e search.
  • Data rejeitada: confirme o tipo aceito no formulário interativo, sem converter por tentativa em produção.
  • Horário deslocado: compare fuso da interface, servidor e sistema consumidor.
  • Lembrete não dispara: revise active, hoursBeforeEvent, whatsappId, conteúdo e disponibilidade do canal.
  • Estado alterna inesperadamente: suspenda retentativas de toggle e consulte a regra.