Integrar o ERP Voalle ao Opa! Suite
Caminho: Opa! Store → ERP Voalle → Instalar
Visão geral
O app ERP Voalle conecta o Opa! Suite ao sistema de gestão Voalle (Synsuite). Com ele, o agente virtual e os atendentes enviam a segunda via de cobrança e fazem o desbloqueio de confiança do contrato ou da conexão do cliente sem sair do Opa! Suite.
Os clientes do Voalle não são importados de uma vez. O cadastro do cliente é criado no Opa! Suite quando ele informa o CPF/CNPJ no card Autenticação simples do fluxo de comunicação.
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 da API do Voalle: URL, Client ID, Client Secret e SynData. Se não tiver esses dados, peça ao suporte da Voalle.
- Portas da API e de autenticação, se o seu Voalle não usar as portas padrão (45715 para a API e 45700 para a autenticação).
Passo a passo
- Acesse Opa! Store e abra o app ERP Voalle.
- Clique em Instalar. A janela Instalar ERP Voalle abre.
- Preencha os campos:
- URL: IP ou endereço do seu Voalle, com
http://ouhttps://. Obrigatório. - Client ID: identificador do cliente da API. Obrigatório.
- Client Secret: chave secreta do cliente da API. Obrigatório.
- SynData: dado de acesso fornecido pela Voalle. Obrigatório.
- Porta da API: opcional. Se ficar vazio, o Opa! Suite usa 45715.
- Porta de Autenticação: opcional. Se ficar vazio, o Opa! Suite usa 45700.
- URL: IP ou endereço do seu Voalle, com
- 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.
O Opa! Suite junta a URL com a Porta da API e com a Porta de Autenticação para se conectar. Informe as portas nesses campos, e não na URL.
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 → ERP Voalle → 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 |
|---|---|
| URL | Endereço do Voalle. Obrigatório. |
| Novo Client ID | Client ID. Deixe em branco para manter o valor atual. |
| Novo Client Secret | Client Secret. Deixe em branco para manter o valor atual. |
| Novo SynData | SynData. Deixe em branco para manter o valor atual. |
| Porta da API | Porta da API. Vazio: 45715. Aceita valores de 1 a 65535. |
| Porta de Autenticação | Porta de autenticação. Vazio: 45700. Aceita valores de 1 a 65535. |
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. |
| Permitir autenticar a cliente inativo | Ativo: clientes inativos no Voalle 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 Voalle. 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 da segunda via das cobranças do cliente. | Card Integração ERP e atalho no atendimento |
| Permitir desbloqueio de confiança | Desbloqueio do contrato ou da conexão do cliente em confiança. | Card Integração ERP e atalho no atendimento |
Todas as ferramentas vêm desativadas na instalação.
Desinstalar o app
- Acesse Opa! Store → ERP Voalle → Ver ajustes.
- Clique em Desinstalar App.
- Confirme em Desinstalar.
Ao desinstalar, a conexão com o Voalle é 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 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 ERP Voalle. |
| Os recursos não respondem | Confira se as portas do Voalle são as padrão. Se não forem, preencha Porta da API e Porta de Autenticação. |
| 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
- 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.
- Ative só as ferramentas que a equipe vai usar.