Como integrar o WhatsApp ao IXC Soft: token, permissões e teste

Por I4 Soluções. Publicado em .

Integrar o WhatsApp ao IXC Soft é o que permite que a segunda via, o desbloqueio de confiança e o aviso de desconexão aconteçam na própria conversa, com os dados do IXC. Seja um chatbot simples ou um atendimento com IA, a ligação costuma passar pelo mesmo caminho: a API do IXC, chamada de webservice, acessada com um token gerado no próprio sistema.

Este guia mostra o que preparar no IXC, quais permissões dar, o que configurar no I4 Chat e como testar antes de abrir para os assinantes. Os caminhos de menu seguem o guia oficial do IXC sobre tokens de API.

O que ter em mãos antes de começar

  • O endereço do seu IXC: o domínio que a equipe usa para entrar no sistema.
  • Acesso de administrador no IXC: para criar o usuário e o grupo da integração.
  • A lista do que você quer ligar: segunda via, desbloqueio de confiança, régua de cobrança, aviso de desconexão. As permissões dependem dessa escolha.

Passo 1: crie um usuário só para a integração

  1. No IXC, abra Configurações > Usuários > Usuário.
  2. Clique em Novo e crie um usuário para o WhatsApp.
  3. Na seção API, marque Permite acesso a API.
  4. Salve. O token aparece no campo Token de acesso.

Use um usuário exclusivo, e não o de alguém da equipe. Há dois motivos. O primeiro é o histórico: com um usuário só para a integração, os logs do IXC mostram o que foi feito por ela e o que foi feito por uma pessoa.

O segundo é que o token está preso ao usuário. Se o e-mail ou a senha dele mudar, o IXC gera outro token, e a integração para de funcionar até alguém colar o novo. Com o usuário de um atendente, basta uma troca de senha para o WhatsApp perder o acesso ao IXC.

Passo 2: dê ao token só as permissões que ele usa

O token só faz o que o grupo de usuários dele permite. Por isso, o IXC recomenda um grupo exclusivo para integrações.

  1. Abra Configurações > Usuários > Grupo de usuários.
  2. Clique em Novo, ou em Duplicar Grupo se já existir um grupo parecido.
  3. Na aba Permissões, libere só o que as funções escolhidas usam.
  4. Salve e vincule o usuário da integração a esse grupo.

O que cada função do I4 Chat consulta no IXC:

  • Segunda via com Pix: o cadastro do cliente, os contratos, as contas a receber e o boleto.
  • Desbloqueio de confiança: o contrato escolhido e a ação de desbloqueio de confiança.
  • Régua de cobrança: o cadastro do cliente e as faturas pelo vencimento.
  • Aviso de desconexão: os logins dos assinantes.
  • Dados do assinante ao lado da conversa, para a equipe: cadastro, contratos, faturas e logins.

Dessas funções, só o desbloqueio de confiança executa uma ação no IXC, e só se você habilitar. As outras apenas consultam. Um caminho seguro é começar pelas consultas e liberar o desbloqueio quando decidir usar. Na implantação, a I4 passa a lista exata de permissões para o que você contratou.

Passo 3: libere a rede, se o seu IXC restringe por IP

O grupo de usuários do IXC tem o campo Redes permitidas, na seção Permissão de login. Quando ele está preenchido, só os endereços da lista conseguem usar o token. Nesse caso, o servidor do I4 Chat precisa entrar na lista, com os IPs separados por ponto e vírgula.

Atenção a um detalhe do próprio IXC: se você puser esses endereços num grupo que a sua equipe também usa, inclua as redes da equipe. Sem elas, as pessoas perdem o acesso ao sistema. Com um grupo só para a integração, esse risco não existe.

A I4 confere esse ponto com você na implantação.

Passo 4: conecte o IXC no I4 Chat

Com o token pronto, a configuração no I4 Chat leva quatro dados e uma escolha:

  • Endereço: só o domínio do IXC, sem "https://" e sem barra no final.
  • Token: o que apareceu em Token de acesso.
  • Filial: opcional. Em branco, vale a filial padrão. Preencha se o provedor trabalha com mais de uma.
  • Funções ligadas: segunda via, consulta pela IA e desbloqueio de confiança, cada uma com a sua chave.

Depois, você escolhe quais agentes de IA podem consultar o IXC. O agente de vendas, por exemplo, pode ficar sem acesso às faturas, enquanto o financeiro envia a segunda via e faz o desbloqueio.

Na implantação, o time da I4 faz essa configuração e o teste com você.

Solicitar demonstração

Passo 5: teste antes de abrir para os assinantes

  1. Teste a conexão no I4 Chat. Se der erro de autenticação, veja a seção de problemas abaixo.
  2. Busque as faturas de um assinante pelo CPF e compare com o IXC: valor, vencimento e Pix precisam bater.
  3. Teste um assinante com mais de um contrato. A IA tem de perguntar de qual contrato ele precisa antes de enviar a fatura.
  4. Se for usar o desbloqueio, faça um teste com a equipe acompanhando e confira no IXC se a liberação aparece com o prazo que você configurou.
  5. Converse com a IA como um assinante faria: "manda meu boleto", "minha internet foi cortada", "quero desbloquear". As respostas precisam seguir as regras da sua operação.

Problemas comuns e como resolver

  • Erro de autenticação: o token ou o endereço estão errados. Confira se o endereço está sem "https://" e sem barra no final. Se a senha ou o e-mail do usuário da integração mudaram, o token também mudou: copie o novo.
  • O IXC não responde ao I4 Chat: confira as Redes permitidas do grupo de usuários.
  • A conexão passa, mas a busca pelo CPF não traz faturas: veja no IXC se o assinante tem fatura em aberto e se a filial informada é a dele.
  • A IA não envia a segunda via: o IXC precisa estar ligado também no agente de IA, e não só na integração.
  • A IA não oferece o desbloqueio: a função precisa estar habilitada no I4 Chat, e a permissão de desbloqueio, liberada no grupo do IXC.
  • O Pix não vai junto com a fatura: a IA envia o Pix quando o IXC gera o código para aquela fatura. Confira no IXC se ela tem Pix.

Segurança: o que vale para qualquer integração com o IXC

  • Um usuário por integração. Cada sistema ligado ao IXC fica com o seu usuário, e os logs mostram quem fez o quê.
  • Permissão mínima. O grupo da integração recebe só o que as funções usam.
  • Token guardado com cuidado. Não mande o token em grupo de WhatsApp nem em e-mail aberto. Se ele vazar, troque a senha do usuário da integração: o IXC gera outro token, e o antigo deixa de valer.
  • Assinante identificado pelo documento. Quem escreve nem sempre é o titular. No I4 Chat, a IA pede o CPF ou o CNPJ antes de buscar faturas ou pedir o desbloqueio.

Perguntas frequentes

Onde gero o token do IXC Soft?

Em Configurações > Usuários > Usuário. Crie ou edite o usuário da integração, marque Permite acesso a API e salve. O token aparece no campo Token de acesso.

Quais permissões o token do IXC precisa para o WhatsApp?

As das funções que você vai usar. A segunda via consulta cadastro, contratos, contas a receber e boleto. O desbloqueio de confiança precisa da ação de desbloqueio. O aviso de desconexão consulta os logins. Na implantação, a I4 passa a lista exata.

O I4 Chat altera dados no meu IXC?

Nas funções deste guia, só o desbloqueio de confiança executa uma ação, e só se você habilitar. As outras consultam. E, de qualquer forma, o token só faz o que o grupo de usuários dele permite.

Posso usar o mesmo usuário do IXC de outra integração?

Pode funcionar, mas o IXC recomenda um usuário exclusivo por integração, para os logs mostrarem quem fez cada ação. Há também um risco prático: se a senha desse usuário mudar por causa da outra integração, as duas param juntas.

O assinante é identificado pelo número do WhatsApp?

Na conversa, a IA pede o CPF ou o CNPJ do titular e busca o cadastro no IXC. Na tela da equipe, o I4 Chat também procura o assinante pelo número do WhatsApp, para o atendente ver os dados ao lado da conversa.

Veja funcionando com o seu IXC

O que a integração entrega no dia a dia está na página do atendimento no WhatsApp integrado ao IXC Soft. O passo a passo do desbloqueio pelo WhatsApp está no guia de desbloqueio de confiança no IXC e no TopSapp.

Na demonstração, a I4 mostra a conversa completa com o IXC: o assinante pede a segunda via, a IA identifica pelo CPF, envia o Pix e, se você quiser, faz o desbloqueio. Planos a partir de R$ 249,90.

Solicitar demonstração