> ## 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.

# Integrando calendário com Airbnb

> Conecte o calendário do seu anúncio do Airbnb à Airbee nos dois sentidos para que reservas e bloqueios ocupem as mesmas datas nos dois lados.

Este guia mostra como ligar um anúncio do Airbnb a uma acomodação da Airbee. Ao final, reservas feitas no Airbnb ocupam as datas na Airbee e reservas diretas e bloqueios criados na Airbee ocupam as datas no Airbnb.

Se ainda não conhece o funcionamento geral da integração, comece por [Integrando calendários](/guias/integrando-calendarios).

## Antes de começar

Você precisa ter:

* a acomodação já cadastrada na Airbee;
* acesso à conta de anfitrião do anúncio no Airbnb;
* plano Basic ou Unlimited.

<Note>
  Cada anúncio do Airbnb tem uma URL própria. Conecte uma acomodação por vez e confira sempre se a URL pertence ao imóvel certo.
</Note>

## Parte 1 — Trazer o Airbnb para a Airbee

<Steps>
  <Step title="Entre na sua conta de anfitrião">
    Acesse o Airbnb com a conta que administra o imóvel que você quer conectar.
  </Step>

  <Step title="Abra o anúncio que será sincronizado">
    No painel de anfitrião, vá em **Anúncios** e clique no imóvel.
  </Step>

  <Step title="Vá em Calendário → Disponibilidade">
    Dentro do anúncio, abra o calendário e procure a seção de disponibilidade.
  </Step>

  <Step title="Procure Sincronizar calendários">
    Role a página até encontrar **Sincronizar calendários** (em inglês, *Sync calendars*).
  </Step>

  <Step title="Clique em Exportar calendário">
    O Airbnb mostra a URL do calendário desse anúncio. Copie a URL inteira.

    Ela começa com `https://www.airbnb.com/calendar/ical/` e termina em `.ics`. É um endereço longo, com letras e números misturados — é assim mesmo.
  </Step>

  <Step title="Cole a URL na Airbee">
    Na Airbee, acesse **Configurações → Integrações**, abra o **Airbnb**, selecione a acomodação e clique em **Conectar**. Cole a URL e confirme.

    O mesmo bloco está disponível em **Acomodações → abrir a acomodação → Calendários**.
  </Step>

  <Step title="Clique em Sincronizar agora">
    A primeira leitura acontece nessa ação. A Airbee informa quantas reservas foram criadas, atualizadas ou removidas.
  </Step>
</Steps>

## Parte 2 — Enviar a Airbee para o Airbnb

Esta parte é a que faz suas reservas diretas bloquearem o Airbnb. Sem ela, a integração fica pela metade.

<Steps>
  <Step title="Copie a URL da acomodação na Airbee">
    Em **Acomodações**, abra a acomodação e entre em **Calendários**. Na seção **Enviar este imóvel para outros canais**, escolha **Airbnb** como canal de destino e copie a URL.
  </Step>

  <Step title="Volte ao Airbnb, na mesma tela de sincronização">
    Em **Sincronizar calendários**, escolha a opção de importar calendário, logo abaixo da opção de exportar.
  </Step>

  <Step title="Cole a URL e dê um nome à conexão">
    Use um nome que ajude a reconhecer a origem, como "Airbee". Confirme para salvar.
  </Step>
</Steps>

## Frequência das atualizações

| Sentido         | Quem define o ritmo | Frequência                                                                                                            |
| --------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Airbnb → Airbee | Airbee              | A cada 4 horas no Basic e a cada 1 minuto no Unlimited, além de **Sincronizar agora**                                 |
| Airbee → Airbnb | Airbnb              | O Airbnb atualiza os calendários importados **a cada 3 horas** e oferece a ação **Atualizar** para buscar antes disso |

<Warning>
  A Airbee monta o calendário de saída no instante em que ele é solicitado, sem atraso do nosso lado. O tempo até a data aparecer bloqueada no Airbnb depende de quando o Airbnb vem consultar a URL.
</Warning>

### O ciclo de 3 horas do Airbnb

O intervalo não é o mesmo nos dois sentidos, e essa é a dúvida mais comum de quem acabou de conectar. A frequência com que a Airbee lê o Airbnb depende do seu plano. A frequência com que o Airbnb lê a Airbee é definida pelo próprio Airbnb.

Segundo a central de ajuda do Airbnb, em [Sincronize o calendário de hospedagem da sua acomodação a outros sites](https://www.airbnb.com.br/help/article/99):

* o calendário do Airbnb **atualiza automaticamente a cada três horas** e recebe as informações dos outros calendários conectados;
* para ver a disponibilidade mais recente antes da próxima atualização automática, é possível **atualizar manualmente** pelo próprio Airbnb;
* o Airbnb importa **até dois anos** de dados, então bloqueios distantes também são considerados;
* um calendário importado **não pode ser pausado**. Para interromper, é preciso desconectar e conectar novamente depois.

Na prática, um bloqueio criado na Airbee aparece no Airbnb em até 3 horas, com média em torno de metade desse tempo.

<Warning>
  Enquanto espera, **não crie o mesmo bloqueio dentro do Airbnb**. Um bloqueio feito no Airbnb volta para a Airbee como bloqueio externo e passa a ocupar as datas aqui até ser removido no próprio Airbnb. Se precisar de efeito imediato, use a atualização manual descrita abaixo. Veja [Bloqueie sempre em um lugar só](/guias/integrando-calendarios).
</Warning>

### Como forçar a atualização no Airbnb

Quando você precisa que o bloqueio apareça imediatamente, o Airbnb indica este caminho:

<Steps>
  <Step title="Abra o calendário do anúncio">
    Clique em **Calendário** e escolha o calendário que quer alterar.
  </Step>

  <Step title="Vá em Disponibilidade">
    Em **Conectar calendários**, clique em **Conectar a outro site**.
  </Step>

  <Step title="Atualize o calendário importado">
    Selecione o calendário importado da Airbee e clique em **Atualizar calendário**. O Airbnb busca a URL na hora e fecha as datas ocupadas.
  </Step>
</Steps>

<Note>
  Evite repetir a atualização manual várias vezes seguidas. Na versão em inglês da mesma página, o Airbnb informa que só consegue solicitar atualizações ao outro site um certo número de vezes e que, ao ultrapassar esse limite, é preciso aguardar o próximo ciclo automático.
</Note>

## O que aparece na Airbee

As reservas importadas entram no calendário como reservas externas identificadas como Airbnb, sem hóspede vinculado e sem valores. O Airbnb não compartilha nome, e-mail, telefone nem valor pelo iCal — é uma decisão de privacidade da plataforma.

O calendário do Airbnb distingue reserva confirmada de bloqueio manual, e a Airbee mantém essa diferença ao registrar o período ocupado.

## Cancelamentos

Quando o hóspede cancela no Airbnb, a reserva desaparece do calendário deles e a Airbee libera as datas depois de três sincronizações bem-sucedidas seguidas sem aquele evento.

Se o evento reaparecer em qualquer uma dessas leituras, a contagem é zerada. A mesma proteção vale quando o Airbnb responde com um calendário completamente vazio. Novas reservas continuam entrando já na primeira sincronização bem-sucedida.

## Perguntas frequentes

**O intervalo da Airbee vale para os dois sentidos?**
Não. O intervalo do seu plano é o ritmo com que a **Airbee lê o Airbnb**. No sentido contrário, quem define o ritmo é o Airbnb, com o ciclo automático de 3 horas. Bloqueei na Airbee e não apareceu no Airbnb na hora é o comportamento esperado, não uma falha.

**Bloqueei uma data aqui e ela só fechou no Airbnb depois que cliquei em Atualizar lá. Está certo?**
Sim, e isso confirma que a conexão está funcionando. A data já estava marcada como ocupada no calendário que a Airbee disponibiliza; o Airbnb só ainda não tinha vindo buscar. Ao atualizar manualmente, ele encontrou a informação que já estava lá.

**Preciso refazer a conexão se eu editar o anúncio?**
Não. A URL do Airbnb é fixa para o anúncio. Você pode alterar título, fotos, preços e regras sem mexer na conexão. Ela só muda se o anúncio for excluído e criado de novo.

**Posso conectar mais de um anúncio do Airbnb à mesma acomodação?**
Não. Cada acomodação da Airbee aceita uma conexão do Airbnb. Se você tem vários anúncios, cadastre uma acomodação para cada um.

**A integração sincroniza meus preços do Airbnb?**
Não. O iCal transporta apenas datas ocupadas. Preços, estadia mínima e regras continuam sendo definidos em cada canal.

**Posso excluir uma reserva que veio do Airbnb?**
Não pela Airbee. Ela pertence ao Airbnb e sai do calendário quando desaparece do calendário de lá.

## Se algo não sair como esperado

* **A conexão mostra Atenção:** clique em **Sincronizar agora**. Se continuar, copie a URL novamente no Airbnb, porque links antigos podem ter sido revogados.
* **Não encontro Sincronizar calendários no Airbnb:** confirme que você está no anúncio certo e na seção de disponibilidade do calendário.
* **As reservas do Airbnb não aparecem:** confira se a URL colada é a de exportação do Airbnb, e não a URL da Airbee.
* **Minhas reservas diretas não bloqueiam o Airbnb:** a Parte 2 provavelmente não foi concluída, ou a URL da Airbee foi importada em outro anúncio.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Integrando calendários" href="/guias/integrando-calendarios">
    Regras gerais, limites e o que o iCal não faz.
  </Card>

  <Card title="Integrando calendário com Booking" href="/guias/integrando-calendario-com-booking">
    Conecte também o Booking.com no plano Unlimited.
  </Card>
</CardGroup>
