Como ligar o co-anfitrião IA ao Smoobu?

Utiliza o Smoobu para gerir os seus alojamentos de curta duração? Pode ativar o co-anfitrião IA da Nowistay nos seus anúncios, quer as reservas venham do Airbnb, da Booking.com, do VRBO, da Expedia ou de qualquer outra plataforma ligada ao seu PMS. Eis como fazer, passo a passo.

O Smoobu passou a exigir uma chave de API e um segredo

O Smoobu alterou a forma como protege a sua API. Todos os pedidos têm agora de ser assinados com um segredo emitido em conjunto com a chave de API, e um pedido enviado apenas com a chave é recusado. Duas consequências:

• Novas ligações: copie a chave e o segredo quando os criar no Smoobu. A Nowistay pede os dois.
• Ligações feitas antes desta alteração: a chave guardada na Nowistay não tem segredo associado, por isso deixa de funcionar. Crie uma nova chave no Smoobu e guarde-a com o respetivo segredo, seguindo a última secção deste artigo.

O Smoobu mostra o segredo apenas uma vez, na janela que aparece logo a seguir à criação da chave. Se fechar essa janela sem o copiar, o segredo não pode voltar a ser apresentado e tem de criar uma nova chave.

Antes de começar

• Uma conta Smoobu ativa num plano pago, com os seus alojamentos já configurados. Não é possível criar chaves de API durante um período de teste gratuito.
• Os seus anúncios corretamente sincronizados no Smoobu com as suas plataformas de reservas (Airbnb, Booking.com, VRBO, Expedia).
• Uma subscrição AI Channel Manager ativa na Nowistay.

Passo 1: criar a sua chave de API e o segredo no Smoobu

1. Inicie sessão em smoobu.com.
2. Aceda a Advanced settings (Definições avançadas) e depois a API Keys (Chaves de API).
3. Clique em Create (Criar), dê um nome à chave e submeta.
4. A janela Token created mostra a chave e o segredo. Copie ambos e guarde-os num local seguro antes de a fechar.

Deixe esta página do Smoobu aberta, vai voltar a ela no passo 2 para colar o URL do webhook.

Passo 2: ligar o Smoobu à Nowistay

1. Na Nowistay, abra a página Alojamentos e clique em Integrações de PMS no canto superior direito.

2. Na secção PMS suportados, encontre o cartão Smoobu e clique em Ligar ao Smoobu.

3. Cole a sua chave em Chave da API e o seu segredo em Segredo da API.
4. Ainda não clique em Confirm (Confirmar). Copie o conteúdo do campo URL do webhook a copiar para o Smoobu, na parte inferior da janela.

5. De volta ao Smoobu, na mesma página Advanced settings e API Keys, cole esse endereço no campo Webhook URL e clique em Save (Guardar). Se outra ferramenta já usar esse campo, adicione o nosso a seguir ao endereço existente em vez de o substituir.
6. Volte à Nowistay e clique em Confirm (Confirmar).

O webhook é o que informa a Nowistay das suas novas reservas e das novas mensagens dos seus hóspedes. Sem ele, a ligação parece correta mas nada chega ao seu painel, por isso não salte o passo 5.

As suas credenciais são verificadas junto do Smoobu antes de serem guardadas. Se a chave ou o segredo estiverem errados, vê o erro de imediato, em vez de uma ligação que diz funcionar e fica vazia.

Passo 3: associar cada alojamento

O conector dá à Nowistay acesso à sua conta Smoobu. Cada alojamento da Nowistay tem, no entanto, de ser associado ao alojamento certo do Smoobu.

1. Na página Alojamentos, abra o menu … de um alojamento e escolha Sincronização.
2. Se o pequeno questionário aparecer, responda que usa um PMS, que o quer manter e que é uma das plataformas listadas.
3. Selecione Smoobu no campo PMS e o alojamento correspondente no campo Alojamento, e guarde.
4. Repita para cada alojamento que o co-anfitrião IA deva tratar.

Depois de um alojamento estar associado, as respetivas reservas e mensagens dos hóspedes passam a fluir para a Nowistay e o co-anfitrião IA responde aos seus hóspedes antes, durante e depois da estadia.

Atualizar a sua chave de API do Smoobu

Use esta opção quando renovar a sua chave e quando substituir uma ligação criada antes de o segredo se tornar obrigatório.

1. Crie uma nova chave no Smoobu, como descrito no passo 1, e copie a chave e o segredo.
2. Na Nowistay, abra Alojamentos, depois Integrações de PMS, e clique em Atualizar chave da API no cartão do Smoobu.
3. Cole a nova chave e o novo segredo e clique em Confirm (Confirmar).
4. Verifique se os seus alojamentos continuam sincronizados e depois revogue a chave antiga no Smoobu.

Use sempre Atualizar chave da API em vez de Repor conector. Repor desassocia todos os alojamentos ligados ao Smoobu e teria de os associar novamente um a um.