Integrar o IXC Provedor ao Opa! Suite
Caminho: Opa! Store → IXC Provedor → Instalar
Visão geral
O app IXC Provedor conecta o Opa! Suite ao sistema de gestão IXC Provedor. Com ele, o agente virtual e os atendentes usam recursos do IXC sem sair do Opa! Suite: segunda via de cobrança, nota fiscal, desbloqueio de confiança, diagnóstico, contratos, abertura de atendimento no IXC e outros. A integração também mantém os clientes, contatos e fornecedores do IXC sincronizados com o Opa! Suite.
A integração não tem custo adicional no Opa! Store.
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.
Um usuário do IXC Provedor com acesso à API e o token gerado para ele. Para criar:
- No IXC Provedor, acesse Configurações → Usuários → Usuários.
- Crie um novo usuário e preencha as informações básicas.
- Habilite Permitir acesso à API e salve.
- Copie o token gerado. Ele vai no campo Token do Opa! Suite.
Veja os detalhes no formulário de usuários do IXC Provedor.
Com um usuário exclusivo, as ações feitas pelo Opa! Suite ficam identificadas nas auditorias do IXC Provedor.
Passo a passo
- Acesse Opa! Store e abra o app IXC Provedor.
- Clique em Instalar. A janela Instalar IXC Provedor abre.
- Preencha os campos (todos são obrigatórios):
- URL: endereço do seu IXC Provedor com
https://na frente, por exemplohttps://dominio.com.br. Não acrescente nada depois do domínio, como/adm.php. - Token: token do usuário criado no IXC Provedor.
- URL: endereço do seu IXC Provedor com
- Clique em Instalar. O Opa! Suite testa a conexão com o IXC antes de concluir.
- Na aba Preferências, ative os recursos que vai usar. Em cada seção, clique em Editar informações, ative as opções e clique em Salvar.
- No fluxo de comunicação, adicione o card Autenticação simples (ou o de autenticação por dois fatores) antes dos recursos que dependem do cliente identificado.
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.
Todos os recursos vêm desativados. Cada recurso ativado passa a aparecer no card Integração ERP do fluxo de comunicação, como atalho no atendimento ou nos dois, conforme as tabelas abaixo.
Configurações disponíveis
Acesse Opa! Store → IXC Provedor → 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 IXC Provedor. Obrigatório. |
| Novo token | Token do usuário da API. 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. |
| Permitir autenticar a cliente inativo | Ativo: clientes inativos no IXC também podem se autenticar. Vem ativo na instalação. |
| Separar boletos por contrato | Ativo: quando o cliente tem mais de um contrato, ele escolhe o contrato e recebe só as cobranças dele. Cobranças sem contrato aparecem na opção Avulsos. Vem ativo na instalação. |
| Permitir visualizar e escolher contratos inativos | Ativo: contratos inativos aparecem na lista de contratos. Vem ativo na instalação. |
| Lembrar escolha de contrato na etapa de diagnóstico | Ativo: o contrato escolhido no diagnóstico é reaproveitado no mesmo atendimento, por exemplo na segunda via, sem perguntar de novo. Vem desativado na instalação. |
| Canal à enviar 2ª via se solicitado pela telefonia | Quando o cliente pede a segunda via pela telefonia, o boleto também é enviado por SMS, E-mail ou ambos. Só funciona se a integração de SMS ou de e-mail estiver ativa. Vem com SMS na instalação. |
| Exibir notas fiscais dos últimos | Período, em dias, das notas fiscais listadas ao cliente. De 30 dias a 5 anos (1.827 dias). Padrão: 365. Períodos acima de 365 dias podem deixar a consulta lenta. |
| Tempo máximo de resposta do App | Quanto tempo, em segundos, o Opa! Suite espera a resposta do IXC. Padrão e mínimo: 30 segundos. |
Aba Preferências: seção Recursos financeiros
| Recurso | 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 |
| Permitir desbloqueio de confiança | Desbloqueio da conexão do cliente em confiança. | Card Integração ERP e atalho |
| Permitir liberação temporária de acesso | Liberação temporária do acesso do cliente. | Atalho |
| Permitir liberação de redução de velocidade | Retirada da redução de velocidade do cliente. | Card Integração ERP e atalho |
| Permitir envio de nota fiscal | Envio das notas fiscais do cliente, dentro do período de Exibir notas fiscais dos últimos. | Card Integração ERP e atalho |
Aba Preferências: seção Recursos de gestão de clientes
| Recurso | O que faz |
|---|---|
| Habilitar sincronização rápida de clientes | Traz para o Opa! Suite os clientes novos do IXC e atualiza os que mudaram desde a última sincronização. Roda automaticamente a cada hora. |
| Habilitar sincronização completa de clientes | Traz todos os clientes do IXC que ainda não estão no Opa! Suite e atualiza os que mudaram. Roda automaticamente todos os dias às 03h30. |
| Habilitar sincronização de contatos/leads | Sincroniza os contatos do IXC junto com a sincronização de clientes. |
| Habilitar sincronização de fornecedores | Sincroniza os fornecedores do IXC junto com a sincronização de clientes. |
Também é possível rodar a sincronização na hora, em Clientes/Fornecedores, pelo botão de sincronização (Sincronização rápida ou Sincronização completa). O botão depende da permissão do grupo do usuário e do recurso estar ativo aqui. Com o recurso desativado, o Opa! Suite avisa que a sincronização está desabilitada.
Aba Preferências: seção Recursos de contratos e negociações
| Recurso | O que libera | Onde usar |
|---|---|---|
| Permitir listagem de propostas e negociações | Envio das propostas e negociações do cliente. | Atalho |
| Permitir aceite eletrônico de contratos | Aceite eletrônico do contrato pelo cliente. | Card Integração ERP e atalho |
| Permitir listagem de contratos | Envio do contrato do cliente. | Atalho |
Aba Preferências: seção Recursos de atendimentos
| Recurso | O que libera | Onde usar |
|---|---|---|
| Exigir autenticação por dois fatores | Card que, além do CPF/CNPJ, pede um segundo dado de acesso do cliente, como o e-mail e a senha da Central do Assinante. | Card Integração ERP |
| Habilitar ferramenta de diagnóstico | Diagnóstico da conexão e do contrato do cliente. | Card Integração ERP e atalho |
| Abrir atendimento no IXC Provedor | Abertura de atendimento no IXC Provedor a partir do fluxo. | Card Integração ERP |
| Permitir alterações de login e senha do roteador | Alteração do login e da senha do roteador pelo cliente. | Card Integração ERP |
IXC Franquia e IXC Sistema
Além do IXC Provedor, a categoria Sistema de gestão da Opa! Store traz mais dois apps da família IXC:
| App | Para que serve |
|---|---|
| IXC Franquia | Centraliza e gerencia o contato entre os seus clientes e as suas franquias. |
| IXC Sistema | Centraliza contatos e leva recursos e automatizações personalizadas para empresas que usam o IXC Sistema. |
Os dois são instalados como o IXC Provedor:
- Crie, no seu sistema IXC, um usuário com Permitir acesso à API e copie o token (Configurações → Usuários → Usuários).
- Em Opa! Store, abra o app e clique em Instalar.
- Informe a URL do seu sistema, com
https://na frente e sem nada depois do domínio, e o Token. - Clique em Instalar.
Lembre-se de que o Opa! Suite aceita um app de sistema de gestão por vez.
Desinstalar o app
- Acesse Opa! Store → IXC Provedor → Ver ajustes.
- Clique em Desinstalar App.
- Confirme em Desinstalar.
Ao desinstalar, a conexão com o IXC Provedor é interrompida e todos os recursos da integração são desativados, inclusive a sincronização de clientes e os fluxos que usam o card Integração ERP.
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| Não foi possível conectar. Revise as informações e tente novamente. | Confira se a URL está só com o domínio (sem /adm.php), se o token foi copiado inteiro e se o usuário tem Permitir acesso à API habilitado no IXC. |
| A janela mostra Url inválida | Informe o endereço completo, com 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 IXC Provedor. |
| A sincronização avisa que está desabilitada | Ative Habilitar sincronização rápida de clientes ou Habilitar sincronização completa de clientes em Recursos de gestão de clientes. |
| A segunda via pedida pela telefonia não chega por SMS ou e-mail | Confira o Canal à enviar 2ª via se solicitado pela telefonia e se a integração de SMS ou de e-mail está instalada e ativa. |
Boas práticas
- Ative a sincronização rápida para que clientes novos do IXC cheguem ao Opa! Suite ao longo do dia.
- Mantenha Exibir notas fiscais dos últimos em até 365 dias, a menos que os clientes precisem de notas mais antigas.
- Ative só os recursos que a equipe vai usar. Recursos desativados não aparecem no fluxo nem nos atalhos.