Hostaway | ElevenLabs Documentation

Com a ferramenta de webhook abaixo, sua recepcionista pode verificar o calendário de um anúncio no Hostaway para as datas solicitadas por quem liga e informar se a cabana ou unidade está disponível, o preço por noite e a estadia mínima. A API pública do Hostaway emite um token de acesso válido por 24 meses, então a ferramenta chama o Hostaway diretamente.

Sua recepcionista não pode criar reservas nem consultar reservas existentes. Ela verifica o calendário e recebe a solicitação de reserva, e sua equipe confirma a estadia pelo resumo pós- chamada.

Antes de começar

Crie uma chave de API

No painel do Hostaway, abra Configurações → Hostaway API e crie uma nova chave de API. Nomeie-a como Reception.ai e escolha Hostaway Public API como parceiro. Copie a chave: o Hostaway a exibe apenas uma vez. Anote seu ID da conta, que também aparece em Configurações.

Obtenha um token de acesso

Troque a chave por um token de acesso em um terminal, substituindo ACCOUNT_ID e API_KEY:

curl -X POST 'https://api.hostaway.com/v1/accessTokens' \
  -H 'Content-type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials&client_id=ACCOUNT_ID&client_secret=API_KEY&scope=general'

Copie o valor de access_token da resposta. Ele é válido por 24 meses.

O token de acesso pode ler e alterar tudo na sua conta do Hostaway, incluindo dados dos hóspedes e códigos de porta. Não o cole em documentos compartilhados ou ferramentas online. Se ele vazar, revogue-o e exclua a chave de API no Hostaway.

Encontre os IDs dos seus anúncios

Liste seus anúncios com o token, substituindo YOUR_TOKEN:

curl 'https://api.hostaway.com/v1/listings?limit=100' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Cada anúncio na resposta tem um id e um name. Anote o ID de cada anúncio que sua recepcionista deve verificar.

Crie a ferramenta

Acesse Integrações, selecione Adicionar integração e escolha Ferramenta de webhook.

Campo	Valor
Nome	`check_hostaway_calendar`
Descrição	”Verifique se um dos nossos imóveis está disponível nas datas de quem ligou, além do preço por noite e da estadia mínima. Use esta ferramenta antes de informar que um imóvel está disponível.”
Método	GET
URL	`https://api.hostaway.com/v1/listings/{listing_id}/calendar`
Cabeçalhos da solicitação	`Authorization`: `Bearer` seguido do seu token de acesso, com o Tipo definido como Secret
Parâmetros de caminho	`listing_id` (string, obrigatório): “Use `11111` para a Cabana Cedar e `22222` para a Cabana Lakeside.”
Parâmetros de consulta	`startDate` (string, obrigatório): “A data de chegada, no formato AAAA-MM-DD.” `endDate` (string, obrigatório): “A última noite da estadia, no formato AAAA-MM-DD.” `includeResources` (string, valor fixo): `0`
Atribuir aos agentes	Recepcionista

Substitua os nomes e IDs das cabanas pelos seus e adicione uma linha por anúncio. Selecione Ativar.

O Hostaway retorna uma entrada por noite. Uma noite está disponível quando status é available. Cada noite também tem seu price e minimumStay.

Mantenha includeResources fixo em 0. Com 1, o Hostaway adiciona as reservas de cada noite, incluindo nomes, números de telefone e e-mails dos hóspedes, ao que sua recepcionista vê.

Teste

Teste sua recepcionista pedindo uma cabana em datas que você sabe que estão reservadas e depois em datas que você sabe que estão disponíveis. Compare as respostas com seu calendário do Hostaway.

Adicione um procedimento para solicitações de estadia: peça o imóvel, as datas de chegada e partida e o número de hóspedes; verifique o calendário; depois, obtenha o nome, telefone e e-mail de quem ligou para sua equipe. Adicione uma regra para que sua recepcionista nunca prometa que uma estadia está reservada.

Limitações

Sua recepcionista não pode criar, alterar ou cancelar reservas. Sua equipe confirma cada estadia.
Ela verifica um anúncio por vez. Para sugerir outra cabana, verifica cada uma em sequência.
Os preços por noite não incluem taxas de limpeza, impostos ou descontos, então sua recepcionista deve informá-los apenas como referência.
A ferramenta não consulta reservas existentes. Os registros de reservas e anúncios do Hostaway incluem códigos de porta e senhas de Wi-Fi, por isso este guia não os coloca diante da sua recepcionista. O app do Hostaway no Zapier retorna os mesmos registros e não tem ações de reserva ou disponibilidade.
Seu token de acesso deixa de funcionar após 24 meses. Crie um novo e atualize o cabeçalho antes disso.

Solução de problemas

Problema	O que verificar
401 ou 403 do Hostaway	O valor do cabeçalho deve ser `Bearer`, um espaço e o token de acesso, não a chave de API. Verifique se ele não expirou.
A cabana errada é verificada	Verifique se os IDs dos anúncios na descrição de `listing_id` correspondem aos seus anúncios.
Uma noite reservada aparece como disponível	Verifique o calendário no Hostaway. Noites bloqueadas e reservadas têm um `status` diferente de `available`.
A recepcionista oferece uma estadia curta demais	Diga a ela na descrição da ferramenta para verificar `minimumStay` na noite de chegada.