Identidade e autorização em agentes de voz: consulta de dados pessoais
Coloque autorização no serviço externo e use o prompt para conduzir a verificação.
- Autoria
- Equipe Tigy AI
- Publicado
- Atualizado
Identificar um chamador significa saber quem solicita; autorizar significa permitir uma operação específica sobre um recurso. Um nome, número de telefone ou código de pedido informado na conversa não comprova ambos. Em agentes de voz do Tigy AI, as instruções conduzem as perguntas e respeitam a recusa; a integração externa deve validar a identidade e o acesso antes de devolver dados ou executar uma alteração.
Classifique a informação
Separe informações públicas, estado de uma solicitação e dados pessoais. Defina quais campos podem ser devolvidos após cada verificação. Para um pedido, pode bastar uma situação resumida sem endereço, documentos ou histórico completo.
Projete a validação no destino
Seu serviço deve validar identidade e escopo antes de retornar dados. Vincule a autorização ao recurso permitido e ao contexto confirmado pelo mecanismo externo. Uma credencial técnica da ferramenta autentica o serviço; ela não comprova a identidade do chamador.
Escreva as instruções do agente
Peça só a referência necessária e explique a etapa autorizada de verificação. Use a ferramenta configurada após os dados exigidos. Se o retorno negar acesso, diga que não foi possível verificar e ofereça o canal aprovado; não tente contornar a recusa mudando o pedido.
Reduza o retorno da ferramenta
Retorne estados claros, como autorizado, não verificado ou indisponível, e apenas os campos liberados. Não devolva segredos, tokens de sessão ou detalhes que ajudem alguém a descobrir uma conta. A política exata depende do sistema externo e de sua equipe responsável.
Teste recusas reais
Use dados fictícios para testar um pedido autorizado, um pedido de outra pessoa, uma autorização vencida e um serviço indisponível. Peça ao responsável pela integração que confira quais informações o sistema enviou e compare-as com a fala do agente. Dados restritos não devem aparecer mesmo quando a pessoa insiste.
Por que uma credencial da ferramenta não identifica o chamador?
A chave usada pela ferramenta permite que a conexão acesse o serviço. Ela não comprova que a pessoa ao telefone pode ver todos os cadastros disponíveis nesse serviço. O sistema responsável deve conferir quem é o chamador e qual informação ou alteração ele está autorizado a solicitar.
Em um exemplo fictício, a ferramenta tem acesso técnico aos pedidos da loja, mas o chamador só está autorizado para DEMO-71. Consultar DEMO-17 deve ser recusado sem expor seus dados. Teste esse par com registros sintéticos e confira o corpo da resposta, além da recusa falada.
Separe localizar uma pessoa de permitir uma operação
Identificar um cadastro e autorizar acesso são decisões diferentes. Um número de telefone, nome ou referência pode ajudar a encontrar um registro, mas não comprova sozinho que o interlocutor pode consultar todos os seus dados ou alterá-los. O procedimento precisa definir qual evidência é suficiente para cada operação. Uma dúvida pública pode dispensar verificação; uma consulta individual ou mudança de cadastro pode exigir critérios adicionais.
Em uma loja fictícia, um número permite localizar o pedido, mas o sistema ainda precisa conferir se o chamador pode acessá-lo. Saber esse número não comprova que a compra é dele. Combine quais dados o agente pede e peça ao responsável pela integração que confira o acesso antes de fornecer informações.
Não peça mais dados apenas para criar uma sensação de segurança. Defina quais informações o sistema realmente confere. Perguntas que não participam dessa verificação dificultam o atendimento e recolhem dados sem necessidade. Prefira um procedimento aprovado e verificável para cada tipo de ação.
Escreva separadamente os resultados: cadastro localizado, verificação concluída e operação permitida. Essa distinção ajuda o agente a interpretar o retorno sem saltar etapas. Se a verificação falha, explique a alternativa prevista, sem revelar detalhes que a pessoa ainda não pode acessar. Se o cadastro não é encontrado, informe a impossibilidade de localizar com os dados fornecidos, sem afirmar que aquela pessoa não é cliente. A resposta deve representar o que o sistema conseguiu estabelecer.
Trate contexto inicial como informação, não como permissão universal
Contexto disponível antes da conversa pode reduzir repetição e ajudar a localizar a necessidade. Ele não deve ser tratado como autorização universal. Um identificador enviado pelo canal de chamada pode ter alcance específico, e uma variável preenchida pode estar incorreta ou desatualizada. A integração deve definir como esse contexto se relaciona com a identidade verificada e quais operações ele permite executar.
Em um exemplo fictício, a chamada chega com uma referência de conta, mas a pessoa explica que está ligando por outra unidade. O agente pode ouvir a correção e entender o pedido. Isso não significa que a nova referência se tornou autorizada só porque foi mencionada. O sistema deve aplicar a verificação correspondente. Usar a conta inicial para uma unidade diferente pode devolver informação errada; aceitar qualquer correção como permissão pode ampliar acesso indevidamente.
Separe identificação de preferência. A pessoa pode mudar o horário desejado sem mudar a identidade verificada. Peça ao responsável pela conexão que confira se o agente consegue consultar apenas o cadastro autorizado. A chave que conecta os sistemas não deve permitir escolher livremente qualquer cliente.
Teste contexto ausente, referência inválida, número de origem desconhecido e pessoa que diz representar outro cliente. O resultado esperado deve ser decidido pela operação. O agente pode continuar oferecendo informações públicas e uma saída legítima quando a consulta individual não é permitida. Preservar utilidade não exige abrir o acesso; exige explicar o limite e executar apenas o que está autorizado naquele estado da conversa.
Faça o servidor verificar a relação entre identidade e recurso
As instruções orientam o agente, mas o sistema que fornece ou altera dados precisa controlar o acesso de verdade. Peça ao responsável pela integração que confira se um pedido de outra pessoa será recusado, mesmo se o agente escolher o cadastro errado. Uma confirmação verbal sozinha não protege informações individuais.
Considere um sistema fictício em que duas contas possuem pedidos com referências próximas. A ferramenta deve verificar a compra solicitada dentro do alcance autorizado, em vez de devolver qualquer pedido encontrado pelo número. Se o identificador muda depois de uma correção, a verificação deve acompanhar o novo recurso. Não basta validar a pessoa uma vez e permitir que todo identificador posterior seja consultado sem relação com aquela validação.
Limite os campos retornados à tarefa. Uma consulta de estado não precisa fornecer dados completos de pagamento ou informações de outros contatos. A resposta deve conter o necessário para orientar o cliente e um estado claro para o agente. Reduzir o retorno também torna a interpretação mais simples. Se uma ferramenta devolve muitos detalhes não relacionados, aumenta a possibilidade de uma resposta excessiva ou de circulação desnecessária em resumos.
Para alterações, valide também a ação e o estado atual. Permissão para consultar não implica permissão para escrever. Um pedido já encerrado pode não aceitar determinada mudança. A integração deve devolver um resultado que diferencie sucesso, rejeição e pendência. O agente precisa comunicar esse estado com precisão, sem insistir em outra ferramenta para contornar a recusa. A autorização deve permanecer válida mesmo quando o cliente muda a forma de pedir, exige urgência ou afirma que outra pessoa já aprovou.
Teste acesso permitido e acesso proibido em pares
Uma verificação de autorização precisa incluir casos em que o atendimento deve funcionar e casos em que deve ser bloqueado. Testar apenas a conta correta mostra utilidade, mas não mostra isolamento. Testar apenas pedidos proibidos pode produzir um agente que recusa tudo. Para cada operação, prepare um par com o mesmo tipo de pedido e uma diferença relevante na identidade ou no recurso.
Em uma consulta fictícia de pedido, o primeiro caso usa a conta autorizada e a referência correspondente. O segundo tenta consultar pedido de outra conta. Inclua também referência corrigida, pessoa ligando por terceiro e contexto que não corresponde ao pedido. O resultado esperado deve indicar o que o servidor devolve e o que o agente pode dizer. Uma recusa verbal não basta se a ferramenta já recebeu ou expôs os dados indevidos.
Para escrita, teste alteração permitida, alteração de outro cadastro e tentativa após mudança de estado. Confira o registro externo para saber se houve gravação. O agente pode dizer que não conseguiu executar enquanto o sistema realizou a ação, ou anunciar sucesso sem nenhuma mudança. Esses desencontros mostram por que a avaliação precisa de evidência da integração além da transcrição.
Registre as instruções, a configuração da ferramenta e o cenário de teste. Depois de uma correção, repita tanto o pedido permitido quanto o proibido. Mudanças na conexão ou nos acessos exigem nova conferência. Não esconda uma divulgação indevida em uma média de acerto: o cliente autorizado deve ser atendido e o pedido sobre outra pessoa deve ser recusado.
Mantenha uma saída útil quando a verificação não basta
Quando o agente não consegue autorizar uma consulta, ele ainda pode explicar informações públicas e o procedimento real para obter atendimento. A mensagem deve delimitar o problema sem revelar dados protegidos. “Não consegui verificar o acesso necessário para consultar esse pedido” informa o limite; enumerar detalhes da conta para ajudar a pessoa a adivinhar respostas pode ampliar a exposição que a verificação deveria evitar.
Defina com a operação o caminho para casos legítimos que não conseguem concluir a etapa. Pode ser um canal específico, uma revisão humana ou outro procedimento aprovado. A alternativa deve existir e não pode transformar uma alegação de urgência em autorização automática. O agente pode acolher a dificuldade sem executar a ação bloqueada. A continuidade serve para resolver o caso pelo processo adequado, não para contornar a regra.
Se a integração estiver indisponível, diferencie falha técnica de verificação recusada. O cliente pode estar autorizado, mas o sistema não conseguiu confirmar. Explique a impossibilidade de verificar naquele momento e ofereça o caminho existente. Não anuncie que a pessoa não tem permissão se a consulta simplesmente não respondeu. Essa distinção também ajuda a equipe responsável a investigar o tipo correto de problema.
Na revisão operacional, acompanhe pedidos autorizados que exigiram nova coleta, falhas técnicas e tentativas fora do escopo. Separe as categorias e preserve evidência mínima para investigar. Se um procedimento gera bloqueios desnecessários, revise-o com o responsável pelo acesso, em vez de ensinar o agente a ignorá-lo. O resultado esperado é uma fronteira clara: informação pública acessível, consulta individual com verificação e alteração somente com permissão adequada. Dentro dessa fronteira, o agente pode ser cordial, objetivo e útil mesmo quando precisa explicar que não consegue confirmar uma ação.
