Conexão da API do Airbnb ao PMS da Cloudbeds

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 da propriedade responsáveis pela distribuição.
Use este recurso 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 da propriedade 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 Preço Inteligente não é suportado; 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ê irá autorizar a conta do titular do anúncio do Airbnb, mapear anúncios para acomodações, revisar as configurações das acomodações 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

  1. O status do seu anúncio deve estar como "Listada" no Airbnb. A sincronização não funcionará se o anúncio estiver inativo ou não listado.
  2. As configurações de quartos, configurações de moeda e o fuso horário padrão da propriedade devem coincidir entre o PMS da Cloudbeds e o Airbnb.
  3. 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 Mensagens para hóspedes e avaliações para Airbnb e Expedia com gerenciadores de canais de terceiros.
  4. Recrie os bloqueios de disponibilidade existentes no Airbnb no PMS da Cloudbeds antes de conectar. Bloqueios manuais do 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 consegue atualizar a disponibilidade para estes tipos de anúncio: car, condohotel, dorm, in_law, other, parkingspace, pousada, timeshare, vacation_home e van house. O Cloudbeds PMS pode receber reservas, mas a funcionalidade é limitada.

Recursos adicionais

Conectando 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 à conta do proprietário do seu anúncio no Airbnb.

Antes de autorizar sua conta

  • Faça o logon como o proprietário do anúncio no Airbnb. Co-anfitriões e equipes de hospedagem não podem conectar o canal.
  • A conta principal do anfitrião 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, consulte: O que é um anfitrião principal?
  1. Vá para Conta Account menu > Configurações Settings > Distribuição Distribution icon;
  2. Abra a guia Descobrir, pesquise por Airbnb API e selecione o cartão do canal;
  3. Clique em Ativar canal;

Enable Airbnb API in Cloudbeds PMS

  1. Em Tipo de conexão, selecione o tipo de conexão preferido;

Airbnb connection type selection

Não sabe qual conexão escolher?

Selecionar o tipo de conexão correto ajuda a garantir que os dados dos hóspedes fluam conforme suas necessidades. Consulte Mensagens e avaliações de hóspedes com Gerenciadores de Canais Terceiros para orientação.

  1. Leia o guia de configuração, desative quaisquer bloqueadores de pop-up (janelas) do navegador e clique em AUTORIZAR;

    Se você tem várias contas no Airbnb, recomendamos abrir o Airbnb.com em outra guia do navegador e fazer logoff antes de iniciar a autorização.

Authorize Airbnb API connection

Autorize a Cloudbeds a gerenciar seus anúncios no Airbnb

  1. Faça o logon usando as credenciais do proprietário do anúncio no Airbnb, não uma conta de co-anfitrião;

Uma janela intitulada Autorize sua conta Airbnb (API) aparecerá. Certifique-se de que seu navegador permite pop-ups.

Airbnb authorization pop-up

Se ocorrerem erros de autorização, faça logoff de todas as contas Airbnb nos seus Navegadores e tente novamente.

  1. Aceite os termos e condições do Airbnb;
  2. Clique em Permitir para autorizar o PMS da Cloudbeds.

Permitir acesso da Cloudbeds ao Airbnb

Uma mensagem de confirmação deve aparecer após a autorização bem-sucedida.

Confirmação de autorização bem-sucedida do Airbnb

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.
  • Sua ID de usuário única (ID do hotel Airbnb) aparece na seção de Login do Canal.

Canal Airbnb pronto para mapeamento

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

  1. 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 múltiplos 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:

Mapeamento de acomodações do Airbnb no PMS da Cloudbeds

  • Se você gerencia múltiplas propriedades com um único logon da Cloudbeds, pode aparecer um aviso. Você pode ignorar esse aviso e continuar.
  • Se uma conta do Airbnb atende a múltiplas propriedades do PMS da Cloudbeds, você pode conectá-las desde que cada propriedade seja mapeada para seus próprios anúncios, para evitar problemas de sincronização.

Aviso de mapeamento do Airbnb para múltiplas propriedades

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 API do Airbnb: Configurações do Quarto.

  1. Clique em Configurar ao lado de cada quarto;

Configurar configurações do quarto Airbnb

  1. Revise as opções disponíveis para Preço, impostos, regras de preço e descontos. Clique em Visualizar/Editar;

Configurações de preço e desconto do quarto Airbnb

  1. Revise suas Configurações de Preço;

Se você usar Tarifas avançadas de canais, pode selecionar qual plano tarifário do PMS da Cloudbeds alimenta a tarifa padrão do Airbnb.

Configurações de preço do Airbnb e seleção de plano tarifário

  1. Revise as configurações de Impostos;

Configurações de impostos do Airbnb

  1. Revise as Regras de preço e descontos disponíveis.

Regras de preço e descontos do Airbnb

Opções de configuração de desconto do Airbnb

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 automaticamente um desconto 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.
Configurações da promoção para novo anúncio do Airbnb
A promoção fica visível apenas para anúncios elegíveis com menos de três reservas durante a etapa Regras de preço e descontos da configuração da conexão da API do Airbnb.

Descontos para hóspedes com alta avaliação 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 quarto. 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.

Configurações de desconto para hóspedes bem avaliados e exclusivo para mobile

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 exibidos nem editáveis no PMS da Cloudbeds. Datas bloqueadas existentes configuradas no Airbnb são preservadas quando você salva as configurações do quarto.
  • 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.

Configurações de tarefas de check-out do Airbnb

Quando a configuração do quarto for bem-sucedida, a página de Mapeamento dos quartos exibirá Configuração Completa.

Status de configuração do quarto do Airbnb concluída

Se necessário, configure um Ajuste de tarifa base para modificar as tarifas enviadas para o 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.

Configurações de ajuste de tarifa base do Airbnb

Após concluir esta etapa, seu mapeamento de 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.

Mapeamento do Airbnb e configurações dos quartos concluídos

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.

  1. 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.
  2. Revise impostos, taxas e comissões. Se aplicável, adicione impostos, taxas ou comissões à Origem da reserva: Airbnb API no PMS da Cloudbeds.
  3. 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.
  4. Reimporte reservas anteriores do iCal. Reimporte todas as reservas que estavam conectadas anteriormente via iCal.
  5. 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.
  6. Evite alterações feitas por contas de co-anfitrião. Co-anfitriõ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.
  7. Ative a mensagem do Airbnb, se aplicável. Se você usa o Cloudbeds Guest Experience, siga a mensagem do Cloudbeds Guest Experience: tudo que você precisa saber para configurar a mensagem do Airbnb.

Após concluir essas verificações, sua conexão da 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, consulte as Perguntas Frequentes da API do Airbnb.

Esse artigo foi útil?
Usuários que acharam isso útil: 14 de 28

Comentários

0 comentário

Artigo fechado para comentários.