Criação de Cotações

Este guia é voltado para empresas que desejam a possibilidade de criar cotações a partir de ferramentas como chatbots, com base em resultados da busca por disponibilidade. Para isso, oferecemos a capacidade de criar uma URL com base nos dados da hospedagem desejada que, ao clicada, redireciona o usuário à página da nova cotação.

Para todos os exemplos fornecidos, substitua {nome_instalação} pelo nome de sua instalação Niara. Os demais parâmetros usados para criar a cotação são listados ao final desta página.

URL com query strings obrigatórios

https://my-reservations.niara.tech/{nome_instalação}/chatbot?clientId={seu_clientId}&requestId={seu_requestId}&bookingStartDate=2026-02-07&bookingEndDate=2026-02-09&occupancy_adults=2&hotelId={seu_hotelId}

URL com hóspedes crianças

• Utilize o parâmetro occupancy_childrenAges para informar a idade de cada criança.
• As idades devem ser separadas com vírgulas, como em 2,10,5.
• Na URL, esse exemplo ficaria da seguinte forma: occupancy_childrenAges=2%2C10%2C5

Exemplo de URL com crianças:

https://my-reservations.niara.tech/{nome_instalação}/chatbot?clientId={seu_clientId}&requestId={seu_requestId}&bookingStartDate=2026-02-07&bookingEndDate=2026-02-09&occupancy_adults=2&occupancy_childrenAges=2%2C10%2C5&hotelId={seu_hotelId}

URL com tarifas específicas

• Utilize o parâmetro roomRatesId para cada tarifa, conforme o exemplo a seguir.

https://my-reservations.niara.tech/{nome_instalação}/chatbot?clientId={seu_clientId}&requestId={seu_requestId}&bookingStartDate=2026-02-07&bookingEndDate=2026-02-09&occupancy_adults=2&hotelId={seu_hotelId}&roomRatesId={room_rate_1}&roomRatesId={room_rate_2}

Parâmetros query string

Nome	Descrição	Tipo	Obrigatório
clientId	ID do cliente (dentro da instalação).	Texto	Sim
requestId	Número único utilizado.	Texto	Sim
bookingStartDate	Data de início da estadia.	Texto	Sim
bookingEndDate	Data de término da estadia.	Texto	Sim
occupancy_adults	Quantidade de hóspedes adultos.	Inteiro	Sim
occupancy_childrenAges	Idades das crianças, separadas por vírgulas. Opcional caso não haja crianças.	Texto	Não
hotelId	ID Omnibees do hotel.	Inteiro	Sim
buyerName	Nome do comprador.	Texto	Não
buyerEmail	E-mail do comprador.	Texto	Não
buyerPhone	Telefone do comprador.	Texto	Não
promoCode	Código promocional cadastrado na Omnibees.	Texto	Não
source_channel	Origem.	Texto	Não
send_email	Parâmetro para disparo de e-mail de cotação automático.	Booleano	Não
roomRatesId	IDs de tarifas. Parâmetro obtido na busca da API Niara.	Array de textos	Não