| Objetivo | Entender o comportamento comum da conexão da API do Airbnb no PMS da Cloudbeds, incluindo diferenças de sincronização, funcionamento do Instant Book, recursos suportados, tarifas, comunicação com hóspedes, disponibilidade do telefone do hóspede e saldos de reservas. |
| Ideal para | Administrador do estabelecimento · Gerente do estabelecimento · Proprietário |
| Use este artigo quando | Você precisar entender como a API do Airbnb funciona com o PMS da Cloudbeds, comparar a API do Airbnb com o Airbnb iCal, confirmar o comportamento suportado pela API do Airbnb ou solucionar dúvidas comuns sobre a API do Airbnb. |
| Você precisa | Acesso à página de Distribuição e uma conta ou anúncio ativo no Airbnb conectado ou pronto para conectar via API do Airbnb. |
| Resultado esperado | Você entende o que a API do Airbnb pode sincronizar, como ela difere do Airbnb iCal, como o Instant Book funciona com a API do Airbnb e qual artigo relacionado usar para configuração, comportamento do iCal ou passos para desconexão. |
| Limite importante | A API do Airbnb ativa automaticamente o Instant Book. O PMS da Cloudbeds atualmente não processa solicitações de reserva do Airbnb, solicitações pendentes ou bloqueios temporários como reservas pendentes através da conexão da API do Airbnb. |
Introdução
O Airbnb pode se conectar ao PMS da Cloudbeds por meio da API do Airbnb ou do Airbnb iCal. Esses tipos de conexão funcionam de formas diferentes. Use esta FAQ para confirmar qual comportamento se aplica à API do Airbnb, onde o comportamento do Airbnb iCal é diferente e qual guia relacionado seguir quando precisar de detalhes sobre configuração ou conexão.
Este artigo foca nas perguntas frequentes sobre a conexão da API do Airbnb. Para instruções passo a passo de conexão, use o guia Conectar API do Airbnb ao PMS da Cloudbeds.
Neste artigo
- Noções básicas da conexão Airbnb API
- Recursos suportados pela Airbnb API e comportamento do anúncio
- Comportamento da Reserva Instantânea e reservas na Airbnb API
- Tarifas, disponibilidade e preços na Airbnb API
- Comunicação com hóspedes e saldo de pagamento na Airbnb API
Noções básicas da conexão Airbnb API
Use esta seção para entender a diferença entre a Airbnb API e o Airbnb iCal, quando migrar do iCal para a API e como remover a conexão antiga do Airbnb iCal caso ela ainda esteja ativa.
Qual é a diferença entre Airbnb API e Airbnb iCal?
Airbnb iCal e Airbnb API são duas formas diferentes de conectar o Airbnb ao PMS da Cloudbeds.
iCal significa Internet Calendaring and Scheduling Core Object Specification, também conhecido como iCalendar. API significa Application Programming Interface.
| Tipo de conexão | Como funciona | O que você precisa saber |
|---|---|---|
| Airbnb iCal | Usa feeds de calendário para sincronizar eventos de disponibilidade, como datas bloqueadas ou reservas, entre o Airbnb e o PMS da Cloudbeds. | O iCal não é exclusivo para sistemas de hotelaria e não foi desenvolvido especificamente para fluxos de trabalho de gestão hoteleira ou de estabelecimentos. As atualizações não são instantâneas porque o canal precisa puxar as novas informações do calendário. Isso pode aumentar o risco de overbookings, e as tarifas não são atualizadas por conexões iCal. |
| Airbnb API | Fornece uma conexão direta entre o PMS da Cloudbeds e o Airbnb para que múltiplos tipos de dados possam ser sincronizados entre os sistemas. | A Airbnb API oferece uma sincronização mais robusta que o iCal e reduz o intervalo de tempo em que uma reserva dupla pode ocorrer. O PMS da Cloudbeds pode atualizar tarifas, disponibilidade, restrições, cancelamentos e modificações. A Airbnb API também suporta tipos de acomodação com múltiplas unidades, descontos, regras de preço, regras de disponibilidade e impostos ou taxas. |
Para mais informações sobre conexões baseadas em calendário, consulte Canais baseados em calendário e conexões iCal no PMS da Cloudbeds.
Se todos os meus quartos estiverem conectados ao Airbnb iCal, quando posso mudar para a API do Airbnb?
Você pode mudar do Airbnb iCal para a API do Airbnb imediatamente. Se o Airbnb iCal foi usado anteriormente, desative a conexão do Airbnb iCal para evitar atualizações conflitantes.
Para mudar a conexão, siga os passos em Conectar a API do Airbnb ao PMS da Cloudbeds.
Como posso desativar a antiga conexão Airbnb iCal?
Se o Airbnb iCal estiver ativo, desative a antiga conexão iCal antes de usar a API do Airbnb para evitar atualizações conflitantes.
- Acesse a página Distribuição.
- Encontre Airbnb (iCal).
- Exclua todos os links adicionados à conexão Airbnb iCal.
- Volte ao canal e remova a marcação.
Recursos da API do Airbnb suportados e comportamento do anúncio
Use esta seção para confirmar quais recursos da API do Airbnb são suportados, até onde o PMS da Cloudbeds envia tarifas e disponibilidade, e qual comportamento do anúncio do Airbnb pode afetar o multi-inventário.
Quais recursos do canal Airbnb API são suportados?
| Suportado pela Airbnb API | Não suportado pela Airbnb API |
|---|---|
|
|
Quantas fotos podemos carregar no Airbnb?
Você pode carregar quantas fotos quiser.
Quais tipos de anúncio do Airbnb não suportam multi-inventário?
O Airbnb forneceu as seguintes orientações para o Inventário de Tipo de Acomodação:
Políticas de Inventário de Tipo de Acomodação:
O inventário de Tipo de Acomodação permite que anfitriões tenham múltiplas disponibilidades para o mesmo anúncio no mesmo dia. Os anfitriões podem agrupar vários quartos em um conjunto representativo único e usar contagens diárias de disponibilidade para gerenciar a disponibilidade no anúncio.
Esse recurso deve ser implementado apenas quando houver mais de um quarto disponível por dia para o anúncio, e quando esses quartos compartilharem atributos semelhantes de modo que possam ser considerados substitutos reais. Os quartos devem ter as mesmas comodidades, configurações de cama, tamanho, decoração e endereço.
Anúncios com tipo de propriedade Casa não são elegíveis para serem listados como Inventário de Tipo de Acomodação.
Até quanto tempo no futuro o PMS da Cloudbeds pode atualizar tarifas e disponibilidade para o Airbnb?
O PMS da Cloudbeds envia tarifas e disponibilidade para os próximos três anos ao Airbnb. O Airbnb exibe 365 dias.
Comportamento do Instant Book e das reservas na API do Airbnb
Use esta seção para confirmar como o Instant Book funciona quando o Airbnb está conectado via API e como o comportamento da API do Airbnb difere do comportamento do Airbnb iCal para solicitações de reserva, solicitações pendentes e bloqueios temporários.
Como o Instant Book funciona com a API do Airbnb?
Definição do Instant Book do Airbnb
O Instant Book é um recurso do Airbnb que permite que hóspedes que atendem aos requisitos do anúncio reservem datas disponíveis sem que o proprietário ou anfitrião revise a solicitação antes da confirmação da reserva.
Comportamento do Instant Book com a API do Airbnb
Quando seu anúncio está conectado por meio da API do Airbnb, o Instant Book é ativado automaticamente no Airbnb. Ele não pode ser desativado enquanto a conexão da API do Airbnb estiver ativa. Para parar de usar o Instant Book, você precisa desconectar a conexão da API do Airbnb do PMS da Cloudbeds.
Requisitos do hóspede do Airbnb que permanecem editáveis
Como o Instant Book é ativado automaticamente por meio da conexão da API do Airbnb, você ainda pode editar os requisitos do hóspede em Configurações de Reserva ao editar seus anúncios na extranet do Airbnb.
Escolha quais opções são obrigatórias para hóspedes confirmados:
- Foto do perfil
- Documento de identidade emitido pelo governo
- Recomendação de outros anfitriões
- Mensagem pré-reserva: insira uma mensagem que o hóspede deve ler e responder antes de confirmar a reserva.
O PMS da Cloudbeds processa solicitações de reserva ou bloqueios temporários da API do Airbnb?
Não. O PMS da Cloudbeds atualmente não processa solicitações de reserva, solicitações pendentes ou bloqueios temporários do Airbnb como reservas pendentes por meio da conexão da API do Airbnb.
Se você não deseja receber reservas Instant Book do Airbnb, avalie se a conexão Airbnb iCal é o caminho certo para o seu fluxo de trabalho. O Airbnb iCal funciona de forma diferente da API do Airbnb e possui um comportamento de sincronização mais limitado. Saiba mais em Canais baseados em calendário e conexões iCal no PMS da Cloudbeds.
Tarifas, disponibilidade e preços da API do Airbnb
Use esta seção para verificar como o Airbnb exibe as tarifas e a disponibilidade enviadas pelo PMS da Cloudbeds, e por que os preços podem aparecer diferentes entre os sistemas.
Como posso verificar a precisão das tarifas e da disponibilidade enviadas para o Airbnb?
Quando as tarifas e a disponibilidade do Airbnb são controladas pelo PMS da Cloudbeds, verifique se o Airbnb exibe os preços e a disponibilidade esperados para o tipo de acomodação ou anúncio mapeado.
- Faça o logon na extranet do Airbnb e acesse Anúncios.
- Abra o anúncio que deseja verificar e clique em Pré-visualizar anúncio.
- Na nova página, confirme que você vê o cabeçalho Modo de pré-visualização.
- Selecione as datas da estadia e o número de hóspedes.
As tarifas e a disponibilidade devem corresponder às tarifas base e à disponibilidade no PMS da Cloudbeds para o tipo de acomodação ou anúncio selecionado.
Por que as tarifas diárias são diferentes do calendário no repasse da reserva?
Embora cada tarifa diária possa ser diferente no seu calendário, o Airbnb pega o valor total da reserva e divide pelo número de noites. O Airbnb então exibe esse valor como a tarifa diária.
Por exemplo, nesta reserva de sete noites, as tarifas diárias no calendário foram:
- Sexta-feira: R$ 29
- Sábado: R$ 23,20
- Domingo: R$ 23,20
- Segunda-feira: R$ 18
- Terça-feira: R$ 18
- Quarta-feira: R$ 18
- Quinta-feira: R$ 18
Total: R$ 147,40
O Airbnb dividiu o total pelo número de noites, exibiu como R$ 21,00 por noite e arredondou o total para R$ 148,00.
Por que não consigo ver descontos semanais ou mensais para meus quartos coletivos no Airbnb?
Quando você configura um desconto semanal ou mensal para quartos coletivos no mapeamento do PMS da Cloudbeds, esses descontos não aparecem nas configurações da extranet do Airbnb. Isso não significa que o desconto não está sendo aplicado.
O PMS da Cloudbeds calcula o preço com desconto e envia a tarifa final para o Airbnb com base nas datas da estadia, duração da estadia e número de hóspedes. Como o desconto já é calculado antes do envio da tarifa, o Airbnb pode mostrar Nenhum nos campos de desconto semanal ou mensal na extranet do Airbnb.
No PMS da Cloudbeds, os descontos semanais e mensais são configurados nas configurações de preço do quarto do Airbnb:
Na extranet do Airbnb, os mesmos campos de desconto semanal e mensal podem aparecer como Nenhum, mesmo quando o PMS da Cloudbeds já está enviando a tarifa final com desconto:
Para confirmar se o desconto foi aplicado, verifique uma reserva feita sob a regra de desconto semanal ou mensal. A tarifa final da reserva já deve incluir o desconto em comparação com as tarifas do seu calendário.
Por que o preço do quarto mostrado no Airbnb é diferente do PMS da Cloudbeds?
Os preços dos quartos podem variar entre o Airbnb e o PMS da Cloudbeds por vários motivos. As causas mais comuns são:
- Os impostos e taxas não estão configurados da mesma forma no PMS da Cloudbeds e no Airbnb. Impostos e taxas devem ser configurados de forma consistente para exibir o total correto da reserva.
- O Airbnb aplica descontos ou regras de preço, como descontos por duração da estadia, descontos por política de cancelamento ou descontos de última hora.
- Taxas fixas não estão incluídas no detalhamento da tarifa. Taxas fixas devem ser adicionadas como inclusivas.
Consulte os seguintes artigos para mais informações:
Comunicação com hóspedes via API do Airbnb e saldo de pagamento
Use esta seção para entender como o Airbnb compartilha as informações de contato dos hóspedes por meio da API, como entrar em contato com os hóspedes quando o número de telefone não está disponível e por que as reservas do Airbnb podem apresentar saldo devedor no PMS da Cloudbeds.
Por que não consigo enviar e-mails para hóspedes do Airbnb?
O Airbnb não fornece os endereços de e-mail dos hóspedes para reservas feitas via API devido às políticas do Airbnb. Utilize as ferramentas de mensagens disponíveis no Airbnb para entrar em contato com os hóspedes. Os números de telefone dos hóspedes também podem não estar disponíveis ou serem substituídos por números temporários, dependendo das regras de privacidade do Airbnb. Veja a próxima FAQ para mais detalhes.
Para mais informações, consulte o recurso do Airbnb: Uma atualização para anfitriões que usam o recurso de alias de e-mail.
Por que o número de telefone de um hóspede do Airbnb está ausente ou foi substituído por um número temporário?
O Airbnb limita os números de telefone dos hóspedes compartilhados por meio das reservas via API para proteger anfitriões e hóspedes contra phishing e uso indevido de informações pessoais. A partir da semana de 26 de outubro de 2026, o Airbnb começou a disponibilizar números de telefone temporários para certas reservas, em vez de compartilhar os números reais dos hóspedes.
Quando o Airbnb fornece um número de telefone temporário? Todas as seguintes condições devem ser atendidas:
- A reserva foi aceita em ou após 26 de outubro de 2026.
- O anúncio do Airbnb está localizado nos Estados Unidos ou Canadá.
- Tanto o anfitrião quanto o hóspede possuem um número de telefone.
- Tanto o anfitrião quanto o hóspede residem no mesmo país, seja nos Estados Unidos ou no Canadá.
Quando nenhum número de telefone é fornecido? O Airbnb não envia nem o número de telefone do hóspede nem um número temporário via API para qualquer reserva que não atenda a todas as condições acima. Isso inclui reservas aceitas antes de 26 de outubro de 2026, anúncios fora dos Estados Unidos e Canadá, e reservas em que o anfitrião e o hóspede residem em países diferentes.
O Airbnb pode exibir os últimos quatro dígitos do número real do hóspede na página de detalhes da reserva para fluxos de trabalho como códigos de porta. Isso não significa que o número real ou esses dígitos sejam enviados ao PMS da Cloudbeds via API.
Como posso contatar um hóspede sem número de telefone? Utilize a ferramenta de mensagens do Airbnb ou outro método de mensagem suportado disponível, em vez de depender do campo de número de telefone na reserva do PMS da Cloudbeds.
Essa restrição é determinada pela política de compartilhamento de dados da API do Airbnb, não por uma configuração de número de telefone do PMS da Cloudbeds. Para mais informações, consulte Como funcionam os números de telefone temporários - Central de Ajuda do Airbnb.
Por que aparece um saldo devedor no Cloudbeds para reservas do Airbnb?
Os hóspedes do Airbnb pagam diretamente ao Airbnb, e o Airbnb paga o estabelecimento por transferência bancária. Por causa desse fluxo de pagamento, o PMS da Cloudbeds importa a reserva do Airbnb com um saldo devedor.
Para quitar o saldo, adicione manualmente um pagamento no PMS da Cloudbeds para refletir os fundos que o estabelecimento recebe do Airbnb.
Artigos relacionados
Use estes artigos quando precisar de passos para configuração, detalhes sobre o comportamento do iCal, etapas para desconexão ou orientações sobre configuração de impostos e taxas relacionadas ao Airbnb.
- Conectar API do Airbnb ao PMS da Cloudbeds: Use este guia para conectar a API do Airbnb, autorizar a conta do Airbnb, mapear anúncios e revisar as configurações dos tipos de acomodação.
- Canais com base no calendário e conexões iCal no PMS da Cloudbeds: Use este guia para entender como funcionam as conexões iCal e como elas diferem das conexões via API.
- Airbnb - Como desconectar anúncios do Airbnb do PMS da Cloudbeds: Use este guia quando precisar interromper a sincronização da API do Airbnb para um ou mais anúncios.
Comentários
Por favor, entre para comentar.