> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Hostaway Com a [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks) 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. > **Note** > > 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](/docs/pt/reception-ai/features/notifications). ## 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`: ```bash 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. > **Warning** > > 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`: ```bash 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`. > **Warning** > > 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](/docs/pt/reception-ai/receptionist/testing) 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. > **Tip** > > Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) 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. |