A integração com o Cloudbeds: o que o Converstay lê, e o que nunca toca
O Converstay funciona só com o Cloudbeds e se conecta com uma chave de API só de leitura, três webhooks de reservas e um trecho de código no motor de reservas. Veja exatamente o que cada parte faz, para o hotel e para quem cuida da sua conta do Cloudbeds.
Atualizado em 16 de novembro de 2026
As três partes
- Uma chave de API só de leitura que você cria no Cloudbeds, com acesso de leitura a Hotel, Rate, Reservation e Room.
- Três webhooks que o Converstay assina com essa chave: reserva criada, status da reserva alterado e datas da reserva alteradas.
- Um trecho de código de uma linha no Custom JavaScript do motor de reservas, ou no Google Tag Manager, que percebe quando um hóspede digita o e-mail e sai.
O que o Converstay lê do Cloudbeds
Tudo o que ele lê serve para deixar o e-mail do hóspede exato e para contar as reservas com honestidade:
| Dados do Cloudbeds | Para quê |
|---|---|
| Hotel: nome, endereço, moeda, fuso horário | O remetente, o rodapé do e-mail e os preços na sua moeda |
| Quartos: nomes e fotos | O hóspede vê o quarto que escolheu, com a foto |
| Tarifas e disponibilidade | A tarifa atual para as datas dele, alertas de queda de preço e a conferência de lotação |
| Reservas: e-mail do hóspede, datas, status, total | Parar de escrever a quem reservou e associar cada reserva que voltou |
A chave não consegue criar, alterar nem cancelar nada no Cloudbeds. O Converstay nunca vê dados de cartão: o pagamento acontece no próprio motor de reservas do Cloudbeds, e o trecho de código não lê a etapa de pagamento.
O que o trecho de código faz no motor de reservas
O trecho carrega o rastreador do Converstay no seu motor de reservas do Cloudbeds. Ele acompanha as etapas que o hóspede percorre, salva o quarto, as datas, a tarifa e o idioma escolhidos e salva o e-mail assim que o hóspede o digita no formulário de dados. Nada é enviado a um hóspede que nunca digitou um e-mail.
Ele também pode mostrar os cartões opcionais que você ativa no painel: as suas vantagens de reservar direto quando o hóspede vai para outra aba, o Send My Stay, um aviso de que outros hóspedes estão olhando as mesmas datas e outros links de reserva quando uma data está esgotada. Cada um fica desligado até você ativar.
Como as reservas são associadas
Quando o Cloudbeds avisa o Converstay de uma nova reserva, ele procura um hóspede que saiu do motor de reservas com o mesmo e-mail, no mesmo hotel. Uma associação interrompe os e-mails que ainda estavam para sair e, se o Converstay já tinha escrito para esse hóspede, a reserva conta como recuperada.
As reservas que chegam sem e-mail são associadas pelo hotel, pelas datas e por uma janela de duas horas em torno do momento em que o hóspede saiu. Cancelamentos e mudanças de datas chegam pelos outros dois webhooks, então uma reserva cancelada deixa de contar no mesmo dia. Reservas feitas por telefone, WhatsApp ou na recepção também contam, identificadas pelo canal, quando o e-mail do hóspede coincide.
Configurando
O painel guia você e confere cada etapa. Em resumo:
- No Cloudbeds, abra Account → Apps & Marketplace → API Credentials e crie uma credencial chamada Converstay.
- Crie a chave de API com R (leitura) marcado para Hotel, Rate, Reservation e Room e cole a chave no Converstay. Os webhooks são assinados para você.
- Cole o trecho de código em Booking Engine → Customize → Custom JavaScript, ou adicione-o ao Google Tag Manager.
- Conecte o seu domínio de envio e aprove os e-mails quando estiver satisfeito com eles.
O passo a passo completo, com os problemas mais comuns, está em acompanhamento no Cloudbeds.
Desligando
Apague a chave de API no Cloudbeds e remova o trecho de código do motor de reservas, e o Converstay para de ler qualquer coisa na hora. Você pode pedir que a gente apague os dados do seu hotel a qualquer momento, como descreve a política de privacidade.
Perguntas
O Converstay está no Marketplace do Cloudbeds?
Ainda não. O Converstay se conecta com uma chave de API que você cria na sua própria conta do Cloudbeds, o que funciona em qualquer plano do Cloudbeds com acesso à API.
O Converstay pode alterar as minhas reservas ou tarifas?
Não. A chave é só de leitura: Hotel, Rate, Reservation e Room. Ela não consegue criar, alterar nem cancelar nada.
Quais webhooks do Cloudbeds o Converstay usa?
Reserva criada, status da reserva alterado e datas da reserva alteradas. Com eles, os e-mails param assim que o hóspede reserva e os cancelamentos saem da conta.
Funciona com o Cloudbeds Booking Engine Plus?
Sim. O trecho de código vai no Custom JavaScript do motor de reservas, ou no Google Tag Manager, se o seu motor de reservas usa.