AgendaPilot

Encontra os agendamentos de um cliente pelo nome, dentro de uma janela de datas (por padrão, os próximos 31 dias). É o caminho para agir sobre o horário de alguém quando se sabe o nome mas não a data.

buscar_agendamento

Procura clientes já cadastrados no estabelecimento pelo nome ou pelo telefone completo. Devolve o identificador usado para marcar um agendamento para alguém que já é cliente da casa. Quando a mesma pessoa aparecer em mais de um cadastro, o que tem `tem_email: true` é o bom: só ele recebe confirmação e lembretes.

buscar_cliente

Cancela um agendamento e dispara o aviso de cancelamento para o cliente. É irreversível por esta ferramenta: voltar atrás exige agendar de novo, e o horário pode não estar mais livre.

cancelar_agendamento

Marca que o cliente confirmou o agendamento e envia o aviso de confirmação pelos canais habilitados. Não altera horário nem serviço; confirmar de novo um agendamento já confirmado não muda nada.

confirmar_presenca

Lista os agendamentos do estabelecimento num período de até 31 dias, com cliente, serviço, profissional, horário e situação. É daqui que saem os identificadores usados para confirmar presença, remarcar, registrar falta ou cancelar.

consultar_agenda

Marca um horário na agenda do estabelecimento para um cliente já cadastrado ou para um cliente novo, e dispara o aviso de confirmação. O horário é validado contra a escala do profissional, o funcionamento da casa e os agendamentos existentes: horário ocupado é recusado, não sobrescrito.

criar_agendamento

Mostra um agendamento por inteiro, incluindo as observações anotadas no atendimento e o histórico de origem. Use quando precisar de contexto além do que a lista da agenda mostra.

detalhar_agendamento

Mostra, num dia, os horários livres de cada profissional (ou espaço) que executa os serviços informados. Use para responder quem tem vaga para um serviço numa data.

consultar_horarios_livres_da_equipe

Mostra o estabelecimento do proprietário autenticado, o papel dele e o que essa conexão permite fazer, junto com os serviços oferecidos e a equipe. É a origem dos identificadores de serviço e de profissional, e dispensa qualquer link ou endereço: todas as demais ferramentas já operam neste estabelecimento.

consultar_meu_estabelecimento

Registra que o cliente não compareceu. Isso aumenta o contador de faltas dele e, ao atingir o limite configurado no estabelecimento, bloqueia novos agendamentos online dessa pessoa. É irreversível por esta ferramenta.

registrar_falta