Ativação de Armários Inteligentes via API Seventh (Parceiros Homologados)

Objetivo

Este artigo apresenta o passo a passo para ativação de armários inteligentes já homologados que utilizam a API padrão da Seventh, permitindo o envio de notificações de entrega e retirada no aplicativo.

Introdução

Quando o parceiro de armários inteligentes já possui integração homologada com a Seventh, não é necessário realizar um novo processo de homologação.

Nesses casos, a ativação consiste na configuração do condomínio e na vinculação do parceiro ao ambiente específico, permitindo que as notificações sejam enviadas corretamente aos moradores.

Contexto de uso

Este fluxo se aplica aos armários inteligentes que utilizam a API padrão da Seventh, como:

• MeuLocker

• IBox

• ViaLocker

• Azanonatec

Nesses cenários, o parceiro já está apto tecnicamente a se comunicar com a Seventh, sendo necessário apenas realizar a ativação para cada condomínio.

Pré-requisitos

Antes de iniciar a ativação, é necessário garantir que:

• O condomínio possui contrato ativo com o parceiro de armários inteligentes

• O parceiro está homologado com a Seventh

• O condomínio está cadastrado na plataforma Seventh

Etapas para ativação

1. Contratação do parceiro (Armário Inteligente) 

O admistrador do condomínio deve contratar a empresa de armários inteligentes desejada.

2. Solicitação de integração ao parceiro

Após a contratação, o cliente deve entrar em contato com a empresa do armário e informar que deseja utilizar a integração com a Seventh.

Nesta etapa, o cliente deve fornecer:

• Nome do condomínio

• CNPJ do condomínio

O parceiro será responsável por realizar a vinculação do condomínio em seu sistema para envio das notificações via API da Seventh.

3. Configuração no sistema Seventh

No ambiente WEB de configuração do condomínio, acesse Configurações > Configurações Gerais:

E habilitar a opção:

✅ Receber notificações de encomendas no aplicativo enviadas pelo parceiro

4. Validação do cadastro de moradores

Para o correto funcionamento das notificações, é necessário que:

• Os usuários estejam cadastrados com o perfil Morador
  

• O morador esteja logado no aplicativo

• O aplicativo esteja habilitado a opção de receber notificações

Caso o perfil, login e notificações, não esteja configurado corretamente, o usuário não receberá as notificações no aplicativo.

5. Validação da integração

Após as configurações, recomenda-se realizar um teste prático:

• Registrar uma entrega no armário inteligente

• Verificar o recebimento da notificação no aplicativo do morador

6. Operação do fluxo

Após validada, a integração passa a operar automaticamente:

• Entregas realizadas no armário → Notificação enviada ao aplicativo

• Retiradas realizadas → Notificação enviada ao aplicativo

Responsabilidades

Cliente Seventh:

• Contratar o parceiro (Armário Inteligente)

• Solicitar a integração com a Seventh

• Configurar o ambiente (flag e moradores)

Parceiro (Armário Inteligente):

• Vincular o condomínio ao seu sistema

• Realizar o envio das notificações via API

Seventh:

• Disponibilizar a API e infraestrutura de recebimento das notificações

• Garantir o envio das notificações ao aplicativo

Pontos de atenção

• A integração não é ativada automaticamente apenas pela homologação do parceiro

• É obrigatório que o parceiro (Armário Inteligente) realize a vinculação do condomínio

• A configuraçãoda flag no sistema Seventh deve estar habilitada

• Apenas usuários com perfil Morador recebem notificações

Resultado esperado

Após a ativação:

• O parceiro (Armário Inteligente) envia notificações via API para a Seventh

• O sistema processa os eventos de entrega e retirada

• Os moradores recebem notificações diretamente no aplicativo

O fluxo de gestão de encomendas passa a ocorrer de forma automatizada, garantindo maior eficiência operacional e melhor experiência para os usuários.