API e webhooks para sistema de hotel

Conecte o QuartoVerde à sua contabilidade, dashboards, automações e ferramentas de IA. Consulte reservas, hóspedes e pagamentos por uma API REST e receba um webhook assim que algo mudar.

POST https://your-app.com/webhooks/lodgehog
X-Lodgehog-Event: reservation.created
X-Lodgehog-Signature: t=1790000000,v1=5f2c9a…

{
  "event": "reservation.created",
  "data": {
    "reservation": {
      "booking_code": "845D400246",
      "status": "confirmed",
      "source": { "channel_name": "Booking.com" },
      "checkin_date": "2026-10-10",
      "checkout_date": "2026-10-12",
      "guest": { "name": "Ana Souza" },
      "totals": { "total_price": "340.00", "payment_status": "unpaid" }
    }
  }
}

Seus dados, nas suas ferramentas

Chega de copiar reservas para planilhas. Envie-as direto para sua contabilidade, relatórios ou CRM, sem exportações manuais.

Em tempo real, não no dia seguinte

Os webhooks avisam seus sistemas sobre uma nova reserva, alteração ou cancelamento em segundos, seja qual for o canal de origem.

Pronta para IA

Documentação escrita para modelos de IA, para que o ChatGPT, o Claude ou o Cursor criem uma integração para você a partir de um único link.

O que você pode criar com ela

Algumas formas de colocar os dados do QuartoVerde para trabalhar.

Contabilidade

Envie cada pagamento e extra para o seu software de contabilidade ou para a planilha do seu contador, com os totais já calculados.

Dashboards

Monte seus próprios relatórios de ocupação e receita no Looker Studio, Power BI ou Metabase, de uma ou várias propriedades.

Automações

Dispare fluxos no Zapier, Make ou n8n a cada reserva: avise a equipe de limpeza, adicione o hóspede à sua newsletter, publique no Slack.

Aplicativos próprios

Conecte fechaduras, apps para hóspedes ou seu próprio site aos dados de reservas em tempo real, desenvolvidos pela sua equipe ou por uma agência.

Terminal
curl https://api.lodgehog.com/v1/reservations/ -G \
  -d modified_since=2026-10-01T00:00:00Z \
  -H "Authorization: Bearer lh_live_…"

{
  "next": "https://api.lodgehog.com/v1/reservations/?cursor=…",
  "results": [
    {
      "booking_code": "845D400246",
      "status": "checked_in",
      "rooms": [ { "room": { "name": "302" }, "price": "170.00" } ],
      "charges": [ { "name": "Minibar", "total": "50.00" } ],
      "payments": [ { "method": "credit_card", "value": "340.00" } ],
      "totals": { "total_due": "50.00", "payment_status": "partial" }
    }
  ]
}

Uma API REST que entrega a estadia completa

Cada reserva vem completa, com quartos, hóspedes, extras, pagamentos e totais, então uma única requisição traz tudo sobre a estadia.

Reservas, hóspedes, quartos e categorias de quarto.
Filtre por status, datas de check-in ou check-out, hóspede ou quarto.
Busque apenas o que mudou desde a última sincronização, incluindo pagamentos e extras.
Schema OpenAPI, para que desenvolvedores gerem um cliente em qualquer linguagem.
Eventos de webhook
reservation.created
Uma nova reserva, vinda do sistema, do seu motor de reservas, do chatbot ou de qualquer OTA.
reservation.updated
Datas, quartos, hóspedes, extras ou pagamentos foram alterados.
reservation.deleted
A reserva foi cancelada.

Webhooks assim que algo muda

Sem precisar consultar a API o tempo todo. Cadastre uma URL e o QuartoVerde envia a reserva completa e atualizada sempre que uma for criada, alterada ou cancelada.

Um webhook por edição, e não um para cada campo alterado.
Assinados com HMAC-SHA256, para você ter certeza de que vieram de nós.
Entregas que falham são reenviadas automaticamente por cerca de uma hora.
Envie um evento de teste e acompanhe cada entrega nas configurações.
Leia https://api.lodgehog.com/llms.txt e escreva um script que exporte as reservas e os pagamentos do mês passado para uma planilha.
Lendo a referência da API…

Documentação que o seu assistente de IA entende

Além da documentação para pessoas, a API publica o llms.txt: uma referência escrita para modelos de IA. Cole um link no ChatGPT, Claude ou Cursor e ele passa a conhecer cada endpoint, campo e webhook.

Deixe um assistente de IA escrever sua integração, mesmo que você não programe.
Dê a agentes de IA acesso seguro e somente leitura às suas reservas.
Só leitura

Nada pode ser alterado pela API

1:1

Cada chave acessa uma única propriedade

120/min

Requisições por chave, por padrão

HMAC

Webhooks assinados

Documentação

Tudo é público: leia a documentação antes de se cadastrar.

Coloque os dados do seu hotel para trabalhar.

Cadastre-se, crie uma chave de API e faça sua primeira requisição em minutos.

Perguntas Frequentes

A API permite que outros sistemas leiam seus dados do QuartoVerde: enviar reservas e pagamentos para a contabilidade, montar dashboards em ferramentas como Looker Studio ou Power BI, sincronizar hóspedes com seu e-mail marketing ou disparar automações no Zapier, Make ou n8n sempre que entrar uma reserva.

Reservas, hóspedes, quartos e categorias de quarto. Cada reserva vem completa, com quartos, hóspedes, extras, pagamentos e totais calculados, então uma única requisição traz tudo sobre a estadia.

Não. A API é somente leitura: ela lê seus dados, mas nunca os altera. Por isso é seguro entregar uma chave a um contador, a uma agência ou a uma ferramenta de IA.

Você cadastra uma URL no QuartoVerde e nós enviamos a reserva completa sempre que uma for criada, alterada ou cancelada. Um novo pagamento ou extra conta como alteração. Várias edições feitas juntas chegam como um único webhook, e entregas que falham são reenviadas por cerca de uma hora.

Um administrador da propriedade cria as chaves em Sua propriedade > API e Webhooks. A chave é exibida uma única vez, apenas um hash dela é armazenado, e você pode revogá-la a qualquer momento, com efeito imediato.

Sim. Além da referência interativa, a API publica o llms.txt e uma referência completa escrita para modelos de IA. Passe esse link para o ChatGPT, Claude ou Cursor e eles podem escrever uma integração para você ou se conectar diretamente aos seus dados.

Cada chave pertence a uma única propriedade e só lê os dados dessa propriedade. As chaves podem ser revogadas na hora, as requisições têm limite de taxa e todo webhook é assinado com HMAC-SHA256, para que seu servidor confirme que ele veio mesmo de nós.

Nem sempre. Ferramentas de automação como Zapier, Make e n8n recebem webhooks e chamam APIs REST sem código, e assistentes de IA conseguem escrever uma pequena integração a partir da nossa documentação. Para uma integração sob medida, qualquer desenvolvedor que conheça APIs REST vai se sentir em casa.

O acesso à API e os webhooks estão incluídos em todos os planos pagos do QuartoVerde. Você pode testá-los grátis por 14 dias, sem cartão de crédito.

Parte de uma plataforma completa para hotelaria

Toda reserva de todos os canais chega ao QuartoVerde e, de lá, à sua API.

Nossos planos

Básico, sem custo
Gestão de Propriedade

Software gratuito com todas as funcionalidades essenciais:

  • Calendário de reservas
  • Reservas e hóspedes ilimitados
  • Planos de tarifas: automatize os preços dos quartos
R$0/mês para sempre
Cadastre-se sem custo
MELHOR OFERTA
Alcance Total
+ Gestor de Canais & Motor de Reservas

Venda em todos os canais e no seu próprio site

  • Venda no Booking.com, Airbnb e mais de 50 sites
  • Nunca mais tenha overbooking
  • Reservas sem comissão pelo site
A partir de R$174,90 /mês
Teste sem custo por 14 dias

Acreditamos na transparência de preços. Use nossa calculadora de preços para estimar o custo da sua assinatura.