Integrações de PMS (Beds24 e Hostfully)

Se a sua empresa já gerencia suas villas em outro sistema de gestão de propriedades (PMS), você pode conectá-lo ao Argonautas em vez de digitar tudo novamente à mão. O Argonautas é compatível com o Beds24 e o Hostfully. Uma vez conectado, suas propriedades, reservas, tarifas e disponibilidade, e mensagens dos hóspedes fluem do PMS para o Argonautas e se mantêm atualizadas automaticamente.

O seu PMS continua responsável pelos registros que envia. O Argonautas os lê, e você não pode editá-los no Argonautas. Faça as alterações no PMS e elas serão transferidas na próxima sincronização.

Quem Pode Ver Isto

A integração de PMS é ativada para cada empresa pelo suporte do Argonautas. O cartão Property management system só aparece em Configurações > Integrações depois que o suporte o ativar para a sua empresa. Se você usa o Beds24 ou o Hostfully e não vê o cartão, entre em contato com o suporte.

Administradores e gerentes de propriedades podem conectar, revisar e importar. Cada empresa pode conectar um PMS.

Conectando o Seu PMS

Abra Configurações > Integrações e localize o cartão Property management system. Em Qual sistema?, escolha Beds24 ou Hostfully.

Beds24

O Beds24 se conecta com um código de convite de uso único que você gera no Beds24. O cartão lista as etapas em Antes de começar:

1. No Beds24, vá em Settings → Marketplace → API e gere um código de convite.
2. Ao gerá-lo, conceda todos os escopos listados em Permissões a conceder: read:bookings, read:bookings-personal, read:bookings-financial, read:properties, read:inventory, write:inventory e write:properties.
3. Cole o código em Código de convite e clique em Conectar.

O código expira 24 horas após a geração e funciona apenas uma vez. Se a conexão falhar, gere um novo código no Beds24 e cole esse. Tentar o mesmo código novamente não funcionará.

Conceda todos os escopos na primeira vez. O Beds24 fixa os escopos quando você cria o código, e eles não podem ser adicionados depois. Se você deixar um de fora, a única solução é desconectar e conectar novamente com um novo código. Sem read:bookings-personal, as estadias importadas exibem um hóspede genérico em vez de nomes, e-mails e números de telefone reais. Sem read:bookings-financial, os preços das reservas e a comissão não podem ser lidos. Sem write:inventory, você não pode definir o preço de uma villa do Beds24 pelo Argonautas (veja Definindo um Preço do Beds24 pelo Calendário).

Hostfully

O Hostfully se conecta com as credenciais de API da sua conta:

1. No Hostfully, abra Settings → API e copie sua chave de API e o UID da agência.
2. Insira-os em Chave de API e UID da agência no cartão.
3. Clique em Conectar.

O Argonautas verifica as credenciais com o Hostfully antes de salvar qualquer coisa. Se forem rejeitadas, o cartão mostrará o erro no local. Verifique ambos os valores no Hostfully e tente novamente.

O Que Acontece Logo Após a Conexão

Assim que você se conecta, o Argonautas busca as unidades alugáveis no seu PMS. Nada é importado ainda. Ele apenas encontra as unidades e pergunta o que cada uma é (veja a próxima seção).

Revisando as Unidades Descobertas

Cada unidade encontrada no seu PMS precisa de uma decisão antes que suas reservas sejam importadas. Quando há unidades aguardando, o cartão exibe um banner amarelo ({count} unidade(s) precisam de uma decisão) e o status muda para Precisa de revisão. Clique em Revisar unidades para abrir Revisar unidades descobertas.

Para cada unidade, escolha uma das opções em O que é isto? e clique em Aplicar:

Opção	O que faz
Criar uma nova propriedade	O Argonautas cria uma nova propriedade para esta unidade na próxima importação.
Esta é a minha "…" existente	Vincula a unidade a uma propriedade que você já tem no Argonautas. A propriedade mantém sua descrição, fotos e comodidades. A partir de então, o seu PMS controla sua disponibilidade, datas e status de reserva.
Não importar esta	Deixa a unidade de fora. Nenhuma de suas reservas é importada.

O Argonautas pode sugerir uma possível correspondência para uma unidade. Essa sugestão compara apenas os nomes, então verifique-a antes de escolher.

Importando Reservas

Quando cada unidade tiver uma decisão, clique em Importar reservas. A importação é executada em segundo plano, e a data da Última importação no cartão é atualizada quando ela termina. Você não pode iniciar uma importação enquanto houver unidades aguardando. O cartão exibe "Conclua a revisão das unidades acima antes de importar."

A linha de números no cartão mostra quantas unidades estão Mapeadas, Aguardando revisão e Ignoradas, além da data da Última importação.

Outros botões no cartão:

• Atualizar unidades verifica novamente o seu PMS em busca de novas unidades. As novas aparecem na lista de revisão.
• Testar conexão confirma que o Argonautas ainda consegue acessar o seu PMS.
• Desconectar interrompe todas as importações futuras e exclui a credencial armazenada. Suas propriedades e decisões de mapeamento permanecem. Para reconectar uma conta Beds24, você precisará de um novo código de convite.

Mantendo as Reservas Sincronizadas

Após a primeira importação, o Argonautas se mantém atualizado com o seu PMS de três maneiras:

• Consulta de reservas: aproximadamente a cada 5 minutos, o Argonautas consulta o seu PMS em busca de reservas novas, alteradas ou canceladas.
• Reconciliação noturna: uma verificação completa toda noite captura qualquer coisa que a consulta tenha deixado passar.
• Alertas instantâneos de reserva (webhooks): o seu PMS informa ao Argonautas no momento em que uma reserva é feita ou cancelada.

Os alertas instantâneos são importantes porque as villas importadas ainda podem ser reservadas diretamente pelo Argonautas. Quanto mais rápido o Argonautas souber de uma venda no seu PMS, menor a janela em que as mesmas noites poderiam ser vendidas duas vezes. Configure-os assim que se conectar.

Alertas Instantâneos de Reserva para o Beds24

O Beds24 não tem como configurar isto remotamente, então você o adiciona manualmente. O painel Alertas instantâneos de reserva do cartão exibe uma URL do Webhook e um segundo valor (um nome de cabeçalho e seu valor), cada um com um botão de copiar. No Beds24, vá em Settings → Properties → Access → Booking Webhook, cole ambos os valores e escolha version 2 (with personal data).

Faça isto uma vez por propriedade do Beds24, ou seja, o contêiner que agrupa seus tipos de quarto, não uma vez por villa.

Alertas Instantâneos de Reserva para o Hostfully

O Hostfully pode ser configurado a partir do Argonautas. No painel Alertas instantâneos de reserva do cartão, clique em Registrar webhooks. Quando for bem-sucedido, o botão muda para Webhooks registrados. e você não precisa clicar nele novamente.

O Que é Sincronizado do Seu PMS

Dados	Beds24	Hostfully	Observações
Propriedades (nome, quartos, banheiros, número de hóspedes, endereço, localização no mapa)	Sim	Sim	Mantidas em sincronia com o PMS. Estes campos não podem ser editados no Argonautas.
Reservas (datas, status, hóspede)	Sim	Sim	Somente leitura no Argonautas.
Tarifas por noite e datas bloqueadas	Sim	Sim	Atualizadas a cada importação e na reconciliação noturna. É a partir daqui que o seu site de reservas diretas cotiza.
Fotos e descrições	—	Sim	Importadas quando uma importação cria uma nova propriedade. As fotos são copiadas para o Argonautas, não vinculadas. Uma descrição apenas preenche um campo vazio e nunca sobrescreve o texto que você escreveu.
Comodidades	—	Sim	Comodidades correspondentes são adicionadas às novas propriedades. As comodidades que você definiu nunca são removidas.
Mensagens de hóspedes e anfitriões	Sim	Sim	Uma cópia somente leitura na sua caixa de entrada. Veja Mensagens do Seu PMS. Para o Beds24, isto requer o escopo read:bookings-personal.

Como as Reservas São Rotuladas

Cada reserva importada mantém o canal de origem (Airbnb, Booking.com, VRBO e assim por diante) como sua origem, para que seus relatórios mostrem de onde vem o seu negócio. Dois detalhes:

• Reservas do Airbnb que o Airbnb já pagou aparecem como Pago. Elas são registradas como pagas fora do Argonautas, então nunca exibem um saldo pendente.
• Reservas do VRBO que chegam ao Beds24 por meio de um feed iCal são rotuladas como VRBO, não "Outro". Um feed iCal carrega apenas datas, então estas reservas não têm preço no Argonautas.

Como as Propriedades Importadas se Comportam

As propriedades importadas são propriedades Diretas comuns. Elas não são propriedades de parceiros:

• Elas pertencem à sua empresa. Uma nova propriedade importada é atribuída a um registro de proprietário com o nome da sua empresa, e suas reservas aparecem nos seus relatórios financeiros. Nenhum acesso ao portal do proprietário é criado com ela.
• Elas são reserváveis diretamente. O seu site de reservas diretas lê suas tarifas e disponibilidade do Argonautas.
• Sem channel manager. O seu PMS já distribui estas villas para as OTAs, então o Argonautas nunca envia suas tarifas ou disponibilidade. Na aba Canais da propriedade, o channel manager é substituído por um cartão Distribuição que diz Os canais são gerenciados pelo Beds24 (ou Hostfully). Gerencie seus anúncios nas OTAs no seu PMS.
• Preços somente visualização. Na aba Preços, a lista de temporadas e o calendário de tarifas são somente visualização. Defina as tarifas no seu PMS. Em uma villa do Beds24, você também pode definir o preço por noite pelo calendário (veja Definindo um Preço do Beds24 pelo Calendário). As tarifas do Hostfully só podem ser alteradas no Hostfully.
• Campos pertencentes ao PMS estão bloqueados. Editar um campo controlado pelo PMS, como o nome, o número de quartos ou o endereço, é rejeitado com "Estes campos são gerenciados pela importação externa do PMS e não podem ser editados aqui". As reservas importadas também são somente leitura. Altere-as no seu PMS.
• Sem mensagens automáticas para hóspedes. O Argonautas não envia confirmações de reserva, mensagens de ciclo de vida ou outros e-mails automáticos para hóspedes de reservas importadas. O seu PMS já cuida desse relacionamento.

Definindo um Preço do Beds24 pelo Calendário

Se o seu código de convite do Beds24 concedeu write:inventory, um gerente de imóveis pode definir o preço por noite de uma villa do Beds24 pelo Argonautas, sem abrir o Beds24. As villas do Hostfully não têm essa opção: suas tarifas são somente leitura no Argonautas.

1. Abra Calendário, mude para Vista Matricial e verifique se a linha de tarifas está visível (o botão Tarifas ao lado da legenda). Veja Visualização Matriz.
2. Clique na tarifa de uma noite de uma villa do Beds24. A caixa de diálogo Definir preço no Beds24 abre nessa noite.
3. Ajuste De e Até (última noite) se quiser um período e informe o Novo preço por noite. Preço atual mostra o preço que o Argonautas leu por último do Beds24 para essas noites.
4. Clique em Salvar.

O Beds24 guarda um único preço por noite, então um período deixa todas as noites com o mesmo preço, inclusive preços de fim de semana ou de eventos que você definiu no Beds24. Quando mais de uma noite é afetada, a caixa de diálogo avisa antes: "As {count} noites ficarão a {price} no Beds24."

Você pode definir até 62 noites por vez. Noites passadas não podem ser alteradas, e noites a mais de cerca de um ano são recusadas ("Muito à frente para confirmar com o Beds24.").

Depois de salvar, o Argonautas lê o preço de volta do Beds24 e informa o resultado:

Mensagem	O que significa
Salvo no Beds24.	O Beds24 já tem o novo preço. A caixa de diálogo fecha.
O Beds24 aceitou a alteração, mas informa … para estas noites (você pediu …).	Uma regra de preços do Beds24 pode estar substituindo. Verifique a configuração de preços no Beds24.
Salvo no Beds24. Ainda não foi possível reler; o calendário atualiza na próxima sincronização.	A alteração foi enviada, mas a releitura não. Não é preciso fazer nada.
O Beds24 não respondeu a tempo. Pode ter sido salvo; verifique o calendário.	Confira a noite novamente antes de tentar outra vez.

Se uma sincronização do calendário já estiver em andamento, você verá "A calendar sync is running; try again in a minute." (essa mensagem aparece em inglês).

Quando a conexão não pode gravar preços, clicar na tarifa de uma villa do Beds24 a mostra como somente leitura com o motivo, por exemplo "Beds24 connection lacks rate access." se o código de convite não incluiu write:inventory. Não é possível adicionar escopos a uma conexão existente: desconecte e conecte novamente com um novo código de convite que conceda todos os escopos.

Mensagens do Seu PMS

As mensagens de hóspedes e anfitriões do seu PMS aparecem na Caixa de Entrada como uma cópia somente leitura, verificada aproximadamente a cada 15 minutos. Cada conversa é anexada à sua reserva e mostra o nome do hóspede, com o canal da reserva (por exemplo, Airbnb) como o canal.

Estas conversas são para contexto. Responda ao hóspede pelo seu PMS ou pela OTA. Uma resposta digitada no Argonautas não chegará ao hóspede.

Perguntas Frequentes

Não vejo o cartão Property management system. O suporte do Argonautas ativa a integração para cada empresa. Entre em contato com o suporte para que seja habilitada.

Meu código de convite do Beds24 foi rejeitado. Os códigos de convite funcionam uma vez e expiram 24 horas após a criação. Gere um novo código no Beds24 (Settings → Marketplace → API) e cole esse.

O cartão diz "Esta conexão está sem permissões." O código de convite do Beds24 foi gerado sem um dos escopos listados no cartão. Você não pode alterar escopos em uma conexão existente. Desconecte, gere um novo código de convite com todos os escopos marcados e conecte novamente.

Por que algumas reservas não foram importadas? As reservas são importadas apenas para unidades Mapeadas. Unidades Aguardando revisão ou Ignoradas não são importadas. Abra Revisar unidades e tome uma decisão para cada uma.

Posso renomear uma propriedade importada? O nome vem do seu PMS e é atualizado a cada sincronização. Renomeie a unidade no seu PMS. Se você precisar de um nome de exibição diferente no Argonautas em relação ao seu PMS, entre em contato com o suporte.

Posso conectar uma propriedade importada ao Airbnb ou Booking.com pelo Argonautas? Não. O seu PMS já a lista nas OTAs, e conectá-la duas vezes criaria o risco de reservas duplicadas. A aba Canais informa qual PMS a gerencia.

De onde vêm as avaliações do Airbnb para propriedades importadas? Veja Avaliações de Hóspedes.

Relacionado

• Guia de Configurações: a seção Integrações onde este cartão fica.
• Avaliações de Hóspedes: como as avaliações de propriedades importadas chegam ao Argonautas.
• Guia de Mensagens: a caixa de entrada unificada onde as mensagens do PMS aparecem.
• Integração de Canais: distribuição para propriedades que o próprio Argonautas gerencia.
• Propriedades Gerenciadas por Parceiros: como as propriedades de parceiros diferem das importadas.