> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airbee.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendários

> Conecte o calendário da Airbee ao Airbnb e, no Unlimited, ao Booking.com e à Vrbo para manter as datas ocupadas alinhadas.

Este guia mostra como conectar os calendários da sua acomodação e conferir se as datas ocupadas estão sendo atualizadas.

iCal é um link usado para compartilhar datas ocupadas entre calendários. Na Airbee, a conexão funciona nos dois sentidos: o canal externo envia suas reservas para a Airbee, e a Airbee envia suas reservas e bloqueios de volta para o canal.

## Antes de começar

Você precisa ter:

* pelo menos uma acomodação cadastrada na Airbee;
* acesso ao anúncio correspondente no canal externo;
* a URL do calendário que será conectado.

O Basic inclui a conexão com o Airbnb. O Unlimited também permite conectar Booking.com e Vrbo.

## Exemplo prático

O **Chalé da Serra** recebe reservas pelo link direto da Airbee e pelo Airbnb. Ao conectar os dois calendários, uma reserva feita no Airbnb ocupa as mesmas datas na Airbee. Um bloqueio criado na Airbee também aparece no Airbnb depois que o canal consulta o calendário novamente.

## O que acontece em cada sentido

| Sentido                | O que você faz                            | Resultado                                                             |
| ---------------------- | ----------------------------------------- | --------------------------------------------------------------------- |
| Canal externo → Airbee | Cola na Airbee a URL fornecida pelo canal | Reservas e bloqueios externos aparecem no calendário da Airbee        |
| Airbee → canal externo | Cola no canal a URL fornecida pela Airbee | Reservas e bloqueios criados na Airbee ocupam as datas no outro canal |

<Warning>
  Configure os dois sentidos da conexão. Se apenas uma URL for adicionada, as datas serão atualizadas em uma única direção.
</Warning>

## Como conectar

<Steps>
  <Step title="Copie a URL do canal externo">
    Abra o calendário do anúncio no Airbnb, Booking.com ou Vrbo e procure a opção de exportar o calendário. Copie a URL iCal completa.

    Se precisar de ajuda para encontrá-la, a Airbee mostra instruções em **Como encontrar a URL?**.
  </Step>

  <Step title="Conecte o canal à Airbee">
    Na Airbee, acesse **Configurações → Integrações**, abra o canal desejado e selecione a acomodação correspondente. Clique em **Conectar**, cole a URL e confirme.
  </Step>

  <Step title="Envie o calendário da Airbee para o canal">
    Em **Acomodações**, abra a acomodação e entre em **Calendários**. Na seção **Enviar esta acomodação para outros canais**, escolha o **Canal de destino** e copie a URL da Airbee.

    Volte ao canal externo, escolha a opção de importar calendário e cole essa URL.
  </Step>

  <Step title="Confira a primeira atualização">
    Volte a **Configurações → Integrações**. Abra o canal e a acomodação. Clique em **Sincronizar agora** e confirme se o status muda para **Conectado**.
  </Step>
</Steps>

## Frequência das atualizações

| Plano     | Canal externo → Airbee |
| --------- | ---------------------- |
| Basic     | A cada 4 horas         |
| Unlimited | A cada 1 minuto        |

Você também pode usar **Sincronizar agora**. Depois de uma atualização manual, será possível repetir a ação após 60 segundos.

<Warning>
  Esses intervalos mostram quando a Airbee consulta os canais externos. No sentido contrário, cada canal decide quando consulta a URL da Airbee. O Airbnb atualiza os calendários conectados a cada três horas. Nas consultas observadas pela Airbee, o Booking.com costuma buscar a URL em cerca de **2 horas e 30 minutos**, mas não garante um intervalo fixo e pode demorar mais.
</Warning>

<Note>
  Se precisar de efeito imediato no Booking.com, use **Importar agora** na Extranet. Enquanto a data não aparece no canal externo, não repita o bloqueio por lá. Um bloqueio criado no canal volta para a Airbee como bloqueio externo e só é liberado no próprio canal. Veja [Integrando calendários](/guias/integrando-calendarios).
</Note>

### Use uma URL diferente para cada destino

A URL de saída é específica para o canal escolhido. Não reutilize no Booking.com a URL gerada para Airbnb ou Vrbo.

Se a conexão foi configurada quando a Airbee ainda fornecia uma URL única, abra **Acomodações → acomodação → Calendários**, selecione o destino novamente e substitua a URL importada no canal externo. Essa troca acontece no canal que recebe o calendário da Airbee; não altere a URL do canal que está cadastrada em **Receber reservas**.

## Quais informações são compartilhadas

O iCal é usado principalmente para compartilhar as datas ocupadas e uma identificação básica da reserva ou do bloqueio. Nome completo, telefone, e-mail, valor pago e outras informações do hóspede normalmente não acompanham a reserva importada.

## Cancelamentos

Quando uma reserva é cancelada no canal externo, a Airbee libera as datas depois de receber uma atualização válida desse calendário. Até lá, o período pode continuar ocupado na Airbee.

## Como conferir o resultado

* O canal e a acomodação aparecem como **Conectado** em **Configurações → Integrações**.
* Antes da primeira leitura bem-sucedida, a acomodação aparece como **Aguardando**. Se a última tentativa falhar, o status muda para **Atenção**.
* Uma reserva externa aparece nas mesmas datas do calendário da Airbee.
* Uma reserva ou um bloqueio criado na Airbee aparece no canal externo depois da próxima consulta feita por ele.

## Se algo não sair como esperado

* **Nenhuma acomodação aparece na integração:** cadastre a acomodação antes de conectar o calendário.
* **O status mostra Atenção:** clique em **Sincronizar agora**. Se o erro continuar, gere ou copie novamente a URL no canal externo.
* **Booking.com ou Vrbo está indisponível:** esses canais fazem parte do Unlimited.
* **A reserva criada na Airbee ainda não apareceu no outro canal:** confirme se a URL da Airbee foi importada no anúncio correto e se pertence ao destino escolhido. No Booking.com, aguarde a próxima consulta, normalmente próxima de 2 horas e 30 minutos, ou use **Importar agora**.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Integrando calendários" href="/guias/integrando-calendarios">
    Guia completo com regras gerais, prazos de cada canal e limites do iCal.
  </Card>

  <Card title="Integrando calendário com Airbnb" href="/guias/integrando-calendario-com-airbnb">
    Passo a passo para conectar um anúncio do Airbnb nos dois sentidos.
  </Card>

  <Card title="Integrando calendário com Booking" href="/guias/integrando-calendario-com-booking">
    Requisitos da Extranet e passo a passo do Booking.com.
  </Card>

  <Card title="Reservas" href="/reservas">
    Entenda as origens, os status e o efeito de cada reserva no calendário.
  </Card>
</CardGroup>
