Conecte seu próprio sistema

Visão geral

Canais e integrações → Sistema próprio (/pt/integrations/own-system) é para lojas que mantêm contas de clientes em seu próprio sistema (por exemplo, um portal de logística) e não querem copiar esses dados para a OrderInChat.

• Você incorpora o widget da OrderInChat em suas páginas logadas.
• Seu servidor assina um token de curta duração para o usuário logado e o fornece ao widget.
• Quando esse cliente pergunta sobre sua própria conta (por exemplo, "Onde está minha remessa?"), a IA chama suas próprias ferramentas MCP somente leitura com o token desse usuário, no chat de texto e em chamadas de voz iniciadas a partir do widget.
• A OrderInChat apenas verifica sua assinatura. Nunca cria identidades, nunca lê seu banco de dados e não armazena o que suas ferramentas retornam.

Disponível em planos pagos (Starter, Pro, Ultra). Visitantes sem um token válido são anônimos: a IA responde a partir de sua base de conhecimento e pede que eles façam login para perguntas sobre a conta.

Deixe a IA do seu desenvolvedor construir

Em Entregue à IA do seu desenvolvedor, clique em Copiar instruções e cole o texto como está no assistente de IA dos seus desenvolvedores (Claude Code, Cursor, ChatGPT…). Ele está em inglês e descreve exatamente o que construir — o endpoint de token, o servidor MCP assinado e o código do widget — com o ID da sua loja e seus endereços preenchidos. Ele pede que a IA termine com uma lista dos valores a preencher nesta página. Segredos nunca entram no texto: crie os segredos de assinatura nesta página e configure-os você mesmo no seu servidor.

1. Token de login do usuário

Seu servidor assina um JWT para o usuário logado:

Escolha como a OrderInChat verifica:

• URL JWKS (ES256 ou RS256) — o endereço HTTPS de suas chaves públicas.
• Chave pública (ES256 ou RS256) — cole a chave pública PEM.
• Segredo compartilhado (HS256) — pelo menos 32 caracteres, armazenado de forma criptografada.

Cole um token de exemplo em Testar um token para verificá-lo antes de entrar em operação. Um token inválido ou expirado nunca falha o chat — o visitante é simplesmente tratado como anônimo.

2. Seu servidor MCP

Insira o endereço do seu servidor MCP (Streamable HTTP, tools/list e tools/call). Teste e Ao vivo têm seus próprios endereços e segredos de assinatura; Modo ativo escolhe qual deles a IA usa.

Clique em Criar para obter um segredo de assinatura. Ele é mostrado uma vez — armazene-o em seu servidor. Revogar o remove imediatamente (as chamadas nesse modo param até que você crie um novo).

Cada solicitação que a OrderInChat envia ao seu servidor carrega:

• X-OIC-Timestamp — segundos Unix
• X-OIC-Signature — v1= + hex HMAC-SHA256 de timestamp.body com seu segredo de assinatura
• X-OIC-User-Token — o token do usuário, inalterado (verifique você mesmo e retorne apenas os dados desse usuário)
• X-OIC-Mode — test ou live

Rejeite solicitações cuja assinatura não corresponda ou cujo timestamp seja mais antigo que 5 minutos. A OrderInChat não tem um endereço IP fixo, então use a assinatura em vez de uma lista de permissões de IP.

3. Ferramentas

Clique em Descobrir ferramentas para ler as ferramentas que seu servidor lista, depois ative as que a IA pode usar. Permita apenas ferramentas somente leitura. Ferramentas que aparecem depois começam desligadas até que você as ative.

• Chat de texto: uma chamada de ferramenta pode levar até 8 segundos.
• Chamadas de voz: até 3 segundos; o assistente diz um curto "deixe-me verificar" primeiro. Se seu servidor estiver lento, ele dirá que não conseguiu verificar no momento.
• O que suas ferramentas retornam é tratado apenas como dados, nunca como instruções, e não é salvo no histórico do chat.

4. Incorpore o widget

<script>
  window.OrderInChatSettings = {
    userToken: "",
    getUserToken: async () => (await fetch("/your/oic-token")).text(),
  };
</script>
<script src="https://app.orderinchat.com/widget/oic-widget.js" data-tenant-id="YOUR-STORE-ID"></script>

getUserToken é chamado quando o token está prestes a expirar. Após o carregamento do script, você também pode usar OrderInChat.setUserToken(token), OrderInChat.clearUserToken() (ao sair) e OrderInChat.onTokenRefresh(fn).

Com um token válido e o assistente de voz ativado, o cabeçalho do widget mostra um botão telefone. A chamada é realizada no widget e é cobrada a partir de créditos de IA como qualquer chamada de site (as chamadas de ferramentas estão incluídas na chamada). O áudio da chamada da web não é gravado.

Personalizar abre as configurações do widget em uma nova aba. A cada carregamento de página, o código lê a aparência do widget no OrderInChat (pelo data-tenant-id), então as alterações salvas lá valem na hora, sem colar o código de novo. É usado o perfil de widget definido para a sua vitrine (senão, o ativo ou o primeiro); nenhum perfil novo é criado.

5. Testar a conexão

Abaixo de Ferramentas, Testar a conexão executa verificações fixas no seu endereço MCP de Teste com o segredo de assinatura de teste. Nenhuma IA é usada e nada é salvo. Ele verifica se:

• o endereço é https público (não localhost nem um endereço de rede privada);
• um tools/list assinado corretamente funciona;
• uma requisição com assinatura errada é rejeitada;
• uma assinatura correta com carimbo de data/hora de mais de 5 minutos é rejeitada;
• tools/call em uma ferramenta ativada sem token do usuário retorna erro e nenhum dado;
• com um token de exemplo colado em Testar um token, tools/call funciona — e com que rapidez (mais de 2 segundos é lento demais para chamadas de voz; elas desistem após 3 segundos).

Só são chamadas ferramentas que você descobriu e ativou, com argumentos vazios; o token de exemplo é usado apenas nesse teste e nunca é salvo. Cada item com falha mostra como corrigir. Copiar resultados para seu desenvolvedor copia um relatório em inglês para colar ao seu desenvolvedor ou à IA dele; repita o teste até nada falhar.

O que sua equipe vê

• Caixa de Entrada → Web: o nome e o email do cliente do token, ou Usuário #ID quando você não envia nenhum. Cada resposta da IA mostra qual de suas ferramentas foi usada e se funcionou — nunca os dados.
• Caixa de Entrada → Chamadas: chamadas do widget aparecem sob Site da loja e em Ao vivo enquanto estão em execução; a transcrição mostra cada passo da ferramenta (nome e resultado apenas).
• Clientes: um cartão de cliente é criado ou reutilizado para cada ID de usuário (ID do usuário da loja), então chats e chamadas da mesma pessoa estão vinculados.