Fluxos de Conversa — Modo Somente Orçamento¶
Cenário:
ENABLE_BOOKING=false/ENABLE_PAYMENT=falseO agente Trip opera no modo de descoberta + cotação, sem criar reservas ou processar pagamentos.
Visão Geral dos Agentes Ativos¶
| Agente | Disponível | Função |
|---|---|---|
discovery_agent |
✅ | Busca e apresenta experiências, guias, transfers, tickets |
quote_agent |
✅ | Cotações com ou sem data definida, conversão de moeda |
itinerary_agent |
✅* | Roteiros dia a dia (*somente para agências/admins autenticados) |
custom_tour_agent |
✅ | Qualificação de tours personalizados |
utils_agent |
✅ | Envio de email, geração de CSV/planilha |
support_agent |
✅ | Escalonamento para consultor humano via WhatsApp |
booking_info_agent |
✅ | Consulta de reservas existentes (somente leitura) |
faq_agent |
✅ | Perguntas sobre a plataforma iFriend |
research_agent |
✅ | Pesquisa web (clima, eventos, dicas em tempo real) |
booking_agent |
🚫 | Desabilitado — criação de novas reservas |
payment_agent |
🚫 | Desabilitado — pagamentos online |
Fluxo 1 — Busca de Produto por Destino¶
Agente responsável: discovery_agent
Usuário: Quero ver passeios em Barcelona para julho
Agente: [busca_produtos executada silenciosamente]
Encontrei 8 opções em Barcelona! 🌟
1. **Tour Sagrada Família ao Amanhecer** — A partir de € 45,00 | ID: 10234
Visita guiada exclusiva antes da abertura ao público.
🔗 theifriend.com/p/10234
2. **Bicicleta pelo Bairro Gótico** — A partir de € 28,00 | ID: 10235
Passeio de bike com guia local por ruelas medievais.
🔗 theifriend.com/p/10235
3. **Cata de Vinhos na Bodega Familiar** — A partir de € 55,00 | ID: 10236
...
Qual dessas opções te interessa mais? 🎯
Usuário: Me conta mais sobre o primeiro
Agente: [detalhes_experience + disponibilidade_calendario executados]
**Tour Sagrada Família ao Amanhecer** | ID: 10234
Duração: 2h30 · Idiomas: PT, EN, ES
📅 Datas disponíveis em julho:
03/07, 10/07, 17/07, 24/07, 31/07
🔗 theifriend.com/p/10234
Para qual data e horário você gostaria? 📅
Fluxo 2 — Cotação com Data Definida¶
Agente responsável: quote_agent
Usuário: Quero o preço do tour ID 10234 para 10 de julho,
somos 2 adultos e 1 criança de 8 anos
Agente: [tem_variacao → listar_variacoes → calcular_preco executados silenciosamente]
💶 **Cotação — Tour Sagrada Família ao Amanhecer**
📅 10/07/2026 · Horário: 07h00
| Faixa etária | Qtd | Valor unit. | Subtotal |
|--------------|-----|-------------|-----------|
| Adulto | 2 | € 45,00 | € 90,00 |
| Criança (−12)| 1 | € 28,00 | € 28,00 |
| **Total** | | | **€ 118,00** |
~R$ 680,00 na cotação de hoje
🔗 theifriend.com/p/10234
Posso enviar esse orçamento por email para você? ✉️
Fluxo 3 — Cotação Estimada (sem data)¶
Agente responsável: quote_agent
Usuário: Quanto custa esse tour em média?
Agente: [tem_variacao → listar_variacoes executados com base no preço do catálogo]
📋 **Orçamento Estimado — Tour Sagrada Família ao Amanhecer**
- Adulto: a partir de € 45,00/pessoa
- Criança (até 12 anos): a partir de € 28,00/pessoa
- Estimativa para 2 adultos + 1 criança: ~€ 118,00 (~R$ 680,00)
⚠️ Valor estimado com base no catálogo. O preço final é confirmado
ao selecionar a data e o horário.
Deseja verificar disponibilidade para uma data específica? 📅
Fluxo 4 — Tentativa de Reserva (booking desabilitado)¶
Agente responsável: root_agent (orquestrador trata diretamente)
Usuário: Quero reservar esse tour!
Agente: Ótimo! No momento, as reservas diretas pelo chat não estão disponíveis
neste canal.
Você pode:
- 💬 **Falar com um consultor** que finaliza a reserva por você — é só me pedir
- 📧 **Receber o orçamento por email** para apresentar ao seu cliente
O que prefere? 😊
Fluxo 5 — Roteiro Multi-Destino¶
Agente responsável: itinerary_agent (disponível para agências/admins)
Usuário: Monte um roteiro de 7 dias: 3 dias em Lisboa e 4 dias no Porto
Agente: [busca_produtos para Lisboa + busca_produtos para Porto executados]
## 🗺️ Roteiro: Lisboa (3 dias) + Porto (4 dias)
### 📍 Lisboa — 3 dias
**Dia 1**
1. **Passeio pelo Alfama e Fado ao Vivo** — A partir de € 35,00 | ID: 20110
🔗 theifriend.com/p/20110
2. **Tuk-tuk pelos Miradouros** — A partir de € 22,00 | ID: 20115
🔗 theifriend.com/p/20115
**Dia 2**
...
### 📍 Porto — 4 dias
...
### 💡 Dicas
- Trem Lisboa → Porto: ~3h, recomendado sair cedo no Dia 4
- Agrupe atividades por bairro para economizar deslocamento
Deseja orçamento para algum desses produtos? 💶
Fluxo 6 — Tour Personalizado / Sob Medida¶
Agente responsável: custom_tour_agent
Usuário: Quero montar algo diferente para o meu grupo em Tóquio,
não quero tour de catálogo
Agente: Adoro esse tipo de pedido! 🎌 Vamos criar algo especial.
Me conta um pouco mais:
- Qual período vocês estão pensando para Tóquio?
Usuário: Março, provavelmente 8 a 14
Agente: Perfeito! Quantas pessoas viajam e qual é o perfil —
família, casal, amigos, grupo corporativo?
Usuário: Somos 6 amigos, faixa dos 30 anos, amantes de gastronomia
e cultura pop japonesa
Agente: Incrível combinação! Tenho uma ideia bem clara do perfil. 🍜🎮
Só mais uma coisa: vocês já foram ao Japão antes?
Usuário: Nunca, é a primeira vez de todos
Agente: [gerar_briefing_tour + gerar_formulario_suporte executados silenciosamente]
Briefing enviado para nossa equipe! Um consultor especialista
em Japão vai entrar em contato pelo WhatsApp para afinar os detalhes
e montar a proposta personalizada para vocês. 🙌
📲 wa.me/[número]?text=... #agente-ia
Posso te ajudar com mais alguma coisa?
Fluxo 7 — Envio de Orçamento por Email¶
Agente responsável: utils_agent
Usuário: Pode enviar esse roteiro de Barcelona para meu email?
Agente: Claro! Qual é o email do destinatário?
Usuário: cliente@agencia.com.br
Agente: [enviar_email_sendgrid executado com incluir_historico_conversa=True]
✅ Email enviado para **cliente@agencia.com.br** com o roteiro completo!
Posso te ajudar com mais alguma coisa?
Fluxo 8 — Geração de Planilha CSV¶
Agente responsável: utils_agent
Usuário: Me gera uma planilha com todos os produtos que você me mostrou
Agente: [gerar_csv executado com dados das buscas anteriores]
✅ Planilha gerada!
📊 [Download CSV](https://storage.googleapis.com/.../barcelona_produtos.csv)
Arquivo com 8 produtos · válido por 24h
Precisa de mais alguma coisa?
Fluxo 9 — Consulta de Reserva Existente¶
Agente responsável: booking_info_agent
Usuário: Quero ver o status da minha reserva
Agente: Claro! Preciso do número da reserva e do email usado no booking.
Usuário: Reserva BK-98765, email: joao@email.com
Agente: [obter_reserva executado]
📋 **Reserva BK-98765**
| Campo | Detalhe |
|--------------------|----------------------|
| Status | ✅ Confirmada |
| Pagamento | ✅ Pago |
| Experiência | Tour Alfama + Fado |
| Data | 15/05/2026 · 19h00 |
| Voucher | VCH-456789 |
| Total | € 90,00 |
Posso te ajudar com mais alguma coisa?
Nota: este agente é somente leitura — não cancela, altera ou cria reservas.
Fluxo 10 — Falar com Consultor Humano¶
Agente responsável: support_agent
Usuário: Quero falar com uma pessoa
Agente: [gerar_formulario_suporte executado]
Sem problema! Vou te conectar com um de nossos consultores. 👋
📲 Clique aqui para abrir o WhatsApp:
wa.me/[número]?text=Olá!+Preciso+de+ajuda+com... #agente-ia
Um consultor vai atender você em breve.
Fluxo 11 — Pergunta sobre a Plataforma (FAQ)¶
Agente responsável: faq_agent (via AgentTool)
Usuário: Como funciona o cancelamento de experiências?
Agente: A política de cancelamento da iFriend varia por produto:
- **Cancelamento gratuito**: a maioria das experiências permite
cancelamento até 48h antes da data
- **Não reembolsável**: produtos com essa tag não admitem reembolso
- O status fica visível no detalhe de cada produto
Para mais detalhes: theifriend.com/help-center/traveler
Posso te ajudar com mais alguma coisa?
Fluxo 12 — Dúvidas sobre um Produto Específico¶
Agente responsável: discovery_agent (detalhes) + root_agent (conhecimento geral)
Cobre perguntas como: o que está incluso, o que precisa levar, nível de dificuldade, restrições físicas, acessibilidade, idioma do guia, ponto de encontro, etc.
Usuário: Esse tour da Sagrada Família é adequado para crianças pequenas?
Minha filha tem 4 anos.
Agente: [detalhes_experience executado silenciosamente]
Sim, o **Tour Sagrada Família ao Amanhecer** é família-friendly! 👨👩👧
✅ Adequado para crianças de qualquer idade
✅ Sem caminhadas longas — percurso dentro do monumento (~1,5 km)
🧒 Crianças até 12 anos têm desconto na faixa etária infantil
🗣️ Guia disponível em português
📍 Ponto de encontro: entrada principal, Avinguda de Gaudí
Alguma dúvida específica sobre o passeio?
Usuário: Precisa de ingresso separado?
Agente: Não! O ingresso à Sagrada Família já está incluído no valor do tour.
Você não precisa comprar nada antecipadamente.
Quer que eu calcule o preço para vocês dois? 💶
Variação — Dúvida sobre restrição física / acessibilidade:
Usuário: Minha mãe usa cadeira de rodas. Esse passeio de bicicleta
pelo Bairro Gótico funciona para ela?
Agente: [detalhes_experience executado]
Infelizmente o **Passeio de Bicicleta pelo Bairro Gótico** requer
mobilidade plena — as ruas medievais têm irregularidades e o
percurso é feito 100% de bike. 🚫♿
Para quem tem mobilidade reduzida, tenho alternativas:
1. **Tuk-tuk pelo Bairro Gótico** — percurso coberto, sem esforço
físico, mesmos pontos turísticos | ID: 10238
🔗 theifriend.com/p/10238
2. **Tour a pé pelo Bairro Gótico (ritmo lento)** — guia adaptado,
calçadas acessíveis | ID: 10241
🔗 theifriend.com/p/10241
Quer detalhes de alguma dessas opções? 🎯
Variação — Dúvida sobre o que incluir / nível de dificuldade:
Usuário: Esse hiking no vulcão tem nível difícil? Nunca fiz trilha antes.
Agente: [detalhes_experience executado]
O **Trekking no Volcán Villarrica** tem classificação **moderado-difícil**:
- 🥾 Distância: ~8 km (ida e volta) · Desnível: ~1.100 m
- ⏱️ Duração: ~8h no total
- 🧊 Terreno: gelo e neve no trecho final — crampons fornecidos
- 💪 Condicionamento mínimo: conseguir caminhar 2h em aclive sem parar
**Incluso:** guia certificado, crampons, piolet, capacete e lanche.
**Não incluso:** transporte até o início da trilha.
⚠️ Para iniciantes sem preparo físico, o guia pode recomendar
interromper na metade — o retorno parcial também é permitido.
Quer que eu verifique disponibilidade para sua data? 📅
Fluxo 13 — Clima e Condições no Dia da Viagem¶
Agente responsável: research_agent (via AgentTool)
13a — Clima geral para o período da viagem¶
Usuário: Como está o clima em Amsterdã em abril?
Agente: Em abril, Amsterdã tem clima ameno e instável:
- 🌡️ Temperaturas entre 6°C e 14°C
- 🌧️ Chuvas frequentes (leve a moderada), ~12 dias de chuva no mês
- 🌸 Temporada das tulipas — Keukenhof aberto (março–maio)
- 💨 Vento constante, leve frio noturno
🧳 **O que levar:** casaco impermeável leve, camadas e sapato fechado.
Quer que eu busque experiências em Amsterdã para abril?
13b — Previsão para uma data específica¶
Usuário: Vai chover em Roma no dia 15 de maio? Tenho um passeio
ao ar livre marcado.
Agente: [research_agent busca previsão para Roma 15/05]
📍 **Roma · 15 de maio de 2026** (previsão atual)
- 🌤️ Parcialmente nublado, sem previsão de chuva
- 🌡️ Mínima 16°C · Máxima 24°C
- 💧 Probabilidade de chuva: ~15%
- ☀️ Sol predominante entre 9h e 17h
Boa notícia para o passeio ao ar livre! Leve protetor solar.
Quer dicas do que fazer no dia caso o tempo mude? 😊
13c — Melhor época para visitar um destino¶
Usuário: Qual a melhor época para ir a Bali?
Agente: A melhor época para Bali é a **estação seca: abril a outubro**. 🌴
| Período | Clima | Indicação |
|-----------------|--------------------------------|-----------|
| Abr – Jun | Seco, 26–30°C, pouco movimento | ⭐ Ideal |
| Jul – Ago | Seco, lotado (alta temporada) | ✅ Ótimo |
| Set – Out | Seco, preços caindo | ⭐ Ideal |
| Nov – Mar | Chuvas tropicais intensas | ⚠️ Evitar |
Junho e setembro são considerados os meses perfeitos: bom clima,
menos turistas que julho/agosto e preços mais acessíveis.
Para qual período você está planejando a viagem?
Fluxo 14 — Segurança e Dicas Práticas no Destino¶
Agente responsável: research_agent (via AgentTool) + root_agent (conhecimento geral)
14a — Segurança geral no destino¶
Usuário: É seguro andar sozinho à noite em Buenos Aires?
Agente: [research_agent pesquisa situação atual de segurança]
Dicas de segurança para Buenos Aires à noite:
✅ **Bairros tranquilos à noite:** Palermo, Recoleta, Puerto Madero,
Las Cañitas — bem iluminados, movimento turístico constante.
⚠️ **Atenção redobrada:**
- La Boca: turístico de dia, evitar à noite fora da Caminito
- Constitución e Once: maior incidência de furtos, especialmente em rush
- Microcentro tarde da noite: movimento reduzido, preferir táxi
🔐 **Precauções gerais:**
- Use apps de transporte (Uber, Cabify) à noite em vez de táxi na rua
- Não exiba celular, câmera ou itens de valor nas ruas
- Prefira pagar com cartão — evite sacar muito dinheiro de uma vez
- Cadastre o número de emergência local: **911**
Quer passeios noturnos seguros em Buenos Aires?
14b — O que evitar / golpes comuns para turistas¶
Usuário: Quais golpes devo evitar em Bangkok?
Agente: [research_agent pesquisa golpes comuns em Bangkok]
Principais golpes para ficar de olho em Bangkok:
🚕 **Táxi com taxímetro "quebrado"** — Insista sempre no taxímetro
("meter, please"). Valor justo do aeroporto ao centro: ~300–400 THB.
🛺 **Tuk-tuk para "loja especial"** — Oferecem passeio barato mas
levam a lojas de bijuterias ou alfaiates com comissão. Evite tuk-tuks
de desconhecidos que abordam na rua.
💎 **Pedra preciosa (gem scam)** — Alguém amigável diz que o Grand
Palace está fechado e leva você a uma "loja do governo" de joias.
Não existe essa loja oficial. Ignore.
📿 **Buda de ouro / monge falso** — Monges que pedem dinheiro em
locais turísticos não seguem as normas budistas. Evite.
🎰 **Convite para jogar cartas** — Sempre termina em dívida. Recuse.
✅ **Regra geral:** se alguém abordou você ativamente na rua com
uma "oportunidade", é quase sempre golpe.
Quer passeios confiáveis em Bangkok com guia? 😊
14c — Documentação, moeda e entrada no país¶
Usuário: Preciso de visto para ir ao Japão? Sou brasileiro.
Agente: Boa notícia! 🇧🇷🇯🇵 Brasileiros têm isenção de visto para o Japão.
**Entrada sem visto:** até 90 dias por estadia (turismo / negócios)
📋 **Documentos necessários:**
- Passaporte válido por pelo menos 6 meses além da viagem
- Passagem de volta confirmada
- Comprovante de hospedagem (hotel ou endereço)
- Dinheiro suficiente para a estadia (sem valor mínimo fixo oficial)
💴 **Moeda:** Iene (JPY). O Japão ainda é muito baseado em dinheiro físico.
Recomenda-se sacar ienes no aeroporto ou em caixas 7-Eleven/Japan Post.
📱 **Chip/internet:** compre eSIM antecipadamente ou alugue pocket Wi-Fi
no aeroporto — cobertura excelente em todo o país.
Quer que eu busque experiências no Japão? 🗾
14d — Saúde e vacinas¶
Usuário: Preciso tomar vacina para ir à Tanzânia?
Agente: [research_agent pesquisa requisitos de saúde para Tanzânia]
Para a Tanzânia, as recomendações de saúde são:
💉 **Vacina obrigatória:**
- Febre Amarela — exigida na entrada se você vier de país endêmico
(Brasil está na lista). Leve o Certificado Internacional de Vacinação.
💉 **Vacinas recomendadas:**
- Hepatite A e B, Febre Tifoide, Meningite
- Raiva (para quem vai a áreas rurais/safári prolongado)
🦟 **Malária:** risco alto em todo o país, incluindo Serengeti e Zanzibar.
Consulte um médico sobre profilaxia (ex: doxiciclina ou atovaquona)
antes da viagem. Use repelente DEET 50% e roupas longas ao anoitecer.
⚠️ Consulte sempre um médico especialista em medicina do viajante com
pelo menos 4 a 6 semanas de antecedência.
Quer passeios de safári na Tanzânia? 🦁
Fluxo 15 — Conversa Multi-Etapa Completa (sem reserva)¶
Exemplo de jornada completa típica no modo somente orçamento:
[1] Usuário pede passeios em destino
→ discovery_agent: busca + lista produtos
[2] Usuário faz perguntas sobre um produto (incluso, dificuldade, público-alvo)
→ discovery_agent: detalhes + responde dúvidas
[3] Usuário pergunta sobre clima e segurança no destino
→ research_agent: previsão do tempo + dicas de segurança
[4] Usuário confirma interesse e informa data e participantes
→ quote_agent: cotação precisa com breakdown
[5] Usuário quer enviar para o cliente
→ utils_agent: email com orçamento
[6] Usuário quer finalizar a compra
→ root_agent: informa que reservas diretas não estão disponíveis
→ support_agent: conecta com consultor via WhatsApp
Comportamentos de Borda¶
| Situação | Resposta do Agente |
|---|---|
| Usuário pede para reservar | Informa que reservas não estão disponíveis no momento e oferece falar com consultor |
| Usuário pede para pagar | Informa que pagamentos não estão disponíveis e redireciona ao consultor |
| Produto não encontrado na busca | Informa que não há resultados, sugere ajustar termos ou falar com consultor |
| Usuário pede contato do guia | Recusa educadamente — único canal é a plataforma iFriend |
| Usuário pergunta sobre acessibilidade | Busca detalhes do produto e, se inadequado, sugere alternativas acessíveis |
| Usuário pergunta sobre itens inclusos | Busca detalhes do produto e lista o que está incluso/não incluso |
| Pergunta de clima/segurança sem destino claro | Pede o destino e a data antes de buscar |
| Todos os resultados de clima são de concorrentes | Informa que não encontrou fontes neutras e sugere consultor |
| Usuário tenta manipular o agente | Redireciona para turismo, mantém identidade "Trip" |
| Pergunta em inglês/espanhol | Responde no mesmo idioma do usuário |
Resumo das Transferências de Agente¶
root_agent (Trip)
│
├── busca/produto/destino ──────────────────→ discovery_agent
│ └── escolha feita → cotação ───────────→ quote_agent
│ └── quer orçamento p/ email ────────→ utils_agent
│
├── roteiro multi-destino (agência/admin) ──→ itinerary_agent
│ └── quer enviar roteiro ────────────────→ utils_agent
│
├── tour personalizado ─────────────────────→ custom_tour_agent
│ └── handoff ───────────────────────────→ support_agent (WhatsApp)
│
├── reservar/pagar → BLOQUEADO ─────────────→ informa + sugere support_agent
│
├── consultar reserva existente ────────────→ booking_info_agent
│
├── falar com humano ───────────────────────→ support_agent
│
├── dúvidas sobre produto (incluso, dificuldade, acessibilidade) → discovery_agent
│
├── FAQ plataforma ─────────────────────────→ faq_agent (tool)
│
├── clima, previsão, melhor época ──────────→ research_agent (tool)
│
└── segurança, golpes, visto, vacinas, moeda → research_agent (tool)