Resultado
Um Procedimento publicado tem resultado verificado e ações sensíveis continuam sob aprovação ou transferência para um atendente.
Criar um Procedimento
Abra Configurações > IA > Procedimentos e escolha um modelo ou crie um Procedimento a partir do registro de ações compatíveis. Deixe explícitos o gatilho, a Caixa de entrada ou o público e o escopo da ação.
Salve primeiro como rascunho. Rascunhos não são executados e não alteram uma versão publicada existente.
Executar um teste simulado antes de publicar
- Escolha uma conversa sintética ou já segura no painel de teste do Procedimento.
- Confira cada condição, ação planejada e resultado da aprovação. Um teste simulado não envia mensagem ao cliente nem executa alteração no provedor.
- Corrija destinos de Caixa de entrada ausentes, condições inválidas ou bloqueios de segurança e execute o teste novamente até o resultado esperado aparecer.
Estruturar e testar um resultado de API personalizada
Depois de testar com segurança uma operação GET de leitura habilitada, abra Editar operação e vá para Resposta. O layout guiado transforma a saída tipada mapeada em um registro único ou em uma lista de registros legível pelo cliente. Somente candidatos seguros da resposta testada são oferecidos.
Defina uma etiqueta de resultado em cada idioma compatível, escolha um título e, opcionalmente, um campo de subtítulo, selecione até 32 campos seguros e defina o número máximo de registros da lista. Veja a prévia em cada idioma antes de salvar. Valores, datas e status usam suas regras de exibição tipadas. Status desconhecidos e campos ausentes continuam indisponíveis em vez de serem inventados.
Use a ação Testar da operação de leitura com dados de teste seguros. A resposta analisada mostra campos tipados, caminhos aninhados e valores sensíveis ocultos.
Escolha Editar operação > Resposta, selecione Registro único ou Lista de registros e defina a etiqueta, o título, o subtítulo opcional e os campos visíveis. Para uma lista, defina de 1 a 100 registros.
Revise a prévia localizada, escolha Usar este layout e depois Salvar como rascunho. A resposta avançada continua sendo uma prévia JSON técnica limitada: não é uma solicitação editável nem executa uma mutação.
- A exibição para o cliente aceita campos de texto de suporte, número, sim ou não, valor, data e status da resposta mapeada.
- As listas ficam limitadas a 100 registros e 32 campos. A interface mostra um aviso parcial quando o provedor retorna somente parte do resultado.
- Se a resposta estiver vazia, malformada ou um campo estiver indisponível, mostre indisponível e corrija o mapeamento ou transfira o caso em vez de adivinhar.
Proteger uma alteração de API personalizada
Para uma alteração de API personalizada confirmada pelo cliente, adicione opcionalmente uma condição de mutação. Ela pode ler somente uma saída de texto e compará-la ao valor esperado exato. Um valor ausente, diferente ou indisponível transfere o caso para uma pessoa e não chama a mutação.
Toda alteração externa ainda exige confirmação do cliente. Alterações protegidas ou sensíveis sempre precisam da aprovação de um colega. Um teste de leitura nunca ignora essas proteções.
Publicar e verificar o resultado em execução
Publique somente depois de entender o teste simulado. Um Procedimento publicado é versionado. Rascunhos posteriores não substituem a versão ativa até que você os publique.
Execute um teste controlado em produção e confirme a execução concluída no histórico do Procedimento. A Central de configuração usa essa execução bem-sucedida como evidência de que a ação publicada pode ser executada, e não apenas salva.
Ações de faturamento, conta, privacidade, jurídico, segurança, abuso e clientes irritados continuam exigindo aprovação ou transferência para uma pessoa. Nunca enfraqueça essa política para fazer um teste passar.