Integrar o Omie ao Opa! Suite
Caminho: Opa! Store → Omie → Instalar
Visão geral
O app Omie conecta o Opa! Suite ao sistema de gestão Omie. Com ele, o agente virtual e os atendentes enviam ao cliente a segunda via de cobrança e as notas fiscais (de produto e de serviço) sem sair do Opa! Suite.
Os clientes do Omie não são importados de uma vez. Quando o cliente informa o CPF/CNPJ no card Autenticação simples do fluxo de comunicação, o Opa! Suite procura o cadastro no Omie e cria o cliente no Opa! Suite. A integração não cria clientes no Omie.
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.
- App Key e App Secret do Omie. Só usuários administradores do Omie conseguem ver essas chaves. Para encontrá-las (ajuda do Omie):
- Entre no Omie. A tela Meus Aplicativos abre.
- No card do aplicativo, clique na engrenagem e escolha Resumo do App.
- Role até o fim da página, na área Chave de Integração (API). Clique em exibir para ver o App Secret.
Passo a passo
- Acesse Opa! Store e abra o app Omie.
- Clique em Instalar. A janela Instalar Omie abre.
- Preencha os campos (os dois são obrigatórios):
- App Key: chave de acesso do aplicativo no Omie.
- App Secret: chave secreta do aplicativo no Omie.
- Clique em Instalar.
- Na aba Preferências, seção Ferramentas, clique em Editar informações, ative as ferramentas que vai usar e clique em Salvar.
- No fluxo de comunicação, adicione o card Autenticação simples antes dos recursos da integração, para identificar o cliente pelo CPF/CNPJ.
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 como atalho no atendimento.
Configurações disponíveis
Acesse Opa! Store → Omie → 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 |
|---|---|
| Novo app Key | App Key. Deixe em branco para manter o valor atual. |
| Novo app secret | App Secret. Deixe em branco para manter o valor atual. |
Aba Preferências
Seção Preferências:
| Campo | O que faz |
|---|---|
| Sempre solicitar autenticação do cliente | Ativo: o agente virtual pede o CPF/CNPJ mesmo quando o contato já está vinculado a um cliente. Vem desativado na instalação. |
| Tempo máximo de resposta do App | Quanto tempo, em segundos, o Opa! Suite espera a resposta do Omie. Padrão e mínimo: 30 segundos. |
Seção Ferramentas:
| Ferramenta | O que libera | Onde usar |
|---|---|---|
| Permitir envio de segunda via de cobrança | Envio do boleto das contas a receber do cliente. | Card Integração ERP e atalho no atendimento |
| Permitir envio de nota fiscal | Envio das notas fiscais de produto e de serviço do cliente. | Card Integração ERP e atalho no atendimento |
Todas as ferramentas vêm desativadas na instalação.
Desinstalar o app
- Acesse Opa! Store → Omie → Ver ajustes.
- Clique em Desinstalar App.
- Confirme em Desinstalar.
Ao desinstalar, a conexão com o Omie é 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 É necessário preencher este campo para prosseguir | Preencha a App Key e o App Secret. |
| 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 Omie. |
| O cliente não é encontrado | Confira se o CPF/CNPJ informado está cadastrado no Omie. A integração não cria clientes no Omie. |
| Uma ferramenta não aparece no fluxo | Ative a ferramenta em Preferências → Ferramentas. |
| Erro ao salvar Tempo máximo de resposta do App | O valor mínimo é 30 segundos. |
Boas práticas
- Guarde a App Key e o App Secret em local seguro. Quem tem as chaves acessa os dados da empresa no Omie.
- Coloque o card Autenticação simples no início do fluxo, para que os clientes sejam cadastrados no Opa! Suite à medida que entram em contato.