InnSync + Hospedin: como funciona a integração

Por que Hospedin?

Quando começamos a desenhar a InnSync, a primeira integração foi com o Stays.net — o PMS mais usado no mercado brasileiro de aluguel de temporada. Stays é maduro, tem webhooks, e foi o caminho natural para validar a tese da Carmen com nosso primeiro design partner (Azzure Homes, em João Pessoa).

O Hospedin é o segundo PMS que suportamos nativamente. Entrou na roadmap quando aceitamos a Rancho Nature como design partner — uma operação diferente da Azzure (foco em pousada de natureza, ticket maior, perfil de hóspede internacional) e que não usa Stays.

A decisão de suportar dois PMS em paralelo (em vez de "esperar todo mundo migrar pro Stays") veio de uma observação simples: o PMS é a infraestrutura mais difícil de trocar de toda a operação. Faz sentido a InnSync se adaptar ao PMS que o gestor já confia, não o contrário.

O que sincroniza

Phase 1 da integração é read-only — o InnSync lê do Hospedin, não escreve. Os recursos cobertos:

O que não vem do Hospedin (e por que não importa):

• Threads de mensagens — o Hospedin não expõe pela API. O InnSync conecta direto com Booking, Airbnb e WhatsApp Business; mensagens dessas plataformas fluem por ali.
• Avaliações — também não expostas pela API. A coleta de avaliações via OTA segue por outro caminho.

Como autentica

O Hospedin usa autenticação por JWT com lifetime de 5 dias. No fluxo do InnSync:

1. No wizard de onboarding, o gestor entra com e-mail e senha da conta Hospedin (não OAuth, não API key — a API do Hospedin não oferece esses formatos hoje).
2. O InnSync valida o login na hora chamando o endpoint de auth, e armazena o JWT criptografado.
3. Quando o token está perto de expirar (4 dias e meio), o cliente faz refresh automático antes da próxima requisição.
4. Se uma chamada retorna 401, o cliente tenta refresh uma vez e repete a requisição. Se falhar de novo, alerta o gestor para reconectar.

Esse fluxo é invisível para o gestor — só pede senha de novo se a conta Hospedin teve alteração de credenciais.

Cadência por entidade

Como o Hospedin não oferece webhooks, o InnSync usa polling com cadência calibrada por entidade:

reservas      ▸ a cada 15 minutos    (mais sensível ao tempo)
hóspedes      ▸ a cada 30 minutos    (mudam com a reserva)
listings      ▸ a cada 6 horas       (raramente mudam)
propriedades  ▸ a cada 6 horas       (idem)

A lógica de fundo: uma nova reserva chegou agora? A Carmen pode esperar 15 minutos para ver isso? Para a maioria das interações com hóspedes (mensagens de boas-vindas, instruções de check-in que rodam horas antes da chegada), 15 minutos é folga. Para casos extremos — gestor que precisa que a Carmen responda imediatamente sobre uma reserva que ainda nem chegou no sync — existe um botão de "sincronizar agora" no painel.

A cadência também respeita o rate limit interno que mantemos (60 requisições por minuto por tenant) para não sobrecarregar a API do Hospedin.

Identidade do hóspede: o problema do telefone

Aqui tem uma quirk importante. A API do Hospedin não retorna o telefone do hóspede em campo separado. Em uma operação que vive de WhatsApp, isso seria um buraco.

Mas observamos um padrão consistente em hóspedes vindos do Hospedin: muitos gestores brasileiros, ao longo dos anos, criaram o hábito de colar o número de WhatsApp dentro do campo nome quando cadastravam o hóspede:

"João Silva (83) 99999-1234"
"Maria — 11 98888-5678"
"Pedro / 21 99777-2345"

O InnSync detecta esse padrão automaticamente. Quando o telefone está em formato brasileiro válido dentro do nome ((DD) XXXXX-XXXX, DD XXXXX XXXX, XX XXXXXXXX etc.), o sistema:

1. Extrai o número.
2. Limpa o nome (remove o telefone do campo name).
3. Cria a entrada de WhatsApp do hóspede automaticamente.

Para os casos onde o telefone simplesmente não está disponível (nem no nome, nem em nenhum outro lugar), o gestor pode adicionar manualmente via GuestContactOverride no portal — uma tabela própria do InnSync que sobrescreve dados ausentes do PMS sem alterar o sistema de origem.

Carmen + Hospedin: cotação ao vivo (beta)

Aqui acontece a maior parte do diferencial. Para tenants Hospedin no programa de soft-launch, a Carmen tem acesso à API rates_and_availabilities — endpoint que retorna disponibilidade e tarifa de uma listing para qualquer faixa de datas, ao vivo.

Na prática: hóspede pergunta no WhatsApp "vocês têm disponibilidade do dia 15 ao 18 de junho para 4 pessoas?". A Carmen:

1. Identifica a intenção (consulta de disponibilidade + faixa de datas + número de hóspedes).
2. Encontra a listing certa via nome ou contexto da conversa (ferramenta FindListingTool).
3. Consulta o Hospedin ao vivo via AvailabilityQuoteTool — não usa cache, não inventa preço.
4. Devolve a resposta com a tarifa real do PMS, no tom de voz da operação.

A regra fundamental: a Carmen pode inventar afetividade, não pode inventar fatos. Tarifa, disponibilidade, regras da casa — tudo vem de fonte verificável. Quando o dado não está disponível, a Carmen escala para o gestor humano em vez de improvisar.

O que está em desenvolvimento

A integração com Hospedin é viva — algumas peças entram em produção em rolling com o time de design partners. Em desenvolvimento agora:

• Pré-reserva (hold) — Carmen criar uma reserva em status pre_reservation para segurar datas enquanto o hóspede confirma. Depende de validação operacional com a Rancho Nature.
• Link de pagamento — geração e envio de link Asaas/Pix dentro da conversa.
• Regras de negócio — Carmen consultar política de cancelamento, regras de mínimo de noites, política de pets, política de crianças, antes de cotar.

Esses recursos saem em fases conforme a operação dos design partners valida cada peça.

Como ativar

Se você já tem conta Hospedin e quer subir o InnSync em cima:

1. Wizard de onboarding — o admin do InnSync cria a conta da sua operação e te envia um convite.
2. Setup do Hospedin — você entra com e-mail e senha da sua conta Hospedin no wizard. O InnSync valida o login e dispara a primeira sincronização.
3. 24h de soak — a Carmen fica em modo observação enquanto a base de conhecimento por imóvel é populada e o histórico de reservas entra.
4. Ativação gradual — o gestor decide quando ligar a Carmen para responder no piloto automático, ou se prefere o modo revisão (aprovar cada mensagem antes de enviar).

Se você usa Hospedin e tem interesse em ser um próximo design partner, fale com a gente no WhatsApp — a gente conversa sem compromisso.