| Objetivo | Conectar anúncios do Airbnb ao PMS da Cloudbeds por meio da API do Airbnb e configurar a integração. |
| Ideal para | Proprietários, gerentes gerais e administradores de estabelecimentos responsáveis pela distribuição. |
| Use quando | Você estiver configurando uma conexão completa da API do Airbnb e precisar autorizar, mapear e configurar os anúncios. |
| Requisitos | Um anúncio ativo e listado no Airbnb; acesso à conta do titular do anúncio com foto de perfil; configurações de acomodação, moeda e fuso horário do estabelecimento compatíveis. |
| Resultado esperado | Airbnb autorizado, anúncios mapeados, configurações de acomodação concluídas, e tarifas e disponibilidade podem ser verificadas. |
| Limitações | O Preço Inteligente não é suportado; a Reserva Instantânea é ativada automaticamente; alguns tipos de anúncios do Airbnb têm sincronização de disponibilidade limitada. |
Use este guia para conectar seus anúncios do Airbnb ao PMS da Cloudbeds usando a API do Airbnb. Você vai autorizar a conta do titular do anúncio no Airbnb, mapear os anúncios para as acomodações, revisar as configurações dos quartos e verificar a conexão.
Se você usa um gerenciador de canais de terceiros e precisa apenas de ferramentas selecionadas de comunicação com hóspedes, siga as orientações de conexão personalizada vinculadas abaixo.
Antes de conectar a API do Airbnb
Antes de iniciar a conexão, revise os seguintes requisitos e limitações para evitar problemas de sincronização.
Requisitos de conexão
- O status do seu anúncio deve estar como "Listagem ativa" no Airbnb. A sincronização não funcionará se o anúncio estiver inativo ou não listado.
- As configurações de quartos, moeda e o fuso horário padrão do estabelecimento devem coincidir entre o PMS da Cloudbeds e o Airbnb.
- Antes de iniciar o processo padrão de conexão completa:
- Para uma conexão completa via PMS da Cloudbeds: Certifique-se de que o Airbnb não esteja conectado a outro gerenciador de canais. No Airbnb, vá para Conta > Privacidade e Compartilhamento > Aplicativos Conectados e clique em Remover Acesso, se necessário.
- Para uma conexão personalizada via gerenciador de canais de terceiros: Se você usa SiteMinder, iHotelier, SynXis ou outro provedor e precisa apenas de ferramentas específicas de comunicação com hóspedes da Cloudbeds, siga o guia Mensagens para hóspedes e avaliações para Airbnb e Expedia com gerenciadores de canais de terceiros.
- Recrie os bloqueios de disponibilidade existentes no Airbnb dentro do PMS da Cloudbeds antes de conectar. Bloqueios manuais no Airbnb são removidos quando a conexão é iniciada.
Limitações importantes
- O Preço Inteligente não é suportado pela conexão via API.
- A Reserva Instantânea é ativada automaticamente após a conexão.
- O Airbnb não pode atualizar a disponibilidade para os seguintes tipos de anúncio: carro, condohotel, dormitório, anexo, outro, vaga de estacionamento, pousada, multipropriedade, casa de férias e van house. O PMS da Cloudbeds pode receber reservas, mas a funcionalidade é limitada.
Recursos adicionais
- Consulte o Guia de Implementação do Airbnb para ajuda na implementação.
- Revise as Perguntas Frequentes da API do Airbnb para mais detalhes sobre a conexão.
Conectar a API do Airbnb ao PMS da Cloudbeds
Siga os quatro passos abaixo para autorizar sua conta do Airbnb, mapear seus anúncios, configurar as configurações dos quartos e revisar os ajustes de tarifa base.
Comece ativando o canal Airbnb API no PMS da Cloudbeds e autorizando o acesso à sua conta de proprietário do anúncio no Airbnb.
Antes de autorizar sua conta
- Faça o logon como o proprietário do anúncio no Airbnb. Coanfitriões e equipes de hospedagem não podem conectar o canal.
- A conta do anfitrião principal deve ter uma foto de perfil antes de autorizar um provedor de conectividade.
- Se você não tem certeza de quem é o anfitrião principal, veja O que é um anfitrião principal?
- Vá para Conta
> Configurações
> Distribuição
.
- Abra a guia Descobrir, pesquise por Airbnb API e selecione o cartão do canal.
- Clique em Ativar Canal.
- Em Tipo de Conexão, selecione o tipo de conexão preferido.
Não tem certeza de qual conexão escolher?
Selecionar o tipo de conexão correto ajuda a garantir que os dados dos hóspedes fluam conforme suas necessidades. Veja Mensagens e Avaliações de Hóspedes com Gerenciadores de Canais Terceiros para orientação.
-
Leia o guia de configuração, desative quaisquer bloqueadores de pop-up do navegador e clique em AUTORIZAR.
Se você tiver várias contas no Airbnb, recomendamos abrir o Airbnb.com em outra guia do navegador e fazer logoff antes de iniciar a autorização.
Autorize a Cloudbeds a gerenciar seus anúncios no Airbnb
- Faça o logon usando as credenciais do proprietário do anúncio no Airbnb, não uma conta de coanfitrião.
Uma janela pop-up intitulada Autorizar sua conta Airbnb (API) aparecerá. Certifique-se de que seu navegador permite pop-ups.
Se ocorrerem erros de autorização, faça o logoff de todas as contas Airbnb nos seus navegadores e tente novamente.
- Aceite os termos e condições do Airbnb.
- Clique em Permitir para autorizar o PMS da Cloudbeds.
Uma mensagem de confirmação deve aparecer após a autorização bem-sucedida.
Confirme a conexão
Após autorizar a conta, a interface do PMS da Cloudbeds será atualizada:
- O status do canal muda para Pronto para o mapeamento.
- Seu ID de usuário único (ID do hotel no Airbnb) aparece na seção de Login do Canal.
Para alterar a conta Airbnb vinculada à Cloudbeds ou atualizar suas credenciais, clique em Reautorizar. Isso abrirá a janela de autorização para que você possa fazer o logon com outra conta Airbnb.
Após a autorização, faça o mapeamento das acomodações ou tipos de acomodação da Cloudbeds para os anúncios correspondentes no Airbnb.
- Mapeie os tipos de acomodação no PMS da Cloudbeds para os anúncios correspondentes no Airbnb.
Use apenas mapeamento um a um. Não mapeie um tipo de acomodação para vários anúncios nem o contrário.
Os requisitos de mapeamento dependem da sua configuração no Airbnb. Siga as instruções que correspondem à sua configuração:
- Se você gerencia vários estabelecimentos com um único login da Cloudbeds, pode aparecer um aviso. Você pode ignorar esse aviso e continuar.
- Se uma conta do Airbnb atende a vários estabelecimentos do PMS da Cloudbeds, você pode conectá-los desde que cada estabelecimento faça o mapeamento para seus próprios anúncios, para evitar problemas de sincronização.
Se você encontrar um erro de mapeamento, revise a Solução de problemas da API do Airbnb. Se o problema persistir, entre em contato com o Suporte da Cloudbeds.
Após mapear seus anúncios, o PMS da Cloudbeds leva você para as Configurações do Quarto, onde pode revisar e configurar preços, impostos, descontos e outras configurações do anúncio.
Para informações detalhadas sobre cada campo disponível, consulte Airbnb API: Configurações do Quarto.
- Clique em Configurar ao lado de cada quarto.
- Revise as opções disponíveis para Preço, impostos, regras de preço e descontos. Clique em Visualizar/Editar.
- Revise suas Configurações de Preço.
Se você usar Tarifas avançadas de canais, pode selecionar qual plano tarifário da Cloudbeds alimenta a tarifa padrão do Airbnb.
- Revise as configurações de Impostos.
- Revise as Regras de preço e descontos disponíveis.
Promoção para novo anúncio
Se seu anúncio no Airbnb for elegível e tiver menos de 3 reservas confirmadas, você pode ativar a Promoção para novo anúncio para aplicar um desconto automático de 20% nas primeiras 3 reservas.
Como funciona a promoção para novo anúncio
- A promoção tem o objetivo de aumentar a visibilidade dos novos anúncios e é sincronizada diretamente com o Airbnb.
- O desconto é removido automaticamente após a terceira reserva ou 30 dias desde o lançamento, o que ocorrer primeiro.
Descontos para hóspedes bem avaliados e somente para dispositivos móveis
Em Regras de preço e descontos, dois descontos adicionais do Airbnb podem aparecer abaixo de Promoção de anúncio novo. Você pode ativar ou desativar cada desconto independentemente para cada tipo de acomodação do Airbnb.
- Desconto para hóspedes bem avaliados: Oferece um desconto de 15% para hóspedes do Airbnb com avaliação de 4,8 ou superior e pelo menos 3 avaliações.
- Desconto exclusivo para mobile: Oferece um desconto de 10% para reservas feitas pelo aplicativo móvel do Airbnb.
Para configurar esses descontos, ative ou desative o seletor aplicável para cada tipo de acomodação e salve suas Configurações de Acomodação. Suas seleções são enviadas ao Airbnb junto com as outras configurações do quarto. Você pode ativar um dos descontos, ambos ou nenhum.
Detalhes importantes sobre os descontos do Airbnb
- O Airbnb determina os percentuais dos descontos. Eles não podem ser personalizados no PMS da Cloudbeds.
- Datas bloqueadas e o número de datas bloqueadas usadas ou disponíveis não são exibidas nem editáveis no PMS da Cloudbeds. Datas bloqueadas existentes configuradas no Airbnb são preservadas quando você salva as Configurações de Acomodação.
- O Airbnb valida os requisitos do anúncio quando as configurações são salvas. Por exemplo, um anúncio sem fotos pode retornar o erro "Seu anúncio precisa de fotos antes de poder ser ativado". Resolva o problema do anúncio antes de salvar novamente.
Configurações adicionais
Você também pode configurar Itens de tarefa de check-out para selecionar as tarefas que os hóspedes devem completar antes do check-out.
Quando a configuração do quarto for bem-sucedida, a página de Mapeamento dos Quartos exibirá Configuração Completa.
Se necessário, configure um ajuste de tarifa base para modificar as tarifas enviadas ao Airbnb por uma porcentagem ou valor fixo.
Para detalhes sobre como os ajustes funcionam, consulte Ajuste de tarifa base ou como enviar tarifas diferentes para os canais.
Após concluir esta etapa, o mapeamento do seu anúncio estará finalizado. Você pode retornar à página de mapeamento a qualquer momento para atualizar o mapeamento dos quartos, as configurações dos quartos ou os ajustes de tarifa base.
Na página de Configurações dos quartos, verifique se seus anúncios estão mapeados corretamente e se não há erros ou configurações faltando.
Após conectar: verifique e gerencie a integração
Depois de concluir a conexão da API do Airbnb, verifique se seus anúncios estão recebendo as tarifas, disponibilidades e configurações corretas. Realize as seguintes verificações antes de confiar na integração para novas reservas.
- Verifique tarifas e disponibilidade. Abra o calendário do seu anúncio no Airbnb e simule uma reserva de hóspede para confirmar as tarifas e disponibilidades esperadas.
- Revise impostos, taxas e comissões. Se aplicável, adicione impostos, taxas ou comissões à Origem da Reserva: Airbnb API no PMS da Cloudbeds.
- Desative a conexão anterior do Airbnb iCal. Se você usava o iCal anteriormente, siga as instruções para desativar o Airbnb iCal para evitar atualizações conflitantes.
- Reimporte reservas anteriores do iCal. Reimporte todas as reservas que estavam conectadas anteriormente via iCal.
- Gerencie tarifas, disponibilidade e restrições no PMS da Cloudbeds. Após a conexão, os anfitriões não podem editar esses campos diretamente no Airbnb, pois o PMS da Cloudbeds os gerencia.
- Evite alterações feitas por contas de coanfitrião. Coanfitriões ainda podem ver campos editáveis no Airbnb, mas não devem alterá-los. Edições diretas podem causar discrepâncias nas tarifas ou disponibilidade e overbookings.
- Ative a mensagem do Airbnb, se aplicável. Se você usa o Cloudbeds Guest Experience, siga Cloudbeds Guest Experience Messaging: Tudo que você precisa saber para configurar as mensagens do Airbnb.
Atualização sobre privacidade do número de telefone do hóspede Airbnb (outubro de 2026)
A partir da semana de 26 de outubro de 2026, o Airbnb limita os números de telefone dos hóspedes compartilhados por meio das reservas via API para proteger informações pessoais e reduzir riscos de phishing.
- Números de telefone temporários: O Airbnb fornece um número temporário para reservas aceitas a partir de 26 de outubro de 2026, quando o anúncio estiver nos Estados Unidos ou Canadá, tanto o anfitrião quanto o hóspede tiverem números de telefone, e ambos residirem no mesmo país.
- Sem número de telefone: Para todas as outras reservas, incluindo as aceitas antes de 26 de outubro de 2026, o Airbnb não fornece o número de telefone do hóspede nem número temporário pela API.
Se o número de telefone do hóspede não estiver disponível no PMS da Cloudbeds, use as ferramentas de mensagens disponíveis do Airbnb para se comunicar com o hóspede. Para mais informações, consulte Como funcionam os números de telefone temporários - Central de ajuda do Airbnb.
Após concluir essas verificações, sua conexão API do Airbnb estará pronta para uso contínuo. Continue gerenciando as tarifas, disponibilidades e restrições suportadas no PMS da Cloudbeds para manter seus anúncios sincronizados.
Próximo passo
Para entender como a conexão funciona após a configuração, incluindo o comportamento da sincronização e perguntas comuns, revise as Perguntas Frequentes da API do Airbnb.
Comentários
Artigo fechado para comentários.