acknowledge_cycle_renewal
ChatGPTEquivale ao Entendi do aviso no Visitta. Antes de usar, consulte list_cycles com status renewal_pending (se disponível) ou get_cycle_coverage, apresente nome e período de cada ciclo pendente e peça confirmação explícita. Envie somente os visit_cycle_ids apresentados e confirmados, até 100. Persiste o reconhecimento no app; não cria ciclo, confirma datas, altera médicos ou registra visitas. A origem automática permanece. Retentativas são seguras. Se o app já estiver aberto, oriente atualizar a página. Sem esta ferramenta, use Início → aviso do ciclo → Entendi no Visitta.
assign_place
ChatGPTApós confirmação de preview_assign_place, vincula somente os médicos aprovados ao local existente. Envie os mesmos place_id e client_ids com preview_token. Substitui vínculos anteriores, endereço e coordenadas pelos do local, mantendo complementos. Não cria locais, apaga médicos ou altera horários, ciclos, roteiros e visitas salvos. A localização nova vale para os próximos planejamentos. Consulte antes de repetir uma gravação incerta.
change_visit_location
ChatGPTUse quando a representante disser que vai encontrar o médico em outro endereço dele naquele dia. Consulte get_client_details para os locais (locations) e envie client_location_id com o id do local, ou null para voltar ao endereço principal. Apresente médico, roteiro e o novo endereço e peça confirmação. A navegação passa a apontar para o novo endereço; a ordem e os horários previstos só mudam na próxima ordenação ou geração do roteiro. Local arquivado ou de outro médico é recusado.
complete_visit
ChatGPTUse somente quando a representante confirmar que a visita foi realizada. Atualiza a execução da visita e registra a cobertura quando aplicável.
create_clients
ChatGPTUse somente depois que a representante confirmar a prévia. Envie exatamente os mesmos registros da prévia com o preview_token recebido. Cadastra os médicos novos, ignora duplicados e inválidos, e localiza cada endereço uma única vez. Médicos sem localização precisa ficam pendentes e só entram em roteiros depois que a localização for revisada no app pelo location_url. Envie visit_cycle_id do suggested_cycle somente se a representante pedir para incluir os médicos no ciclo. Não altera nem apaga médicos existentes.
create_itinerary
ChatGPTDepois da confirmação da prévia de criação, envie exatamente changes e preview_token aprovados. Com avisos aceitos na mesma confirmação, envie accept_conflicts=true: o horário é mantido como intenção, com pendências visíveis. Não repita a prévia nem a autorização sem mudança de intenção ou prévia expirada/inválida. Só anuncie criação depois do sucesso, com resumo curto e link retornado. Se a gravação for incerta, consulte antes de repetir. Não registra visitas realizadas.
create_place
ChatGPTCria somente o prédio ou consultório aprovado em preview_create_place. Envie os mesmos kind, name, parent_id ou from_client_id, confirm_new quando usado e preview_token. Apenas adiciona o local; não vincula nem altera médicos. Prévia expirada, desatualizada ou já aplicada exige nova consulta e prévia. Retorne o local e link somente após sucesso confirmado.
create_simple_itinerary
ChatGPTUse após confirmação explícita da prévia create de preview_simple_itinerary. Envie exatamente o mesmo changes e preview_token. Cria a sequência local por distância, sem ciclo nem horários; não gera agenda planejada ou visitas. Retorna o roteiro salvo e navegação. Se a prévia já tiver sido salva ou o resultado for incerto, consulte list_simple_itineraries antes de tentar novamente. Não confunda a criação com uma consulta.
delete_simple_itinerary
ChatGPTUse somente após a pessoa confirmar explicitamente a prévia delete de preview_simple_itinerary, com nome do roteiro e médicos apresentados. Envie o mesmo simple_itinerary_id e preview_token. Exclui o roteiro simples e suas paradas. Não exclui médicos, visitas, roteiros planejados ou cobertura. Se a pessoa só pediu para tirar um médico, use a prévia update e update_simple_itinerary.
find_nearby_clients
ChatGPTUse para encontrar médicos da conta no mesmo prédio, na mesma rua, no mesmo bairro ou perto de um médico de referência, por exemplo quando alguém faltou ou para aproveitar uma ida. Obtenha client_id em search_clients ou na agenda. relation é o nível mais amplo aceito: same_office (mesmo consultório cadastrado), same_building (mesmo prédio cadastrado, mesmo endereço ou até 25 m), same_street, same_neighborhood ou nearby (padrão, inclui os anteriores e quem estiver a até max_distance_meters em linha reta, padrão 2000). A comparação de endereço ignora acentos, abreviações e o tipo de logradouro; straight_line_meters usa as coordenadas salvas e pode ser impreciso. Filtros: specialty, pending_only (só pendentes no ciclo) e date (AAAA-MM-DD, padrão hoje) para disponibilidade. Cada médico traz cycle_status (pending, planned com planned_on, visited, outside_cycle ou no_cycle), disponibilidade e janelas na data e, quando o roteador responde, tempo de carro desde o médico de referência. Até 25 resultados; truncated indica que há mais. Não altera dados; para trocar uma visita do roteiro, use get_visit_alternatives e replace_visit.
get_client_catalog
ChatGPTUse antes de preparar um cadastro ou uma correção de especialidades para conhecer as especialidades e os mercados disponíveis na conta. Use somente esses valores; não invente especialidades nem mercados.
get_client_details
ChatGPTUse para consultar endereço, coordenadas, contatos, CRM, especialidades, mercados, horários de visita e situação comercial de um médico da sua conta. Obtenha client_id em search_clients; não adivinhe identificadores.
get_cycle_coverage
ChatGPTUse para consultar o ciclo em andamento: total de médicos do ciclo prontos para roteiro, visitados, pendentes, percentual de cobertura e dias úteis restantes. pending_clients lista os médicos que faltam visitar, com dias sem visita quando disponível; com list visited, visited_clients lista os visitados, com a data e a origem (itinerary ou manual); aceita city e use next_cursor como after_id para continuar. Sem ciclo em andamento, cycle vem nulo: oriente a criar o ciclo no calendário comercial do app. Se automatically_created for verdadeiro, conte que o ciclo foi criado automaticamente a partir de renewed_from e pode ter as datas ajustadas no app. Não altera dados.
get_help
ChatGPTUse para explicar como usar o Visitta no ChatGPT ou no site. Sem topic, retorna o índice; com topic, retorna passos no ChatGPT, passos no app e URLs reais. Ajuda pública, sem dados da conta e sem necessidade de conexão. As ferramentas citadas podem ainda não estar disponíveis nesta conexão: use o procedimento web como alternativa. Não inicia tour nem altera dados.
get_itinerary
ChatGPTConsulta a sequência, origem escolhida/sugerida, compromissos, data, previsões e avisos reais de um roteiro. time_details distingue horário manual, estimado e ausente, compatibilidade com a agenda e janelas do médico; warnings contém mensagens localizadas. status unscheduled significa sem encaixe, nunca omita essa visita. complete=false indica conferência parcial, não ausência de conflitos. Use id, nunca legacy_simple_itinerary_id, para continuar. Não altera dados.
get_itinerary_details
ChatGPTUse para consultar a agenda salva, endereços, ordem, previsão de chegada, duração, distância, conclusão e link de navegação de cada visita. Aceita navigation_provider como waze ou google_maps; sem esse argumento, usa a preferência da conta. Obtenha itinerary_id em list_upcoming_itineraries. Retorna até 100 visitas; use next_position como after_position para continuar. Preserve os estados retornados: visita não agendada não é compromisso confirmado. Não recalcula a rota.
get_setup_status
ChatGPTUse para orientar como começar conforme os dados reais da conta: médicos preparados, ciclo, roteiro e primeira visita. Retorna progresso, próxima etapa e URLs. Não inicia tour nem marca etapas como concluídas. Para explicações gerais, use get_help quando disponível.
get_simple_itinerary_details
ChatGPTConsulta um roteiro simples, rápido ou fora de ciclo: saída, médicos na ordem salva, endereços, distâncias aproximadas e links Waze/Google Maps. Obtenha simple_itinerary_id em list_simple_itineraries ou na criação; nunca use IDs de roteiros planejados. Até 100 paradas; use next_position como after_position. Não calcula horários, trânsito, cobertura nem registra visitas. A distância é uma estimativa local; available=false indica médico que precisa de revisão antes de reordenar.
get_today_itinerary
ChatGPTUse para consultar os roteiros de hoje, o progresso, a próxima visita e seus links de navegação. Aceita navigation_provider como waze ou google_maps; sem esse argumento, usa a preferência da conta.
get_visit_alternatives
ChatGPTUse quando uma visita pendente do roteiro não puder acontecer (médico ausente, consultório fechado, atraso) para obter quem pode ocupar o lugar dela. Obtenha itinerary_id e visit_id em get_today_itinerary ou get_itinerary_details. Retorna até 5 médicos do ciclo ainda não visitados nem planejados em outro roteiro, que atendem no horário e cabem antes da próxima visita, ordenados como em Resolver imprevisto no Visitta (deslocamento adicional, prioridade e dias sem visita), com chegada prevista, deslocamento, local de atendimento e a relação com o médico ausente: same_office (mesmo consultório cadastrado), same_building (mesmo prédio cadastrado, mesmo endereço ou até 25 m), same_street, same_neighborhood, nearby (até 2 km) ou farther. relation restringe a esse nível de proximidade ou mais perto; limit vai de 1 a 5 (padrão 3). recommended_action indica se trocar compensa ou se é melhor só pular. Apresente as opções e a recomendação; para trocar, peça confirmação e use replace_visit; para não substituir, use skip_visit. Não altera a agenda.
list_cycles
ChatGPTUse para descobrir ciclos atuais, futuros, anteriores ou avisos de renovação pendentes. status: all, current, upcoming, past ou renewal_pending; até 25 por página, use next_page. Retorna datas, origem automática, reconhecimento e URLs para ver/ajustar o ciclo. Não cria ciclos nem calcula cobertura histórica. Só apresente aviso de renovação se renewal_notice_pending for true; a origem automática é preservada após Entendi.
list_incomplete_clients
ChatGPTUse para saber quais médicos ativos ainda precisam de ajuste e por quê: endereço sem rua ou sem número, localização não confirmada, sem especialidade, sem mercado ou fora do ciclo sugerido. summary traz o total por motivo e reason_labels o nome de cada motivo. Aceita reason e city para filtrar; use next_cursor como after_id para continuar. Se suggested_cycle vier nulo, a conta não tem ciclo em andamento nem futuro; se automatically_created for verdadeiro, conte que o ciclo foi criado automaticamente. Não altera dados.
list_itineraries
ChatGPTLista roteiros da conta, com ou sem agenda e cobertura do ciclo, incluindo os antigos roteiros simples. Até 25 por página. Não use o nome do tipo como filtro. Não misture IDs antigos: legacy_simple_itinerary_id é referência da origem; use id para este fluxo. Não altera dados.
list_pending_visit_reviews
ChatGPTUse para encontrar roteiros de dias anteriores com visitas que não foram concluídas nem puladas. Para cada visita, pergunte o que aconteceu e use complete_visit se foi realizada ou skip_visit se não foi. Retorna até 10 roteiros por página; use next_page como page para continuar. Não altera dados.
list_places
ChatGPTUse para encontrar prédios (empresariais, centros médicos, hospitais) e consultórios cadastrados na conta e quantos médicos estão vinculados a cada um. query busca pelo nome, ignorando acentos, palavras genéricas (clínica, consultório, centro médico) e sala ou andar. Consultórios vêm logo depois do prédio onde ficam, com building preenchido. Até 25 por página; use next_page. Para saber o local de um médico, get_client_details já traz place. Não altera dados.
list_saved_locations
ChatGPTUse para escolher a saída de um roteiro simples, rápido ou fora de ciclo. Lista os pontos salvos da conta, com ID, nome, endereço, coordenadas e usable_as_start. Até 25 por página; use next_page. Use apenas pontos com localização válida. Não deduza a localização atual da pessoa a partir destes pontos e não invente coordenadas. Não altera dados.
list_simple_itineraries
ChatGPTUse quando a pessoa pedir um roteiro simples, rápido, avulso ou fora de ciclo já salvo. São sequências de deslocamento independentes de ciclos e de agenda por horários. query busca pelo nome salvo do roteiro ou nome/CRM de um médico nele; não envie simples, rápido ou fora de ciclo como filtro de nome apenas por serem o tipo pedido. Sem query, lista os mais recentes; até 25 por página, use next_page. Retorna IDs próprios de roteiros simples e links. Para agendas planejadas com horários, use list_upcoming_itineraries. Não altera dados.
list_upcoming_itineraries
ChatGPTUse para consultar roteiros salvos da sua conta por período, em ordem de data e horário. Sem datas, consulta de hoje até 30 dias à frente no fuso do Visitta. Datas AAAA-MM-DD; intervalo máximo de 90 dias. Retorna até 25 por página; use next_page para continuar. Não gera nem otimiza roteiros.
preview_assign_place
ChatGPTPrepara somente vincular de 1 a 25 médicos a um local existente, sem gravar. Informe place_id de list_places e client_ids consultados. Mostra local, médicos, endereços antes/depois e distância. Vincular substitui o local, endereço e coordenadas do médico, mantendo sala/andar. Destaque far true, que indica distância acima de 200 m. Peça confirmação da proposta antes de assign_place. Para retirar vínculo, use preview_unassign_place.
preview_client_specialties
ChatGPTUse para corrigir as especialidades de até 25 médicos existentes por lote. Consulte get_client_catalog primeiro e use os nomes completos exatamente como retornados; nunca adivinhe o significado de siglas ambíguas. Obtenha client_id pela busca e envie records com client_id e specialties, a lista completa de especialidades corretas de cada médico. Essa lista substituirá as especialidades atuais, removendo as que forem omitidas. Mostre from e to de cada médico e peça confirmação explícita do lote antes de salvar. Não cadastre os médicos novamente. Não altera dados nem consulta mapas.
preview_client_update
ChatGPTUse para revisar uma alteração em um médico existente antes de salvar. Obtenha client_id em search_clients ou list_incomplete_clients. Para trocar só as especialidades de vários médicos, use preview_client_specialties em lotes de até 25, em vez de uma prévia por médico. Em changes, envie somente o que a representante pediu para mudar; campos ausentes não mudam. Para completar o endereço, envie apenas os campos informados, como só number. Nunca invente, complete ou estime endereços, números, CEPs ou coordenadas. Use number "S/N" somente quando a representante disser que o endereço não tem número. Em schedule, cada dia enviado substitui os horários daquele dia (lista vazia = sem atendimento) e os demais dias não mudam. Use unavailable_period (from e to, AAAA-MM-DD, até 62 dias a partir de hoje) para ausências como férias, special_dates para horário diferente em uma data e clear_exceptions para desfazer essas exceções. Se houver o aviso affects_scheduled_visits, informe que os roteiros já criados não mudam. Mostre cada mudança (from e to) e peça confirmação explícita antes de salvar. Não altera dados.
preview_clients
ChatGPTUse para validar até 25 médicos antes de cadastrar. Para especialidades, consulte get_client_catalog e envie os nomes completos do catálogo; confirme siglas ambíguas com a representante e não omita especialidades sem autorização. Para corrigir especialidades de médicos já cadastrados, use preview_client_specialties em lotes, sem cadastrá-los novamente. Transcreva nome, CRM, endereço, especialidades, mercados e contatos exatamente como a representante informou, separando rua, número, complemento, bairro, cidade e UF. Nunca invente, complete ou estime endereços, números, CEPs ou coordenadas: pergunte o que faltar, principalmente o número. Use number "S/N" somente quando a representante disser que o endereço não tem número; se ela não souber o número, deixe number vazio. Não altera dados nem consulta mapas. Mostre o resultado de cada médico e peça confirmação explícita antes de salvar. Se houver suggested_cycle, pergunte se os novos médicos devem entrar nesse ciclo; se ele vier nulo, a conta não tem ciclo em andamento nem futuro: não peça um identificador, oriente a criar o ciclo no calendário comercial do app. Se automatically_created for verdadeiro, conte que o ciclo foi criado automaticamente a partir do anterior e que as datas podem ser ajustadas no app. Se a representante informar horários, envie schedule com a semana inteira: para cada dia com atendimento, weekday (0 = domingo a 6 = sábado) e windows com starts_at e ends_at (HH:MM) e rule attendance (horário de atendimento) ou visit (horário em que recebe representantes); dias omitidos ficam sem atendimento. Sem schedule, vale o horário padrão de segunda a sexta, das 08:00 às 12:00 e das 14:00 às 17:00.
preview_create_place
ChatGPTPrepara somente a criação de um prédio ou consultório, sem gravar nem vincular médicos. Informe kind building ou office e name sem sala/andar. Consultório dentro de prédio usa parent_id consultado em list_places; prédio ou consultório independente usa from_client_id de um médico consultado naquele endereço, cuja localização será copiada. Não invente endereço ou coordenadas. Se similar tiver resultados, apresente os existentes e prefira um deles; só use confirm_new true em uma nova prévia quando a pessoa confirmar que é outro local. Confirme a proposta antes de create_place. Para vincular médicos, use separadamente preview_assign_place/assign_place.
preview_itinerary
ChatGPTConstrua por etapas usando o que a pessoa já disse, inclusive por voz. Sem itinerary_id prepara criação; com ID prepara edição. visits substitui a lista inteira: consulte o roteiro e preserve médicos, compromissos, conclusões e required_for_planning não alterados. Todo roteiro novo recebe a data de hoje no fuso do Visitta quando date é omitido; a prévia devolve o dia em after.date. Uma data informada tem prioridade. Para mudar o dia depois, envie date em AAAA-MM-DD; omitir em edição mantém o dia salvo, e null não é permitido. Não pergunte a data se a pessoa não pediu outro dia. Lista básica e horários individuais são opcionais; não exija saída/jornada para começar. Fora do ciclo significa counts_toward_cycle=false; omitir preserva o valor salvo ou o padrão de criação. appointment_starts_at fixa a chegada só neste roteiro; com appointment_ends_at define janela. Para liberar o horário, envie ambos null. duration_minutes é duração. Não altere a agenda global. planning_action fill completa a lista, inclusive vazia, preservando escolhas e horários; order ordena os médicos atuais pelo planejador; schedule calcula horários, preservando ordem quando order_mode=manual. Combine médicos, horários e fill na mesma prévia quando pedidos juntos. Sem ação, não preencha automaticamente. order_mode=manual mantém a lista; fill/order podem mover visitas sem compromisso. Fill/order usam jornada 08:00–18:00 nos campos em branco e os padrões salvos de locais/cidade; planning informa exatamente os padrões aplicados e os médicos acrescentados. Peça só os dados de recovery que faltam para a ajuda solicitada. Use IDs consultados; esclareça nomes ou horários ambíguos sem inventar. Resuma alterações, compromissos e avisos em poucas frases, sem ler a lista inteira nem cada estimativa. Sugira um próximo passo útil quando necessário. Se houver conflitos, ofereça manter o horário ou ajustar/reorganizar; não corrija nem remova escolhas silenciosamente. A prévia não grava. Peça uma confirmação curta para salvar a proposta atual; inclua a aceitação dos avisos nessa mesma pergunta. Após aprovação, use create_itinerary/update_itinerary com os mesmos changes e token, sem pedir confirmação repetida.
preview_simple_itinerary
ChatGPTPrepara roteiro simples, rápido, avulso ou fora de ciclo sem gravar. operation: create, update, reorder_by_distance ou delete. Para create, changes exige client_ids dos médicos ativos com localização confirmada e starting_point escolhido: current_location com coordenadas fornecidas pela pessoa, ou saved_location com ID de list_saved_locations. Nunca invente localização atual; se ela não estiver disponível, peça um ponto salvo ou use o app. name é opcional. Para update, envie simple_itinerary_id consultado e só as mudanças: nome (null restaura o padrão), saída e/ou lista completa de client_ids na ordem desejada (vazia remove todas as paradas). create e reorder_by_distance calculam ordem local; update preserva a ordem enviada. Para reorder_by_distance ou delete, envie apenas o ID, sem changes. Mostre before/after com nomes dos médicos, saída, ordem e remoções e peça confirmação explícita antes da ferramenta de gravação correspondente. Até 100 médicos. Não exige ciclo, não considera horários, não chama mapas e não registra visitas ou cobertura.
preview_unassign_place
ChatGPTPrepara somente retirar o vínculo de 1 a 25 médicos com seus locais atuais, sem gravar. Informe apenas client_ids consultados; confira os vínculos atuais com get_client_details. A retirada mantém o endereço e as coordenadas do médico e não apaga o local. Mostre os médicos e seus vínculos atuais, e confirme antes de unassign_place.
record_visits
ChatGPTUse quando a representante disser que visitou médicos. Se ela não disser quando, pergunte se foi hoje ou em outro dia e envie visited_on (AAAA-MM-DD, até hoje). Se houver roteiro nessa data, cada médico entra nele como visita concluída (added_to_itinerary) ou tem a visita que já estava no roteiro concluída (completed_in_itinerary), sem recalcular a rota; se houver mais de um roteiro no dia, o resultado traz itineraries_to_choose: pergunte qual e envie itinerary_id. Sem roteiro na data, a visita conta só na cobertura do ciclo que contém a data, para médicos do ciclo, ativos e prontos para roteiro. Para desfazer, use reopen_visit nas visitas de roteiro e remove_manual_visits nos registros sem roteiro. Confirme médicos e data antes de usar.
remove_manual_visits
ChatGPTUse quando a representante disser que registrou por engano uma visita feita fora de roteiro. Remove esse registro do ciclo (o em andamento, sem visit_cycle_id), e a cobertura volta a contar o médico como pendente. Para descobrir quem foi registrado, use get_cycle_coverage com list visited. Quando a visita veio de um roteiro, o resultado é from_itinerary com itinerary_id e visit_id: use reopen_visit. Confirme os médicos antes de usar.
reopen_visit
ChatGPTUse quando a representante disser que uma visita foi marcada como concluída por engano. Remove a conclusão e o registro de cobertura dessa visita, que volta a ficar pendente. Para visitas registradas fora de roteiro, use remove_manual_visits. Confirme antes de alterar.
reorder_itinerary
ChatGPTUse somente com uma ordem explícita de todas as visitas ativas. A alteração modifica o roteiro salvo e exige confirmação da representante.
reorder_simple_itinerary_by_distance
ChatGPTUse após confirmação explícita da prévia reorder_by_distance de preview_simple_itinerary. Envie o mesmo simple_itinerary_id e preview_token. Reordena todos os médicos já salvos pela estimativa local de menor deslocamento a partir da saída salva. Não adiciona nem remove médicos; não consulta Google, ruas reais, trânsito, horários ou ciclos. Retorna a sequência salva.
replace_visit
ChatGPTUse para trocar uma visita pendente que não vai acontecer por um dos médicos retornados em get_visit_alternatives para essa mesma visita. Apresente o médico ausente, o substituto, a chegada prevista e o deslocamento adicional e peça confirmação. Envie o motivo (doctor_absent: médico ausente; unavailable: indisponível; later_today: tentar mais tarde; other: outro). O substituto ocupa a posição da visita original, que fica no histórico como substituída; a conclusão do substituto continua dependendo de complete_visit. Se o médico deixou de caber, consulte as alternativas de novo. Confira a agenda atualizada depois.
reschedule_visit
ChatGPTUse quando a representante informar uma nova janela de horário para a visita. Informe horários no formato HH:MM e confirme antes de alterar o roteiro.
restore_visit
ChatGPTUse para retomar uma visita que foi pulada, quando ela ainda puder voltar ao roteiro. Peça confirmação antes de alterar.
search_clients
ChatGPTConsulta médicos do representante autenticado por nome, CRM ou filtros de cidade, mercado, especialidade e situação ativa. Use next_cursor como after_id para obter a próxima página. Informe pelo menos um critério de busca.
set_cycle_membership
ChatGPTUse para incluir (add) ou remover (remove) até 100 médicos de um ciclo. Sem visit_cycle_id, usa o ciclo sugerido (em andamento ou o próximo); se não houver ciclo, não peça um identificador: oriente a criar o ciclo no calendário comercial do app. Obtenha os client_ids em list_incomplete_clients ou search_clients. Médicos inativos não são incluídos; remover do ciclo não apaga visitas já registradas. Mostre quais médicos e qual ciclo serão alterados e peça confirmação antes de usar.
skip_visit
ChatGPTUse quando uma visita não puder ser realizada. Informe o motivo e confirme antes de alterar o roteiro.
unassign_place
ChatGPTApós confirmação de preview_unassign_place, retira somente os vínculos aprovados. Envie os mesmos client_ids e preview_token. Mantém os médicos, seus endereços e coordenadas, os locais e o histórico. Não vincula a outro local nem altera horários, ciclos, roteiros ou visitas. Consulte antes de repetir uma gravação incerta.
update_client
ChatGPTUse somente depois que a representante confirmar a prévia de preview_client_update. Envie exatamente o mesmo client_id e changes com o preview_token recebido. Se o endereço mudar, a localização é refeita uma única vez; sem localização precisa, o médico fica fora dos roteiros até a localização ser revisada no app pelo location_url. active false desativa o médico sem apagar o histórico. Não apaga médicos.
update_client_specialties
ChatGPTUse somente após a representante confirmar a prévia de preview_client_specialties. Envie os mesmos records e o preview_token recebido. Substitui apenas as especialidades de até 25 médicos, preservando os demais dados e o histórico. Se houver dados inválidos ou a prévia estiver desatualizada, nenhum médico do lote é alterado. Use lotes completos para corrigir bases grandes. Não cadastre novamente médicos existentes.
update_itinerary
ChatGPTDepois da confirmação da prévia de edição, envie o mesmo itinerary_id, changes e preview_token. Preserve escolhas, sugestões e compromissos; para voltar ao automático limpe início e fim do compromisso. Com avisos aceitos, envie accept_conflicts=true; não altere silenciosamente os horários para evitar avisos. Não modifica agenda global nem reclassifica conclusões anteriores no ciclo. Confirme em poucas palavras apenas as alterações salvas e o link. Consulte antes de repetir uma gravação incerta.
update_simple_itinerary
ChatGPTUse após a pessoa confirmar a prévia update de preview_simple_itinerary. Envie o mesmo simple_itinerary_id, changes e preview_token. Permite renomear, trocar a saída, adicionar/remover médicos e reordenar manualmente. client_ids substitui a lista completa; preserve todos os médicos que a pessoa não pediu para remover e envie a ordem inteira revisada. Lista vazia deixa o roteiro sem paradas. Recalcula somente distâncias locais, preservando a ordem informada. Consulte o resultado salvo. Não altera roteiros planejados, visitas ou ciclos.
