Central de Ajuda

Português

Español

Português

Español

Appearance

Conectar o servidor MCP do IXC ACS ​

Acesso

Caminho: Menu lateral → Opa! IA → Servidores MCP → Adicionar novo → Tipo de MCP: IXC ACS

Disponibilidade

Este recurso é destinado a clientes Beta e será disponibilizado para os demais na versão v1.38.

Visão geral ​

Ao conectar o IXC ACS ao Opa! IA como servidor MCP, o assistente inteligente passa a consultar e agir nos equipamentos dos seus clientes durante a conversa. Ele identifica o equipamento, verifica se está online e pode executar diagnósticos e ações remotas, como reiniciar o roteador ou ajustar o Wi-Fi. Assim, muitos problemas são resolvidos sem acionar o suporte humano nem enviar uma visita técnica.

As ferramentas que o assistente recebe são as que o seu IXC ACS oferece. Ao testar a conexão, o Opa! Suite informa quantas foram encontradas.

Pré-requisitos ​

Passo a passo ​

Criar o cliente API no IXC ACS ​

  1. Acesse o seu IXC ACS.
  2. Vá em Ferramentas → Clientes API.
  3. Adicione um novo cliente, selecione o tipo Opa! Suite e altere o nome, se quiser.
  4. Clique em Criar cliente API.
  5. Copie o ID do cliente e a Senha do cliente gerados.

Adicionar o servidor no Opa! Suite ​

  1. Acesse Opa! IA → Servidores MCP e clique em Adicionar novo.
  2. Em Tipo de MCP, escolha IXC ACS.
  3. Preencha:
    • URL da API: o endereço da API do seu IXC ACS.
    • Permitir conexão insegura: deixe desligado, a não ser que o seu IXC ACS use um certificado que o Opa! Suite não reconheça. Ligar essa opção reduz a segurança da conexão.
    • ID do cliente e Senha do cliente: os dados copiados do IXC ACS.
  4. Clique em Adicionar servidor.
  5. Abra o servidor e clique em Testar conexão. A janela Resultado do teste de conexão informa se a conexão funcionou e quantas ferramentas foram encontradas.

Vincular o servidor ao assistente ​

  1. Abra o assistente em Opa! IA → Assistentes inteligentes, aba Perfil.
  2. Em Servidores MCP, selecione o servidor do IXC ACS.
  3. Nas Instruções ou no Fluxo de interações, descreva quando o assistente deve consultar o equipamento e quando deve agir nele.
  4. Teste em Pré-visualizar e clique em Publicar alterações.

Resultado esperado ​

O assistente passa a usar as ferramentas do IXC ACS na conversa, conforme as instruções que você escreveu. Entre as ações que o ACS oferece estão consultar o status e as informações do equipamento, ver os dispositivos conectados e a rede Wi-Fi, executar diagnósticos, reiniciar o equipamento e alterar configurações de Wi-Fi.

Regras e comportamentos ​

  • Troca de senha do Wi-Fi: a nova senha precisa ter de 8 a 24 caracteres, com letra maiúscula, minúscula, número e um caractere especial (@$!%*?&).
  • Tempo dos diagnósticos: alguns diagnósticos podem levar até 120 segundos. Peça ao assistente que avise o cliente para aguardar.
Ações remotas podem derrubar a conexão

Reiniciar o equipamento ou alterar as configurações de Wi-Fi pode desconectar temporariamente os dispositivos da rede do cliente. Oriente o assistente a pedir a confirmação do cliente antes de executar essas ações.

Problemas comuns ​

  • Aparece "Erro de conexão": confira a URL da API e se o IXC ACS está acessível. Se o certificado não for reconhecido, avalie a opção Permitir conexão insegura.
  • Nenhuma ferramenta encontrada: confira o ID do cliente e a Senha do cliente e se o cliente API do IXC ACS foi criado com o tipo Opa! Suite.
  • O assistente não usa o ACS: confirme se o servidor está vinculado na aba Perfil e citado nas instruções, e se você publicou as alterações.

Boas práticas ​

  • Peça confirmação do cliente antes de ações que afetem a conexão.
  • Defina nas instruções quando transferir para uma pessoa, por exemplo se o equipamento continuar offline depois do reinício.
  • Acompanhe o consumo do assistente na Performance do Opa! IA, porque diagnósticos geram várias etapas.

Conteúdos relacionados ​