Documentação

1

Criar uma conta

Vá à página de registo, introduza o nome do alojamento, email e palavra-passe. A sua avaliação grátis de 60 dias começa já.

Registe-se agora

2

Criar o seu bot do Telegram

Abra o Telegram, procure o utilizador @BotFather (ferramenta oficial do Telegram para criar bots) e inicie uma conversa.

Envie o comando /newbot
Escolha um nome visível (ex. "Villa Bellavista Concierge")
Escolha um username que termine em "bot" (ex. villabellavistabot)
O BotFather responde com um token. Mantenha-o secreto.

123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3

Ligar o bot ao StayHelp

No painel, vá a Setup e cole o token do BotFather. Verificamos e registamos o webhook automaticamente. A partir daí, todas as mensagens ao seu bot chegam ao StayHelp.

4

Treinar o bot por chat

Abra uma conversa com o seu próprio bot no Telegram. Envie uma mensagem apresentando-se como proprietário e descreva o alojamento.

/train

Depois envie mensagens como:

"Check-in das 14:00 às 22:00. Avise-me por WhatsApp à chegada."
"Pequeno-almoço na cozinha das 8:00 às 10:30."
"WiFi: rede VILLA_GUEST, palavra-passe welcome2025."
"Estacionamento gratuito, use os lugares marcados com B."

O bot classifica cada mensagem automaticamente (check-in, wifi, pequeno-almoço, regras...) e normaliza. Pode rever e editar no painel.

5

Adicionar quartos e imprimir QR

Para cada quarto adicionado, o StayHelp gera um QR único pronto a imprimir.

Vá a Painel -> Quartos
Clique em "Adicionar quarto" e introduza código (ex. 101) e nome
Clique em "Transferir QR" para obter o PNG, imprima e coloque no quarto

6

Gerir escalações

Quando o bot não pode responder com confiança, encaminha a pergunta para si no Telegram (com um ID de 8 caracteres). Responde uma vez e o StayHelp traduz de volta para o idioma do hóspede.

/reply a1b2c3d4 O suplemento para check-in tardio é 20 euros.

7

Referência de comandos do bot

Todos os comandos do anfitrião correm na conversa do Telegram com o bot. O hóspede nunca os vê.

Comando	Descrição
/train	Entrar no modo treino
/stop	Sair do modo treino
/list	Mostrar entradas da knowledge base
/delete [id]	Eliminar uma entrada
/rooms	Listar quartos
/addroom [code] [name]	Adicionar um quarto
/qr [code]	Receber o QR de um quarto
/stats	Estatísticas de uso
/escalations	Listar escalações pendentes
/reply [id] [text]	Responder a uma escalação
/translation on\|off	Ativar/desativar tradução automática
/welcome [text]	Definir mensagem de boas-vindas
/addadmin [id]	Adicionar um colaborador (por Telegram ID)
/help	Mostrar todos os comandos

8

Upgrade e facturação

Tem 60 dias grátis, sem cartão. Depois escolha o plano adequado ao número de quartos. Mudança de plano, atualização de cartão e descarga de faturas feitas no portal de clientes Stripe, na página de Facturação.

Ver planos