Tradução do manual da casa e respostas a hóspedes do Airbnb com Claude Code

Onze da noite, o celular acendeu. Era um hóspede que tinha chegado de Taiwan: “The lock box code doesn’t work”. A fechadura não abria.

Naquele dia eu estava enterrado na limpeza de outra reserva e não tinha cabeça para abrir o manual em inglês. O manual em português existia. Mas a versão em inglês eu tinha jogado num tradutor automático seis meses antes e nunca mais mexi: o código da fechadura da entrada continuava o antigo, esquecido lá. No fim, fui digitando o inglês frase por frase no celular e deixei o hóspede esperando trinta minutos. Na avaliação veio uma estrela a menos e o comentário “response was a bit slow”. Uma estrela perdida vira reserva perdida na próxima.

Quem toca aluguel por temporada ou Airbnb sabe que essa hora chega: a barreira do idioma e a barreira do tempo batendo na porta ao mesmo tempo. Hoje vou contar como cortar essas duas com Claude Code e IA, de um jeito pequeno. Não é mágica. É papo de ferramenta sem graça que funciona de verdade.

Pontos principais

Traduzir o manual da casa não é “traduzir”: é manter um único dado-fonte e mandar para cada idioma automaticamente. Assim não quebra.
Para responder hóspedes, modele as perguntas frequentes, deixe a IA escrever o rascunho e reserve o envio final para a decisão humana.
Código da fechadura, endereço, contatos e dados pessoais: transforme em marcador antes de mandar para a IA, separando do texto.
Sistematizar tradução e rascunho de resposta economiza de 3 a 5 horas por mês por imóvel, e o primeiro retorno cai de 30 para 5 minutos.
No fim, fica a linha clara entre “o que a IA faz” e “o que a pessoa decide sempre”.

Para quem é este artigo, e o fluxo de hoje

Este artigo pensa no anfitrião que toca de 1 a 10 quartos sozinho ou com poucas mãos. Tem quem viva disso e quem faça nas horas vagas do trabalho principal. O que todos têm em comum: limpeza, reservas e atendimento nas costas de pouca gente, e ninguém é nativo em inglês ou em mandarim.

Seu atendimento hoje não funciona mais ou menos assim?

Chega uma mensagem em inglês ou chinês na caixa do Airbnb ou Booking.com.
Você lê por cima, cola no app de tradução para pegar o sentido.
Pensa a resposta em português e joga de novo no tradutor para o idioma do hóspede.
Com aquele medo de a tradução estar estranha, manda assim mesmo na fé.
Mesmo sendo um assunto que já está no manual da casa, você digita tudo do zero de novo.

O problema desse ciclo é responder à mão, toda vez, a mesma pergunta (horário de check-in, separação do lixo, caminho da estação mais perto). Está no manual, mas como o idioma é outro, é como se não existisse. É aqui que a IA entra.

Os retrabalhos e dores mais comuns

Vou listar os retrabalhos que eu mesmo pisei na operação do dia a dia.

Troquei o código da fechadura e só a versão em inglês ficou velha. Conserto só o manual em português e esqueço de atualizar as outras línguas. Essa foi a maior causa de problema com fechadura.
O tom da tradução varia de imóvel para imóvel. Um imóvel sai formal, outro sai seco. Quando você tem vários, a unidade some.
Respondo a mesma pergunta por inteiro toda vez. “Que dia é o lixo?” me faz digitar três linhas sempre. Cinco mensagens por dia já viram vinte minutos.
Acidente de tradução automática. “Por favor, dobre o futon” virou algo como “Please fold the futon mattress and throw it away” e o hóspede ficou confuso. História verídica, e nada engraçada.

A raiz da dor é traduzir na hora, toda vez. Como o texto-fonte não está organizado num só lugar, nem a atualização nem a qualidade se estabilizam.

O que a IA faz, e o que a pessoa decide sempre

Vou traçar a linha antes de tudo. Se isso fica vago, a IA, na boa intenção, reescreve o endereço sozinha ou promete um desconto que você não deu.

Etapa	Pode deixar com a IA	A pessoa decide sempre
Tradução do manual	Rascunho para cada idioma, padronizar o tom	Código da fechadura, endereço, contato de emergência corretos
Resposta ao hóspede	Rascunho das perguntas padrão	Botão enviar, promessa de preço, prorrogação, reembolso
Ajuste de tom	Padronizar a cortesia, corrigir erros de digitação	Conferência final das regras da casa de cada imóvel
Organizar o FAQ	Classificar perguntas, apontar lacunas	Texto sobre lei, bombeiros e regras de vizinhança

O princípio é simples: decisões que tocam em “dinheiro”, “chave” e “lei” ficam com a pessoa até o fim. O resto (deixar o texto bonito, somar idiomas, escrever rascunho) pode ir para a IA sem medo.

Caso 1: gerar o manual em vários idiomas a partir de um único dado-fonte

Esse é o que mais rende. Vire a cabeça: em vez de “traduzir o manual em português”, mantenha um dado-fonte dividido por itens e gere cada idioma a partir dele.

Primeiro, quebre o manual em itens: check-in, Wi-Fi, lixo, uso dos equipamentos, contato de emergência, procedimento de saída. Nessa granularidade, guarde o português como a única versão correta. Valores que mudam fácil ou que devem ficar em segredo, como código da fechadura e endereço, não escreva direto no texto: deixe um marcador como {{door_code}} no lugar.

Aí, peça ao Claude Code assim:

Você é o responsável por traduzir o manual da casa de um aluguel por temporada.
Traduza o manual em português abaixo para inglês, chinês tradicional e coreano.

Restrições:
- Os valores entre {{ }} não devem ser traduzidos; mantenha-os iguais.
- Mantenha o respeito ao hóspede, com frases curtas e claras.
- Padronize o tom de expressão em cada idioma.
- Evite jargão e "inglês inventado"; use palavras que o hóspede estrangeiro entenda de primeira.
- Nome próprio intraduzível: mantenha no idioma original e adicione uma breve explicação entre parênteses.

Saída: um título por idioma, com a ordem dos itens igual à do português original.

---
(cole aqui o manual em português dividido por itens)

Usar marcador tem duas razões. Uma: quando você muda o código da fechadura, conserta um ponto só do dado-fonte e isso reflete em todos os idiomas. Outra: separa a informação da chave tanto da entrada da IA quanto do resultado da tradução, o que é mais seguro contra vazamento.

A substituição em si dá para automatizar com este script curto. Funciona com Node.js.

import { readFile, writeFile } from "node:fs/promises";

// Segredos como chave e endereco ficam fora do codigo (variavel de ambiente ou outro arquivo)
const secrets = {
  door_code: process.env.DOOR_CODE || "0000",
  wifi_pass: process.env.WIFI_PASS || "changeme",
  emergency_tel: process.env.EMERGENCY_TEL || "000-0000-0000",
};

function fillPlaceholders(template, values) {
  return template.replace(/\{\{(\w+)\}\}/g, (whole, key) => {
    if (key in values) return values[key];
    throw new Error(`Marcador nao definido: ${key} (adicione em secrets)`);
  });
}

// Le o template traduzido (com marcadores) e escreve a versao final
const langs = ["en", "zh", "ko"];
for (const lang of langs) {
  const template = await readFile(`manual.${lang}.txt`, "utf8");
  const filled = fillPlaceholders(template, secrets);
  await writeFile(`out.manual.${lang}.txt`, filled, "utf8");
  console.log(`${lang}: pronto (${filled.length} caracteres)`);
}

O ponto desse script: se sobrar um marcador não definido, ele para com erro. A máquina evita o acidente de distribuir a versão em inglês com {{door_code}} esquecido sem preencher. Trocou o código? Atualize DOOR_CODE e rode uma vez. Todos os idiomas ficam atualizados ao mesmo tempo.

Caso 2: deixar a IA rascunhar as respostas padrão

Agora as respostas ao hóspede. As perguntas de quem vem de fora são, na verdade, 80% padrão: horário de check-in, como chegar da estação, Wi-Fi, dia do lixo, procedimento de check-out. Deixe a IA cobrir do “tipo de pergunta” até o “rascunho da resposta”.

O modelo de prompt para o rascunho é este:

Você é o assistente de respostas de um anfitrião de aluguel por temporada.
Para a mensagem do hóspede, escreva um rascunho de resposta curto e educado.

Regras:
- Responda no mesmo idioma do hóspede.
- Se houver resposta no manual da casa (abaixo), use só o conteúdo dele.
- O que não estiver no manual, ou envolver preço e prorrogação: marque como "precisa confirmar com o anfitrião" e não escreva no corpo.
- No fim da resposta, deixe espaço para assinatura e nome do imóvel, que eu adiciono.

Trecho do manual da casa:
(cole check-in, Wi-Fi, lixo, procedimento de saída etc.)

Mensagem do hóspede:
(cole aqui a mensagem recebida)

O importante é a restrição: “o que não está no manual e o que envolve dinheiro, não escreva no corpo; marque”. Assim você evita o acidente de a IA prometer sozinha “a prorrogação é gratuita”. Leia o rascunho, se estiver tudo certo envie. Só onde precisa de confirmação você complementa à mão. Esse pequeno passo derruba o primeiro retorno de 30 para 5 minutos.

Quer melhorar a precisão da modelagem? Tire da sua própria caixa de entrada o “top 10 de perguntas frequentes” e monte um FAQ. A própria criação do FAQ dá para apoiar na IA: basta pedir “vou colar o histórico de respostas; classifique as perguntas em 10 categorias e proponha a resposta padrão de cada uma”.

Caso 3: padronizar tom e atualidade entre os imóveis

Com vários imóveis, a qualidade dos manuais começa a variar. Então, de tempos em tempos, junte os manuais de todos e mande a IA revisar.

Peça como uma checklist:

Abaixo estão os manuais da casa de vários imóveis. Revise sob estes pontos:
1. Marcadores como código de fechadura e contato sobraram como {{ }} sem preencher?
2. O tom de cortesia está desalinhado entre os imóveis?
3. Falta algum item na separação do lixo ou no procedimento de saída?
4. Há "inglês inventado" ou expressão vaga que o hóspede estrangeiro entenderia errado?
Liste os pontos com problema por imóvel, item e motivo. Apenas proponha a correção; não reescreva por conta própria.

O truque é deixar explícito “não reescreva por conta própria”. A revisão vai só até a proposta; quem decide adotar é a pessoa. Assim some o acidente de “quando vi, o endereço tinha sido trocado pelo de outro imóvel”.

O que muda do antes para o depois

Vou colocar em números, por alto, a sensação no meu imóvel. É estimativa, varia com o imóvel e a ocupação.

Item	Antes	Depois
Atualizar manual multilíngue	À mão por idioma, meio dia	Conserta o dado-fonte e regera, 15 min
Primeiro retorno ao hóspede	30 min traduzindo	5 min: conferir rascunho e enviar
Refletir troca do código	Conserto à mão em todos os idiomas, com falhas	Um comando, zero falha
Horas de atendimento por mês	—	Meta de corte de 3 a 5 horas por imóvel

Em hora trabalhada, se sobram de 3 a 5 horas no mês, num único imóvel já voltam dezenas de reais do seu tempo. Com vários imóveis, o efeito multiplica direto. Do lado do custo: a IA sai por alguns reais ao mês, e montar o modelo no começo leva meio dia. Pela velocidade de pagar o investimento, sinto que é dos casos mais rápidos.

Para quem ainda está perdido em como começar o próprio Claude Code, vale ler antes o Guia de primeiros passos do Claude Code, que deixa os prompts daqui mais fáceis de rodar. Se você não tem intimidade com código mas quer avançar, Claude Code para quem não é engenheiro é uma boa porta de entrada.

Segurança e cuidado com dados pessoais

Aqui é justamente onde o aluguel por temporada exige atenção redobrada.

Não escreva código da fechadura nem informação de chave direto na entrada da IA. Transforme em marcador e injete o valor real pelo lado do script (variável de ambiente ou outro arquivo seu). O básico é não deixar a informação da chave no histórico de chat da IA.
Não cole sem cuidado nome, passaporte e número de reserva do hóspede. Ao colar o conteúdo, deixe só o assunto e remova o que identifica a pessoa.
O envio final da resposta quem aperta é a pessoa. Se você automatiza o envio do rascunho da IA, informação errada e promessa indevida saem direto.
Não fique jogando o manual inteiro em serviço de tradução gratuito. Mandar o texto completo, com endereço, para um serviço onde você não sabe o que fica guardado, é melhor evitar.

Temporada é negócio que envolve “endereço e chave reais”. Mantenha a conveniência digital e a segurança física em gestões separadas. Essa linha, não derrube. Para fazer a IA seguir regras pelo prompt à risca, vale o Boas práticas de CLAUDE.md. Para a operação no Brasil, dê uma olhada na Cartilha de aluguel por temporada do Ministério do Turismo como fonte primária das regras.

Perguntas frequentes

P. Qual a diferença para a tradução automática? R. Em vez de só trocar palavra, dá para condicionar “curto, sem mal-entendido, com tom padronizado” e organizar como texto de verdade. Além disso, o marcador separa a informação da chave, então o trabalho de atualizar e o risco de vazamento caem juntos.

P. Programar é obrigatório? R. Para só traduzir e rascunhar respostas, dá para tocar sem código, só colando o prompt. O script de injeção é um apoio “bom de ter” e roda no copia-e-cola. Adicione depois que sentir o resultado, está de bom tamanho.

P. Quantos idiomas dá para cobrir? R. Com o dado-fonte arrumado, inglês, chinês e coreano ficam em nível prático. Mas sempre confira a saída com seus próprios olhos, ou com um conhecido que saiba o idioma, antes de distribuir.

P. Posso deixar a resposta ao hóspede 100% automática? R. Melhor não. Preço, prorrogação, reembolso e atrito com vizinhança são área para a pessoa decidir. Rascunho com a IA, botão de enviar com a pessoa: essa divisão evita acidente.

P. Funciona com vários imóveis? R. Funciona. Guarde o dado-fonte separado por imóvel e faça a checagem cruzada com o prompt de revisão; assim você padroniza tom e atualidade. Para afinar a precisão dos prompts, veja também Engenharia de prompts avançada.

O próximo passo

Anfitrião que quer aprender e testar por conta própria: pegue o modelo nos materiais e PDFs e rode pequeno no seu único imóvel. Quer desenhar a melhoria de processo como time, com vários imóveis ou administração terceirizada? Então treinamento e consultoria encaixa melhor. Comece por um dos dois, conforme o seu estágio, e está ótimo. Para ganhar ritmo no dia a dia, as dicas de produtividade também ajudam.

O que aconteceu quando testei de verdade

Depois daquele “problema de fechadura às onze da noite” do começo, montei esse sistema no meu próprio imóvel. Confirmei três coisas.

A primeira: se o método de marcador realmente reduz acidente. Troquei o código da fechadura e rodei o script uma vez; as três versões (inglês, chinês e coreano) ficaram atualizadas ao mesmo tempo. O “só a versão em inglês está velha” da época do conserto à mão deixou de acontecer fisicamente. Foi o que mais rendeu.

A segunda: a precisão do rascunho de resposta. Mandei a IA rascunhar 20 mensagens antigas e comparei com o que eu mesmo tinha escrito à mão. Das perguntas padrão, 17 saíram com qualidade para enviar quase sem retoque. As outras 3 envolviam preço ou prorrogação e, como previsto, vinham com a marca “confirmar com o anfitrião”: funcionou exatamente na premissa de que a pessoa escreve.

A terceira: o tempo. O atendimento na véspera do check-in encolheu de uns 30 para uns 5 minutos em média. Quando a avaliação que tinha sido 4 estrelas voltou a 5 com um hóspede elogiando a rapidez da resposta, confesso que fiquei feliz.

Não é automação espetacular. As decisões de chave e dinheiro continuam na minha mão; só a tradução e o rascunho vão para a máquina. Essa pequena linha é o que, na operação de aluguel por temporada, faz diferença. É o que eu sinto hoje.