iscabox

Guias de pesca com barco e pousadas cadastrados na iscabox para um lugar do Brasil (rio, represa, cidade ou praia): guideId, nome, onde atende, de onde sai, peixes, se leva equipamento e o preço da diária; com datas, o total da viagem e a parte paga agora pela iscabox. Nunca traz telefone, email ou Instagram. Sempre traz `requestUrl`, o pedido de guia na iscabox. Lista vazia quer dizer que a iscabox ainda não tem guia cadastrado ali; o mesmo pedido (requestUrl, ou request_booking sem guide_id) faz a equipe procurar um guia.

Em que pé está uma reserva feita com request_booking, pelo bookingToken ou pelo payUrl: aguardando o pagamento, aguardando o guia (com o prazo), confirmada, cancelada ou reembolsada, com os valores e o último dia para cancelar. Os contatos não vêm aqui: depois do aceite eles vão pelo WhatsApp e ficam na página da reserva.

Condições de pesca de um dia: tábua de marés, fase da lua, melhores janelas de horário, temperatura da água e tempo. Use quando o usuário perguntar sobre maré, lua, melhor horário para pescar, ou se o dia está bom. Hoje por padrão; passe date para amanhã, um dia da semana ou uma data, e range para a semana ou o mês inteiro. Maré só existe para portos do litoral; para água doce a ferramenta devolve a fase da lua e as janelas de horário do dia (bestWindows).

O perfil público de um guia cadastrado na iscabox, pelo guideId de find_guides: fotos, o que oferece, barcos (tipo, tamanho, motor, lugares), os lugares onde atende com o preço da diária e os peixes, e se leva equipamento. Sem telefone, email ou Instagram: os contatos são trocados pela iscabox depois que o guia aceita a reserva.

Detalhes de um local de pesca: como chegar, melhores pontos, espécies, iscas e técnicas que funcionam ali.

Traçado de um rio que a iscabox mapeou: os municípios que ele atravessa, na ordem da nascente à foz, com o trecho em km de cada um, e os locais de pesca do acervo ao longo dele. Use quando o usuário perguntar por onde um rio passa, que cidades ficam nele, ou onde pescar ao longo de um rio.

Detalhes de uma espécie: habitat, dieta, técnicas que funcionam, iscas, melhor época do ano (seasonalCalendar) e regiões onde pescar. Use antes de recomendar equipamento ou local para um peixe específico, e para "melhor época / quando pescar X".

Orçamento de uma pescaria com um guia da iscabox: guia + datas + pessoas → o total da viagem, a parte paga agora pela iscabox (que dá mais segurança ao pescador e ao guia e volta inteira se o guia não aceitar), o restante pago ao guia no dia, o último dia para cancelar com tudo de volta e em quantas horas o guia responde. Os mesmos valores que o site cobra. Não cria pedido.

Faz o pedido de reserva na iscabox e devolve `payUrl`, a página da iscabox onde o pescador paga a parte dele agora. O pedido só chega ao guia depois desse pagamento; o guia tem 24 h para aceitar (6 h quando a pescaria é hoje ou amanhã) e, se não aceitar, o pescador recebe tudo de volta. Os contatos do guia e do pescador são trocados pelo WhatsApp depois do aceite. Precisa do WhatsApp do pescador e não recebe dados de pagamento. Sem guide_id, o pedido vai para a equipe da iscabox, que procura um guia para o lugar e responde pelo WhatsApp (útil quando find_guides vem vazio).

Destinos de pesca no Brasil (rios, represas, lagos e litoral) para um peixe, uma região ou perto da cidade de onde o pescador sai: os peixes de cada lugar, a distância, os guias cadastrados na iscabox ali e se a piracema fecha a pesca nas datas. Cada destino traz pagePath (para find_guides e request_booking) e requestUrl, o pedido de guia no site. Um destino sem guia cadastrado ainda pode receber pedido: a equipe da iscabox procura um guia.

Busca locais de pesca no acervo da iscabox — rios, represas, praias, pesqueiros. Filtre por estado, espécie ou tipo de água. Use quando o usuário perguntar onde pescar. Se o usuário citar uma cidade, passe lat e lng dela: locais próximos entram na resposta mesmo quando a cidade em si não tem página. Use kind para separar pesque-pague de água livre.

Busca espécies de peixes no acervo da iscabox pelo nome popular ou científico. Use quando o usuário mencionar um peixe para confirmar qual espécie é antes de responder.