Guia Técnica : Integração do Minut com Avantio

Neste ecossistema competitivo de aluguel de temporada, a eficiência operacional e a proteção de ativos são primordiais. A integração entre o sistema de gestão de imóveis (PMS) Avantio e a solução de monitoramento inteligente Minut representa um avanço estratégico para os gestores imobiliários modernos. Ela transforma processos reativos em um sistema de gestão de riscos proativo e automatizado.

1. Antes de começar: Requisitos para uma integração Minut/Avantio bem-sucedida

Uma preparação minuciosa é a chave de uma integração fluida e bem-sucedida. Antes de iniciar o processo de conexão, é imperativo assegurar que as condições seguintes estejam preenchidas. O não cumprimento desses pré-requisitos é a causa mais frequente de falhas na configuração.

• Contas Ativas: Assinaturas ativas dos serviços Minut e Avantio são necessárias para prosseguir com a integração.
• Instalação Física dos Sensores: Os sensores Minut devem ser fisicamente instalados, carregados e conectados à rede Wi-Fi local em cada propriedade a ser monitorada. É essencial verificar que cada sensor apareça com o status 'Em linha' no painel de controle do aplicativo Minut.   
• Etapa Crítica - Ativação Lado Avantio: Trata-se do requisito mais importante e não negociável. O usuário deve obrigatoriamente entrar em contato com a equipe de suporte da Avantio para solicitar a ativação da integração Minut para sua conta. A opção de integração não aparecerá ou não funcionará na interface Minut até que a Avantio tenha autorizado no servidor. Esse processo indica que a integração é baseada em uma API "permitida" ou "fechada", diferente de muitas integrações SaaS em livre-access. Essa abordagem, embora potencialmente mais estável, introduz uma dependência crucial do suporte da Avantio e pode levar a um atraso antes de começar a configuração.   
• Configuração das Propriedades no Avantio: Todas as propriedades destinadas a serem integradas devem estar totalmente configuradas no VRMS (Vacation Rental Management Software) da Avantio. Com base nos requisitos de integrações semelhantes com a Avantio, recomenda-se assegurar que cada anúncio de propriedade possua pelo menos uma foto e temporadas tarifárias atribuídas, pois esses elementos podem ser condições necessárias para que a API reconheça e sincronize corretamente o anúncio.   

2. Guia de integração passo a passo: Conectar Minut ao seu PMS Avantio

Uma vez que todos os pré-requisitos tenham sido validados, o processo técnico de conexão pode ser iniciado a partir da plataforma Minut. O procedimento foi projetado para ser simples, mas requer autorização na plataforma Avantio para finalizar a conexão segura de dados.

1. Acesse o Menu de Integrações Minut: Faça login no aplicativo web Minut. No menu de navegação principal, localize e clique na seção Integrações.   
2. Selecione a Integração Avantio: Percorra a lista de integrações de PMS disponíveis até encontrar o logo Avantio. Clique nele para acessar a página de configuração da integração.   
3. Inicie a Conexão: Na página da integração Avantio, clique no botão "Conectar" (ou "Relacione"). Esta ação iniciará o processo de autorização e redirecionará automaticamente da plataforma Minut para uma página de login da Avantio.   
4. Autorização na Plataforma Avantio: Você será convidado a fazer login na sua conta Avantio usando seus dados de administrador. Após o login, a Avantio pedirá que você conceda ao Minut a autorização para acessar seus dados de propriedades e reservas. Trata-se de um protocolo de segurança padrão (OAuth) que garante que o compartilhamento de dados seja explícito e seguro. Revise as permissões solicitadas e clique em "Autorizar" ou um botão equivalente.
5. Redirecionamento e Confirmação: Assim que a autorização for concedida com sucesso, seu navegador será redirecionado automaticamente para o aplicativo web do Minut. Uma mensagem de confirmação deve aparecer, indicando que a conexão entre Minut e Avantio foi estabelecida com sucesso.   

Este fluxo técnico, em que a solicitação é iniciada por uma aplicação de terceiros (Minut) mas cuja autorização crítica é concedida na plataforma do proprietário dos dados (Avantio), é uma prática de segurança padrão. Portanto, é crucial ter à mão as credenciais de uma conta administrativa da Avantio. Além disso, é aconselhável desativar temporariamente bloqueadores de pop-ups ou de scripts no navegador, pois eles podem interferir com o processo de redirecionamento e fazer com que a conexão falhe.

3. Configuração essencial pós-integração

O estabelecimento da conexão é apenas o primeiro passo. Para que a integração seja funcional e proporcione valor, é necessária uma configuração pós-conexão. Esta fase consiste em vincular as propriedades e configurar as automações de comunicação.

3.1. Sincronização das propriedades: Vincular seus imóveis Minut e Avantio

Uma vez estabelecida a conexão técnica, o Minut irá convidá-lo a "mapear" ou "vincular" suas propriedades. Esta etapa é fundamental para o funcionamento adequado da automação.   

A interface do Minut exibirá uma lista de seus imóveis onde sensores estão instalados. Ao lado de cada imóvel Minut, um menu suspenso conterá a lista de suas propriedades extraídas da sua conta Avantio via API. O processo consiste em selecionar manualmente a propriedade Avantio correspondente para cada imóvel Minut.

Essa correspondência manual é crucial. Ela indica ao sistema Minut qual conjunto de dados de reserva da Avantio se aplica a qual sensor físico. Um erro de mapeamento teria consequências graves, como o envio de um alerta de ruído ao viajante errado, o que prejudicaria gravemente a experiência do cliente. Esta etapa não é apenas uma tarefa de configuração, mas um ato que garante a integridade de todo o sistema de comunicação automatizado. Também é importante notar que esse processo deve ser repetido sempre que uma nova propriedade seja adicionada ao seu portfólio e equipada com um sensor Minut.

3.2. Implementação de alertas automatizados: Comunicar efetivamente com os viajantes

A principal funcionalidade desbloqueada por essa integração é a comunicação automatizada com os viajantes em caso de detecção de ruído excessivo. Para configurá-la, acesse as configurações de Mensagens ou Guest Connect na sua conta Minut.   

A configuração do fluxo de comunicação automatizado inclui várias etapas-chave:

• Definir os Limites de Ruído: Configure o nível de decibéis e a duração que irão acionar um alerta. Esses parâmetros podem ser ajustados para corresponder às regras da propriedade e aos horários de silêncio.
• Personalizar a Mensagem: Redija a mensagem SMS que será enviada automaticamente ao viajante. Recomenda-se adotar um tom amigável e informativo para evitar confrontos. Por exemplo: "Olá [Nome do Viajante], este é um lembrete amigável do seu anfitrião sobre as horas de silêncio. O sensor de ruído detectou níveis sonoros elevados. Poderia, por favor, baixar o volume? Agradecemos por nos ajudar a ser bons vizinhos."
• Ativar a Automação: Uma vez definidos, ative a funcionalidade. A partir de agora, quando um evento de ruído for detectado em uma propriedade vinculada, o sistema Minut consultará a Avantio para a reserva em curso, recuperará os dados de contato do viajante e enviará a mensagem personalizada sem qualquer intervenção manual.   

4. Solução de Problemas e Perguntas Frequentes (FAQ)

Mesmo com uma configuração cuidadosa, podem ocorrer problemas. Esta seção fornece soluções para os problemas mais comuns, permitindo que os usuários resolvam os incidentes de forma autônoma antes de entrar em contato com o suporte técnico.

4.1. Problemas de conectividade do sensor Minut

• Sintoma: Um sensor aparece como "Desconectado" ou "Offline" no painel Minut.
• Solução: Siga o procedimento de solução de problemas detalhado fornecido pelo centro de ajuda do Minut.
  1. Verificações Iniciais : Certifique-se de que o sensor está ligado (via o interruptor para o modelo M3 ou ao pressionar a lente para o M2), que está suficientemente carregado e que está ao alcance de uma rede Wi-Fi funcional.
  2. Dépannage Wi-Fi (Etape 1) : Reinicie o roteador Wi-Fi desconectando-o por 20 segundos. Desligue o sensor Minut e deixe-o desligado por 10 minutos. Ligue-o novamente, aguarde 10 segundos e pressione o botão principal para observar se o indicador acende em branco e depois em verde, indicando uma conexão bem-sucedida.
  3. Dépannage Wi-Fi (Étape 2) : Se a primeira etapa falhar, use o aplicativo móvel Minut para atualizar as configurações de Wi‑Fi. Vá em Dispositivo → Configurações → Avançado → Atualizar Configurações de Wi‑Fi e siga as instruções na tela.
  4. Contatar o Suporte Minut : Se o sensor permanecer desconectado após seguir todas essas etapas, entre em contato com o suporte Minut no endereço bonjour@minut.com. Forneça uma breve descrição do problema, o número de série ou o endereço MAC do sensor, bem como a marca e o modelo do seu roteador.   

4.2. Problemas de sincronização com Avantio

• Causa e Solução :
  1. Prazo de Sincronização da API : A API da Avantio pode não se atualizar instantaneamente. Recomenda-se aguardar até 24 horas para que a nova propriedade seja sincronizada.   
  2. Anúncio Incompleto : Verifique se o anúncio da propriedade está totalmente configurado na Avantio, com pelo menos uma foto e temporadas tarifárias atribuídas, pois esses elementos podem ser exigidos pela API.   
  3. Se o problema persistir além de 24 horas, entre em contato com o suporte da Avantio, pois eles controlam o fluxo de dados da API.

4.3. Guia de Contato do Suporte Técnico

Para uma resolução eficaz, é crucial contatar a equipe de suporte correta.

• Contate o Suporte Minut (bonjour@minut.com) para :
  • Todo problema de hardware com um sensor (carga, alimentação).
  • Um sensor que permanece "Offline" após ter seguido o procedimento de solução de problemas.
  • Dúvidas sobre as funcionalidades do aplicativo Minut (web ou móvel), como a configuração de alertas.   
• Contate o Suporte Avantio (contact@avantio.com) para :
  • A solicitação de ativação inicial da integração Minut.
  • As propriedades, reservas ou dados dos viajantes que não se sincronizam corretamente com Minut.
  • Erros que ocorram durante a etapa de autorização na plataforma Avantio.
  • Qualquer questionamento relacionado aos dados provenientes do seu PMS.   

Table 1: Guia de Solução Rápida da Integração Minut-Avantio

A integração do Minut com o Avantio é muito mais do que uma simples conexão técnica; representa um passo decisivo para uma gestão imobiliária mais inteligente, mais segura e mais escalável. Seguindo este guia, os gestores podem implementar um sistema robusto que protege seus ativos enquanto melhora a experiência de seus clientes.

• Sintoma 1 : A opção de integração Avantio está ausente, cinza ou inacessível no menu de integrações do Minut.
• Causa : A API não foi ativada pela Avantio para a sua conta.
• Solução : Este é o problema de início mais comum. Entre em contato com o suporte da Avantio (contact@avantio.com) e peça que eles confirmem que a integração Minut foi realmente ativada do lado deles.   
• Sintoma 2 : Uma nova propriedade adicionada na Avantio não aparece na lista suspensa para a vinculação no Minut.
• Causa e Solução :
  1. Prazo de Sincronização da API : A API da Avantio pode não se atualizar instantaneamente. Recomenda-se aguardar até 24 horas para que a nova propriedade seja sincronizada.   
  2. Anúncio Incompleto : Verifique se o anúncio da propriedade está totalmente configurado na Avantio, com pelo menos uma foto e temporadas tarifárias atribuídas, pois esses elementos podem ser exigidos pela API.   
  3. Se o problema persistir além de 24 horas, entre em contato com o suporte da Avantio, pois eles controlam o fluxo de dados da API.

4.3. Guia de Contato do Suporte Técnico

Para uma resolução eficaz, é crucial contatar a equipe de suporte correta.

• Contate o Suporte Minut (bonjour@minut.com) para :
  • Todo problema de hardware com um sensor (carga, alimentação).
  • Um sensor que permanece "Offline" após ter seguido o procedimento de solução de problemas.
  • Dúvidas sobre as funcionalidades do aplicativo Minut (web ou móvel), como a configuração de alertas.   
• Contate o Suporte Avantio (contact@avantio.com) para :
  • A solicitação de ativação inicial da integração Minut.
  • As propriedades, reservas ou dados dos viajantes que não se sincronizam corretamente com Minut.
  • Erros que ocorram durante a etapa de autorização na plataforma Avantio.
  • Qualquer questionamento relacionado aos dados provenientes do seu PMS.   

Table 1: Guia de Solução Rápida da Integração Minut-Avantio

Problema Comum	Causa Possível	Solução Recomendada / Pessoa a Contatar
A opção de integração Avantio está ausente da minha conta Minut.	A API de integração não foi ativada pela Avantio para a sua conta.	Contate o suporte da Avantio (contact@avantio.com) e peça a ativação da integração Minut.
Um sensor Minut aparece como "Desconectado".	Problema de Wi-Fi, de bateria, ou o sensor está desligado.	Seguir as etapas de solução de problemas do sensor: reiniciar o roteador e o sensor, verificar a carga, atualizar as configurações de Wi-Fi via app Minut. Se o problema persistir, contatar o suporte Minut (bonjour@minut.com).
Os alertas de ruído não são enviados aos viajantes.	1. As propriedades não estão corretamente vinculadas entre Minut e Avantio. 2. A mensageria automatizada não está configurada ou ativada no Minut. 3. O número de telefone do viajante está ausente na reserva Avantio.	1. Verificar a seção de ligação das propriedades nas configurações de integração Minut. 2. Configurar e ativar a mensageria nas configurações do Minut. 3. Verificar a reserva na Avantio.
Uma nova propriedade adicionada na Avantio não aparece para a vinculação no Minut.	1. Prazo de sincronização da API (até 24h). 2. Configuração da propriedade incompleta na Avantio (ex.: foto ou temporada tarifária ausentes).	1. Aguardar 24 horas. 2. Certificar-se de que a propriedade está totalmente configurada na Avantio. Se o problema persistir, contate o suporte da Avantio.
A conexão falha na etapa de autorização no site da Avantio.	1. Credenciais Avantio incorretas. 2. Sua conta de usuário Avantio não possui permissões de administrador para autorizar as APIs. 3. Bloqueadores de pop-ups ou scripts interferindo com a redirecionação.	1. Verificar as credenciais. 2. Tentar com uma conta administrativa Avantio. 3. Desativar temporariamente os bloqueadores para o processo de conexão.

A integração do Minut com o Avantio é muito mais do que uma simples conexão técnica; representa um passo decisivo para uma gestão imobiliária mais inteligente, mais segura e mais escalável. Seguindo este guia, os gestores podem implementar um sistema robusto que protege seus ativos enquanto melhora a experiência de seus clientes.