Como integrar o IXC com WhatsApp e IA usando n8n

O desenho do fluxo

1. GatilhoMensagem chegaWebhook da plataforma de atendimento (Opa Suite ou outra com API) ou o gatilho do WhatsApp Cloud API.
2. n8nIdentifica e consultaAcha o cliente no IXC pelo telefone e entrega a um nó de agente de IA com ferramentas de consulta.
3. RespostaResponde ou transfereDevolve a resposta pela mesma plataforma ou abre a conversa para um atendente.

Passo a passo no n8n

1. Receba a mensagemCrie um nó Webhook e aponte para ele o envio de mensagens da sua plataforma de atendimento, ou use o gatilho de WhatsApp do n8n com a API oficial.
2. Normalize o telefoneTire +55, espaços e traços. O IXC guarda telefones em formatos variados, então compare só os dígitos.
3. Busque o cliente no IXCUse um nó HTTP Request (configuração abaixo) na tabela cliente, filtrando pelo campo whatsapp ou telefone_celular do cadastro (o IXC também tem o campo fone), e confira se o telefone devolvido bate só pelos dígitos.
4. Monte o agenteUse o nó de agente de IA do n8n com instruções claras do que ele pode e não pode fazer, e conecte como ferramentas as consultas ao IXC: status de conexão (radusuarios) e faturas em aberto (fn_areceber).
5. Defina o transbordoQuando o pedido sair das regras, o fluxo chama a API da plataforma para transferir a conversa para o setor certo, com um resumo.
6. Registre tudoGuarde cada execução com o que foi consultado e respondido. Sem isso, não dá para entender um erro depois.

Configuração do nó HTTP Request para o IXC

Method:          POST
URL:             https://seu-ixc/webservice/v1/cliente
Authentication:  Generic Credential Type → Basic Auth
                 User = parte do token antes dos dois-pontos
                 Password = parte do token depois dos dois-pontos
Headers:         ixcsoft: listar
                 Content-Type: application/json
Body (JSON):
{
  "grid_param": "[{\"TB\":\"cliente.telefone_celular\",\"OP\":\"=\",\"P\":\"{{ $json.telefone }}\"}]",
  "page": "1",
  "rp": "20"
}

Onde o fluxo simples começa a pesar

O fluxo de demonstração funciona rápido. Em produção, com milhares de clientes, aparecem outras perguntas.

Dados sensíveis

CPF, códigos de pagamento e dados de conta não precisam ir para o modelo de IA e acabam nos logs. Separe o que a IA vê do que o sistema envia.

Filtro que engana

O IXC pode devolver registros parecidos com o filtrado. Sem revalidação, o agente responde sobre o cliente errado.

Massiva

Detectar queda por bairro ou OLT exige acompanhar o status de todos os clientes de tempos em tempos, não só de quem chamou.

Mais de um IXC

Provedores com mais de uma base precisam saber em qual delas o cliente está. O id do cliente não é único entre bases.

Falhas e retentativas

Quando o IXC demora ou cai, o cliente não pode ouvir que não é cliente. É preciso tratar falha, repetir com cuidado e avisar a equipe.

Quem mantém

Fluxo que ninguém documenta vira dependência de uma pessoa. Defina quem cuida e onde ficam as instruções.

Perguntas frequentes