Integrar o Sami ao Opa! Suite

Acesso

Caminho: Opa! Store → Sami → Instalar

Visão geral

O app Sami conecta o Opa! Suite ao sistema de gestão imobiliária Sami Sistemas. Com ele, o agente virtual atende condôminos e clientes da imobiliária com recursos do Sami: segunda via de cobrança, agendamento de áreas comuns, abertura de chamados no CRM e envio de demonstrativos.

Pré-requisitos

• Permissão para visualizar o Opa! Store no seu grupo de permissões.
• Nenhum outro sistema de gestão instalado. O Opa! Suite aceita um app desta categoria por vez.
• Credenciais do Sami: host, usuário, código e sigla. Se não tiver esses dados, peça ao suporte do Sami.

Passo a passo

1. Acesse Opa! Store e abra o app Sami.
2. Clique em Instalar. A janela Instalar Sami abre.
3. Preencha os campos (todos são obrigatórios):
   • Host: IP ou endereço do seu Sami, com http:// ou https://. Se a porta web for a padrão (80), não precisa informá-la. Se for outra, use o formato http://IP:porta.
   • Usuário: usuário fornecido pelo Sami.
   • Código: código de acesso fornecido pelo Sami.
   • Sigla: sigla da empresa no Sami, com até 5 caracteres.
4. Clique em Instalar.
5. Na aba Preferências, seção Ferramentas, clique em Editar informações, ative os recursos que vai usar e clique em Salvar.
6. No fluxo de comunicação, adicione o card Integração ERP com a opção do recurso no ponto do fluxo em que ele deve ser oferecido.

Resultado esperado

Ao instalar, o Opa! Suite abre a tela de ajustes do app na aba Preferências. Na página do app no Opa! Store, o botão Instalar dá lugar a Ver ajustes.

Cada ferramenta ativada passa a aparecer como opção no card Integração ERP do fluxo de comunicação e, quando indicado na tabela, como atalho no atendimento.

Configurações disponíveis

Acesse Opa! Store → Sami → Ver ajustes. Em cada seção, clique em Editar informações, faça as alterações e clique em Salvar.

Aba Cadastro

Seção Dados de integração:

Campo	O que faz
Host	Endereço do Sami. Obrigatório.
Usuário	Usuário da integração. Obrigatório.
Novo código	Código de acesso. Deixe em branco para manter o valor atual.
Sigla	Sigla da empresa, com até 5 caracteres. Obrigatório.

Aba Preferências

Seção Preferências:

Campo	O que faz
Permitir autenticar a cliente inativo	Ativo: clientes inativos no Sami também podem se autenticar. Vem ativo na instalação.
Tempo máximo de resposta do App	Quanto tempo, em segundos, o Opa! Suite espera a resposta do Sami. Padrão e mínimo: 30 segundos.

Seção Ferramentas:

Ferramenta	Opção no card Integração ERP	Onde usar
Permitir envio de segunda via de cobrança	Segunda via da cobrança	Card e atalho no atendimento
Habilitar agendamento de área comum	Agendamento de área comum	Card
Abrir atendimento no CRM	Abrir atendimento no CRM	Card
Habilitar demonstrativos	Demonstrativo	Card e atalho no atendimento

Todas as ferramentas vêm desativadas na instalação.

Como os recursos funcionam no fluxo

Agendamento de área comum

O agente virtual guia o condômino pela reserva:

1. Lista as unidades do cliente para ele escolher.
2. Lista as áreas comuns disponíveis para agendamento.
3. Pede a data (no formato DD/MM/AAAA) e lista os turnos livres.
4. Pede a quantidade de pessoas, respeitando o máximo da área.
5. Pergunta se o cliente quer adicionar a taxa de limpeza e envia os termos de uso da área para ele aceitar, quando o Sami pedir.
6. Mostra o resumo e pede a confirmação. Confirmada, a reserva é registrada no Sami.

Abrir atendimento no CRM

O card abre um chamado no CRM do Sami e devolve ao cliente o código do chamado. Configure no card:

Campo	O que faz
Tipo de atendimento	Falar com a administradora, Registrar ocorrência ou Solicitar manutenção. Para usar mais de um tipo, crie um card para cada.
Solicitação da categoria do atendimento	Pergunta da categoria. Só aparece em Falar com a administradora.
Solicitação de inclusão do síndico	Pergunta se o síndico deve ser incluído. Só é enviada quando a unidade é de condomínio com síndico.
Solicitação do assunto	Pedido do assunto. O cliente responde com até 255 caracteres.
Solicitação da descrição	Pedido da descrição, que deve ser enviada em uma única mensagem.

Demonstrativo

O agente virtual lista os meses com demonstrativo, o cliente escolhe o mês e o demonstrativo, e recebe o link para visualizá-lo.

Segunda via da cobrança

Veja o funcionamento em Funcionalidades com o ERP Sami Sistemas.

Desinstalar o app

1. Acesse Opa! Store → Sami → Ver ajustes.
2. Clique em Desinstalar App.
3. Confirme em Desinstalar.

Os recursos param na hora

Ao desinstalar, a conexão com o Sami é interrompida e todos os recursos da integração são desativados, inclusive nos fluxos que usam o card Integração ERP.

Problemas comuns

Sintoma	O que verificar
A janela mostra Host inválido	Informe o endereço completo, com http:// ou https://.
A janela mostra O limite máximo é de 5 caracteres	A Sigla aceita no máximo 5 caracteres.
A página do app mostra Um app desta categoria já está instalado	Outro sistema de gestão já está instalado. Desinstale-o antes de instalar o Sami.
O agente virtual responde Nenhuma área disponivel para agendamento. ou Nenhum turno disponível para agendamento.	Não há área ou turno livre no Sami para a unidade e a data escolhidas.
Uma opção não aparece no card Integração ERP	Ative a ferramenta em Preferências → Ferramentas.

Boas práticas

• Crie um card Abrir atendimento no CRM para cada tipo de atendimento que o condomínio usa.
• Ajuste as mensagens de solicitação ao tom da sua administradora.
• Ative só os recursos que a equipe vai usar.

Conteúdos relacionados

• Funcionalidades com o ERP Sami Sistemas
• O que é o fluxo de comunicação
• Cards de ferramenta do sistema
• Card Autenticação simples
• Integrações