GOL

Confirma uma intenção de check-in preparada e altera a reserva do passageiro na GOL. Requer a intenção preparada por start_checkin e uma chave de idempotência estável; repetir com a mesma chave devolve o mesmo resultado. Devolve o status final do check-in, com assento e cartão de embarque, que o widget mostra.

confirm_checkin

Consulta os cartões de embarque por intenção, tripRef ou PNR/e-ticket (origem opcional): o card desenha o cartão completo, com o QR válido para embarcar, e o resultado traz o trecho e o passageiro de cada cartão. Usa a leitura rápida e não confirma de novo um check-in já concluído. Sem PNR, e-ticket ou tripRef ('me dá meu cartão de embarque'), kind "auto" pega a próxima viagem elegível da conexão autenticada. Para um trecho específico ('cartão da volta', 'o da ida', 'saindo de X'), kind "manual" com o pnr e, em origin, o aeroporto de onde esse trecho sai (de list_trips ou de um card anterior); kind "auto" pega o voo que sai primeiro, quase sempre a ida. Quando get_trip_overview trouxe legs em vez de pnr, kind "trip_ref" com o tripRef do leg pedido ("ida" ou "volta"). Quando o check-in ainda não foi feito, o resultado informa que não há cartão. Os horários do resultado são UTC; o widget mostra o horário local.

get_boarding_passes

Mostra no card os dados cadastrais do cliente logado: nome, data de nascimento, gênero, nacionalidade, CPF e documentos (mascarados), e-mails, telefones, endereços e contato de emergência. Serve para pedidos como 'meus dados', 'meu cadastro', 'meu e-mail cadastrado', 'meu telefone', 'meu endereço' ou 'meu contato de emergência'. Os valores aparecem só no card; o resultado informa apenas o que está preenchido (filled), com contagem 0 ou false para o que falta. Somente leitura: a alteração é feita no botão 'Alterar dados' do card, que abre o site da Smiles. Não traz número Smiles, categoria nem saldo de milhas (esses vêm de get_miles_balance). Uma chamada por pedido; um pedido novo, em outra mensagem, corresponde a uma chamada nova. Um pedido que junta dados cadastrais e saldo de milhas ('meus dados e milhas') tem duas partes, e o saldo vem de get_miles_balance.

get_my_personal_data

Consulta o saldo de milhas disponível e a categoria Smiles (Smiles, Prata, Ouro, Diamante ou Magno) da conexão autenticada; a categoria vem nula quando a GOL não informa. Cotação das milhas em reais, metas e benefícios de cada categoria ficam fora do resultado e deste app, no app ou no site da Smiles. O saldo pode mudar a qualquer momento: cada pedido do passageiro, em outra mensagem, corresponde a uma chamada nova, mesmo quando a pergunta se repete. Uma chamada por pedido; um pedido que junta saldo e dados cadastrais ('meus dados e milhas') tem duas partes, e os dados vêm de get_my_personal_data.

get_miles_balance

Consulta, na base de status de voos da própria GOL, o status ao vivo de um voo GOL pelo número do voo (só os dígitos, como 1024) e pela data de partida: no horário, atrasado, em voo, pousado, cancelado ou desconhecido, com os horários previstos e estimados e o portão e o terminal quando a GOL informa. Mostra o card do voo, com o horário local. Serve para perguntas de status, atraso, horário ou portão de um voo GOL (G3), inclusive de um voo das reservas do passageiro. Não agrega os trechos de uma reserva: para isso existe get_trip_overview. Status e portão mudam a qualquer momento; cada pedido corresponde a uma consulta nova.

get_flight_status

Consulta ou reconcilia o estado de uma intenção de check-in da conexão autenticada. O status pode mudar entre uma chamada e outra; cada pedido do passageiro corresponde a uma consulta nova. O estado 'prepared' é uma revisão que aguarda o toque do passageiro em Confirmar check-in; consultar o estado não confirma nada. O widget mostra o estado atual.

get_checkin_status

Responde, numa única chamada, se está tudo certo para a viagem: reserva, check-in, assento, status de voo por trecho e risco de conexão, num card. Sem PNR, e-ticket ou tripRef, kind "auto" pega a próxima viagem. É também a tool de "próxima viagem", "meu próximo voo", "minha viagem" e "qual é o meu voo?" (kind "auto", um card só) e de pergunta com dia da semana ('meu voo de sexta', 'tenho voo segunda?'), também com kind "auto": o resultado traz o item de cada dia em nextFlightsByWeekday.days, e flights vazio indica nenhum voo nesse dia. Para mensagem que é só um localizador de 6 letras/números, ou "ver reserva X", kind "manual" com o pnr (a origem é opcional; o servidor a encontra nas viagens da conta). O status muda entre perguntas, então cada pedido corresponde a uma consulta nova. Quando o resultado traz legs em vez de pnr, a viagem continua por kind "trip_ref" com o tripRef de legs (leg "volta" para o cartão ou o check-in da volta, shown para a que o card mostra); ref não encontrada pede o código da reserva. Sem pnr no resultado, localizador, rota e horários estão no card.

get_trip_overview

Devolve os canais oficiais de atendimento da GOL (telefone, WhatsApp, e-mail e link) para o passageiro tocar e falar com uma pessoa. Serve para pedidos fora do que as outras tools cobrem (reembolso, remarcação de voo, bagagem extraviada, reclamação, dúvida sobre regra ou política) e para quando o passageiro pede ajuda humana. Não cobre comprar ou alterar passagem, escolher ou trocar assento, bagagem (franquia, bagagem extra, preço), cancelar viagem, nem transferir, comprar ou resgatar milhas: o app não faz isso e a GOL trata no app e no site, então esses pedidos não têm canal aqui. Pode ser chamada sem argumentos; com uma reserva na conversa, o localizador faz o contato já sair identificado. A lista pode vir vazia quando não há canal oficial configurado.

get_support_contacts

Lista as reservas/PNRs futuras da conta, agrupando jornadas e conexões, e mostra o card de viagens. Serve para pedidos sobre as viagens, reservas ou voos do passageiro no plural: 'minhas viagens', 'próximas viagens', 'tenho viagem marcada?', 'quais voos eu tenho', 'minhas reservas'. Para UMA viagem sem nome ('próxima viagem', 'meu próximo voo', 'qual é o meu voo?') e para pergunta com dia da semana ('meu voo de sexta', 'tenho voo segunda?'), a tool é get_trip_overview com kind 'auto', que mostra um card só. Uma chamada por pedido: o card é a resposta, e um pedido novo, em outra mensagem, corresponde a uma chamada nova. Conta sem viagens também mostra o card (vazio). As reservas vão só para o card, com trechos, datas e horários completos; o resultado traz só os códigos e quantas são. Os detalhes de uma reserva citada pelo código vêm de get_trip_overview com kind 'manual' e o pnr. A lista traz só viagens futuras; viagens passadas não aparecem.

list_trips

Devolve a frase pronta para os pedidos que este app não atende: busca de voos, horários e preço de passagem por rota, compra ou alteração de passagem, escolha de assento, bagagem (franquia, mala extra e preço), valor das milhas em reais, metas e benefícios de cada categoria Smiles, extrato de milhas, transferência, compra ou resgate de milhas. A frase indica o app ou o site da GOL ou da Smiles e é a resposta inteira ao passageiro, sem pergunta de data, rota ou aeroporto e sem busca na web. Não consulta a GOL e não serve para saldo de milhas, categoria atual, viagens, check-in, cartão de embarque, status do voo nem atendimento humano (reembolso, remarcação, bagagem extraviada, reclamação), que têm tool própria.

answer_out_of_scope