Pular para o conteúdo
Acesso antecipado: o Ray vai responder com o conhecimento que cada empresa publicar. Solicitar acesso

Conexão com a APIEm desenvolvimento

Respostas com os dados de cada cliente, somente para leitura

Se a empresa tiver a própria API, o Ray vai poder consultá-la para responder com o status real de um pedido, um plano ou uma reserva. Só para clientes com identidade assinada pela empresa, sempre somente para leitura e com cada consulta registrada para a equipe.

Acesso antecipado com acompanhamento da equipe. O Ray está em desenvolvimento.

Exemplo ilustrativo do chat do site com sessão iniciada: o cliente pergunta se o pedido já saiu e o Ray responde com a data de saída, a entrega estimada, o caminho para acompanhar e a hora do dado.

Exemplo ilustrativo com dados fictícios. Lumora é uma marca fictícia.

Antes e depois

A mesma pergunta, com e sem a conexão

Sem a conexão, o Ray vai responder com o conhecimento publicado. Com ela, vai responder sobre o caso do cliente. Nos dois casos o cliente vai receber uma resposta redigida, sem fontes nem dados brutos.

Exemplo ilustrativo em três painéis. Sem a conexão, o Ray explica o prazo geral de um reembolso e o caminho para ver o status. Com a conexão, o Ray informa que o reembolso do pedido 10482 foi aprovado, a data máxima de crédito e a hora do dado. No console, a equipe vê a identidade verificada, a consulta somente leitura, os nomes dos campos devolvidos e a fonte do prazo.

Exemplo ilustrativo com dados fictícios. Lumora é uma marca fictícia.

O que é consultado

Um conjunto fechado de consultas somente leitura

A empresa vai escolher quais consultas habilitar, entre operações definidas e revisadas com a equipe do Ray. O Ray não vai montar pedidos livres à API: cada consulta vai ter campos fixos e não vai levar nenhum dado do cliente como parâmetro.

  • Comércio eletrônico

    Status de um pedido, de uma entrega ou de um reembolso.

  • SaaS

    Plano atual, próxima fatura e status da conta.

  • Viagens

    Status de uma reserva e de uma mudança de data.

  • Serviços financeiros e iGaming

    Status de um saque ou de um depósito, e status da conta.

Exemplos de consultas possíveis. Cada conexão vai ser definida e revisada com a empresa antes de ser ativada.

Sem identidade assinada, não haverá dados da conta

O servidor da empresa vai assinar uma identidade de curta duração para o cliente que fez login. Qualquer falha vai deixar o cliente como anônimo: o chat vai continuar, só com o conhecimento publicado.

Ver como a identidade é assinada

Dois casos: com assinatura válida, o cliente vai ficar identificado e o Ray vai poder usar as consultas habilitadas sobre a conta dele; sem assinatura, vencida ou de outra empresa, o cliente vai ser anônimo e o Ray vai responder só com o conhecimento.

Assinatura válidaCliente identificadoO Ray vai poder usar as consultas habilitadas, só sobre a conta desse cliente. A identidade vai vir da assinatura, nunca do que for escrito no chat.
Sem assinatura, vencida, reutilizada ou de outra empresaCliente anônimoO Ray vai responder só com o conhecimento publicado e não vai fazer nenhuma consulta. Um número de pedido escrito no chat nunca vai bastar para ver dados.

Ferramentas por agente

O Administrador vai decidir o que cada agente consulta

Cada agente vai usar só as consultas que o Administrador atribuir a ele, dentro das que a conexão habilitar. Um agente sem ferramentas vai responder só com o conhecimento.

  • Só o Administrador

    Só quem tem o papel de Administrador vai poder atribuir ou remover ferramentas, e isso vai ficar no histórico do agente.
  • Por marca

    O agente de uma marca vai poder consultar pedidos e o de outra, só o conhecimento.
  • À vista na Caixa de entrada

    A equipe vai ver qual agente atendeu cada conversa e quais consultas fez.

Exemplo ilustrativo das ferramentas do agente Lumora Hogar: status de um pedido e de uma entrega ativados, status de um reembolso desativado, todas somente leitura.

Exemplo ilustrativo com dados fictícios. Lumora é uma marca fictícia.

Dados mínimos e falhas seguras

O suficiente para responder, e um registro de cada consulta

O Ray vai pedir só o que a resposta precisar, vai dizer a que horas o dado corresponde e, se a API falhar, vai continuar ajudando sem inventar.

  • O mínimo necessário

    Cada consulta vai devolver só os campos que a resposta precisar. Nomes, documentos e dados de pagamento nunca vão chegar ao Ray.

  • Com a hora do dado

    Se um dado estiver incompleto ou desatualizado, o Ray vai deixar isso claro ou passar a conversa para uma pessoa.

  • Registro de cada consulta

    Conversa, consulta, resultado e campos devolvidos, sem os valores. O registro não vai ser reescrito.

  • Falhas seguras

    Cada consulta vai ter um tempo limite. Sem resposta da API, o Ray vai responder com o conhecimento ou passar para uma pessoa com um rascunho.

Exemplo ilustrativo do registro de consultas: uma consulta concluída com quatro campos, um pedido não encontrado em que o Ray pediu o número correto e uma consulta sem resposta que passou para uma pessoa com um rascunho.

Exemplo ilustrativo com dados fictícios. Lumora é uma marca fictícia.

Status

O que está em desenvolvimento e o que vem depois

A identidade assinada e o conector somente leitura estão sendo construídos e testados localmente, com dados fictícios.

  • Em desenvolvimento

    Identidade assinada e conector somente leitura

    Testados com uma loja de teste e clientes fictícios, com registro de cada consulta e falhas seguras.

  • Em breve

    Conectar a API real de uma empresa

    Depois de uma revisão de segurança independente e dos requisitos de proteção de dados.

Para automatizar a configuração pelo terminal ou por um assistente próprio: CLI e MCP.

Revisar quais dados conectar com a equipe do Ray

Uma conversa curta com a equipe que constrói o Ray para analisar o caso da empresa: consultas frequentes, conhecimento existente, temas sensíveis e plano de migração.