Integrar o WhatsApp ao IXC: token, permissões e o que dá para automatizar

Integrar o WhatsApp ao IXC significa dar a uma plataforma de atendimento um token de API do IXC Provedor para que a conversa leia e escreva dentro do ERP — identificar o assinante, consultar contrato, emitir segunda via, abrir ordem de serviço, checar o status da conexão. A diferença que pega quase todo provedor de surpresa está em um detalhe: no IXC, a permissão não mora no token, mora no grupo de usuários a que o usuário do token está vinculado. É esse desenho que decide o que a sua automação vai poder fazer — e o que ela vai derrubar quando alguém trocar uma senha.

Este artigo é para quem opera um provedor no IXC e quer saber, na prática, o que a integração exige e o que dá para automatizar. Tudo o que se afirma aqui sobre o IXC vem da Central de Ajuda e da documentação oficial da API da IXC Soft, consultadas em 2 de setembro de 2026.

O IXC já tem um caminho de omnichannel documentado

Antes de contratar qualquer coisa, vale saber o que o ERP já prevê. A Central de Ajuda do IXC documenta uma Integração Omnichannel com o Opa! Suite (consultada em 02/09/2026), configurada em Configurações > Integrações > Integrações Omnichannel, com os campos Descrição, Gateway, URL, Token e "Utiliza fila de mensagens". Os requisitos listados são credenciamento junto à plataforma e um token gerado do lado dela.

A própria documentação descreve três entregas dessa integração: abrir a dashboard do cliente no Opa! Suite a partir do cadastro no IXC, permitir o envio de mensagens omnichannel e gerenciar a fila de mensagens. Há ainda uma rotina de cobrança documentada: o IXC identifica as faturas vencidas pelos parâmetros de cobrança, abre um chamado na plataforma a partir de um template, e a sequência de contatos corre de lá.

Repare no formato: é um gateway de saída — o ERP dispara, a plataforma conduz — mais uma dashboard de consulta para o atendente. Isso resolve muito bem a régua de cobrança. O que essa lista de entregas não descreve é o caminho inverso, em que a resposta do assinante executa uma ação dentro do IXC sem operador digitando nada. Não é uma crítica ao conector: é o escopo que o IXC documenta para ele.

Quem quer o caminho inverso vai pela API do IXC — que é aberta a qualquer plataforma de atendimento, não a uma só. E aqui vale a parte que ninguém conta: trocar de plataforma de atendimento não exige trocar de ERP. Se você chegou até aqui procurando o que existe além do conector nativo, a comparação está detalhada em alternativas ao Opa! Suite para provedor de internet.

A porta de entrada: o token de API do IXC

A geração do token é rápida e está documentada em Configurações > Usuários > Usuário: basta marcar a opção "Permite acesso a API" e salvar — o token aparece automaticamente no campo "Token de acesso". O que exige critério não é gerar; é decidir quem é esse usuário.

Quatro pontos da documentação oficial que mudam a operação:

• Use um usuário exclusivo para a integração. A recomendação é do próprio IXC, e a razão é auditoria: com usuário dedicado, os logs de alteração distinguem o que foi feito por uma pessoa e o que foi feito pela integração. Sem isso, você não consegue responder "quem deu baixa nesse título".
• O token está vinculado ao usuário. A documentação avisa: se o e-mail ou a senha desse usuário forem alterados, o token muda automaticamente. Essa é a causa número um de integração que "para do nada" — alguém rodou a política de troca de senha e derrubou o atendimento junto.
• A permissão vem do grupo de usuários. Segundo a mesma página, se o grupo vinculado ao usuário não tiver as permissões necessárias, o token não acessa o recurso via API. É lá, e não no token, que você define até onde a automação vai.
• Liberação de IP. É possível restringir o acesso liberando os IPs da integração no grupo de usuários — com um alerta explícito na documentação: libere também os IPs dos seus próprios usuários, ou você perde o acesso ao IXC Provedor.

Vale saber também que a API do IXC roda como um webservice no servidor do próprio provedor. A documentação oficial tem seções dedicadas a "Configuração Webservice", "Verificar acesso API" e à configuração de acesso no Apache e no Nginx, além de uma área de erros comuns (401, 404, 400). Traduzindo: parte da integração é conversa com quem cuida do servidor, não só clique na tela. Reserve isso no cronograma.

O que dá para automatizar quando a conversa enxerga o IXC

Com leitura e escrita liberadas, o atendimento deixa de ser transcrição manual entre a tela do WhatsApp e a tela do ERP. Na integração da Talqui com o IXC, a IA navega pelo sistema em nome do cliente e cobre as frentes que enchem a fila do nível 1:

• Segunda via autônoma — emissão com cálculo de juros e envio no WhatsApp, sem fila e sem operador.
• Lembretes proativos de pagamento — aviso antes do vencimento, que é onde a inadimplência ainda é barata de evitar.
• Diagnóstico técnico — verificação de status da conexão e teste de velocidade direto na conversa.
• Abertura de ordem de serviço — quando o problema não se resolve sozinho, o chamado nasce no IXC sem alguém redigitar.
• Contratos e planos — leitura do histórico para apoiar retenção e upsell na hora certa.

Não é teoria: a SynkNet, provedor do interior do Maranhão, migrou atendimentos repetitivos — reenvio de cobrança e consulta de status de pagamento — para uma IA especializada integrada a IXC e SGP TSMX, com autoatendimento 24/7 pelo WhatsApp.

Quatro decisões antes de ligar a integração

1. Quem é o usuário da integração. Crie um exclusivo, com nome que se identifique nos logs, e trate a senha dele como credencial de sistema — não como senha de pessoa. Coloque no runbook: alterar e-mail ou senha desse usuário regenera o token e derruba a integração.
2. Quais permissões o grupo carrega. Comece com um grupo de leitura, valide as consultas, e só depois libere escrita. Consulta de fatura e status de conexão são reversíveis; baixa de título e alteração cadastral, não.
3. Como o assinante é identificado. Número de telefone não é chave confiável: troca de titularidade, contrato em nome de terceiro e segunda linha quebram a associação. Defina qual dado a conversa pede (CPF/CNPJ ou contrato) e o que acontece quando não bate.
4. Quanto custa a conversa. A integração roda sobre a API oficial do WhatsApp, que é cobrada pela Meta — as regras estão na documentação oficial de preços da Cloud API. Um provedor que dispara régua de inadimplência para milhares de assinantes precisa dessa conta antes, não depois.

👉 Faça a conta primeiro: a calculadora de preços da API oficial do WhatsApp estima o custo mensal a partir do seu volume. E se você ainda não acompanhou o que muda no modelo de cobrança, o artigo sobre a nova cobrança da API do WhatsApp explica o impacto para quem envia em volume.

IXC não é o único: SGP, Hubsoft e MK

A lógica descrita aqui — usuário dedicado, permissão granular, identificação do assinante, automação do nível 1 — se repete nos outros ERPs do mercado de provedor, com implementações diferentes. No SGP, por exemplo, a permissão é definida por opções do próprio token, e não pelo grupo de usuários: o passo a passo está no artigo sobre como integrar o WhatsApp ao SGP. No MK Solutions são quatro campos de autenticação mais uma liberação de IP — o detalhe está em integrar o WhatsApp ao MK Solutions. Se a sua operação roda em outro sistema, veja as integrações com SGP TSMX, Hubsoft e MK Solutions.

E se a dúvida ainda é anterior a isso — o que a automação resolve sozinha e onde ela precisa chamar um humano —, esse recorte está no artigo sobre IA para provedor de internet.

No HubSoft o desenho é diferente de novo: a credencial é um conjunto de cinco dados por integrador — host, client_id, client_secret, usuário e senha — e a permissão fica no usuário de API, não no token. O passo a passo está em integrar o WhatsApp ao HubSoft.

Perguntas frequentes

O IXC tem chat de WhatsApp nativo?

A Central de Ajuda do IXC documenta uma integração omnichannel com o Opa! Suite, que permite envio de mensagens, abertura da dashboard do cliente e gestão da fila (consultada em 02/09/2026). Para conversa de mão dupla com múltiplos atendentes e automação que executa ação dentro do ERP, a ligação é feita pela API do IXC com uma plataforma de atendimento.

Preciso trocar de ERP para trocar de plataforma de atendimento?

Não. A API do IXC Provedor é aberta a integrações de terceiros — a documentação oficial descreve a geração de token para "conectar sistemas e automatizar processos". O ERP continua onde está; o que muda é qual plataforma consome a API.

O token do IXC dá acesso total ao sistema?

Não necessariamente. Segundo a documentação, o token herda as permissões do grupo de usuários vinculado ao usuário que o gerou — se o grupo não tem a permissão, o token não acessa o recurso. Também é possível restringir por IP no mesmo grupo.

Por que a integração com o IXC parou de funcionar do nada?

A primeira hipótese a checar é a senha. A documentação do IXC é explícita: o token está vinculado ao usuário e é alterado automaticamente quando o e-mail ou a senha desse usuário mudam. Uma troca de senha de rotina invalida o token em uso.

A integração usa a API oficial do WhatsApp?

Sim. O atendimento roda sobre a Cloud API da Meta, que tem cobrança por conversa — por isso o dimensionamento de custo entra na avaliação desde o começo, e não depois do piloto.

O próximo passo

Se o seu provedor roda no IXC e a equipe gasta o dia respondendo pedido de segunda via e "minha internet caiu", a conta a fazer é objetiva: quantos desses atendimentos sobreviveriam a uma automação que enxerga o ERP. Veja como a Talqui atende provedores de internet e o que a integração com o IXC resolve — ou fale com um especialista para desenhar o piloto a partir dos fluxos que mais pesam na sua fila.