Configurar várias aplicações do provedor

Você pode configurar várias aplicações de provedor para oferecer suporte a agentes de IA em que há vários bots primários usando Virtual Agent API e você precisa distinguir entre eles.

Antes de Iniciar

Função necessária: administrador

Verifique se você está no escopo da aplicação Virtual Agent API.

Procedimento

1. Navegar até Tudo > sys_cs_provider_application.
2. Clique em Novo para criar uma nova aplicação do provedor.
3. No formulário, preencha os campos.

   Campo	Descrição
   Nome	Nome da aplicação do provedor, como Bot personalizado da API do VA.
   Provedor	Selecione o provedor como Provedor de bot para bot do VA.
   ID de entrada	ID de entrada exclusivo usado na mensagem de solicitação, por exemplo, custom_1.
   Autenticação de mensagem	Configurar autenticação de mensagem com um token para comunicação de entrada. Consulte Configurar autenticação de mensagem para comunicação de entrada para obter mais detalhes.

4. Clique em Enviar.
5. Navegar até Tudo > Serviços web do sistema > Mensagem REST.
6. Clique em Novo para criar um novo registro de Mensagem de REST.
7. No registro de Mensagem de REST, preencha os campos do formulário.

   Campo	Descrição
   Nome	Nome do registro da Mensagem de REST. Deve ser igual à aplicação do provedor recém-criada.
   Endpoint	O endpoint de resposta do bot primário.

8. Clique em Enviar.
9. Na seção Métodos HTTP, clique em Novo para criar um novo método ou substitua o método GET padrão.

   Campo	Descrição
   Nome	Nome do método HTTP. Insira postMessage.
   Método HTTP	Selecione PUBLICAR.
   Endpoint	Insira o endpoint de resposta do bot primário.
   Tipo de Autenticação	Configure a autenticação Básica ou OAuth 2.0 de acordo com seus requisitos. Para obter detalhes sobre como configurar a autenticação básica, consulte Configurar uma mensagem REST com autenticação básica. Para obter informações sobre como configurar o OAuth 2.0, consulte Configurar uma mensagem REST com OAuth.

10. Para usar a aplicação do provedor recém-criada, passe o ID de entrada da aplicação do provedor no parâmetro appInboundId da solicitação Virtual Agent API.
    Você precisa passar o ID de entrada da aplicação do provedor no parâmetro appInboundId para cada solicitaçãoVirtual Agent API. A seguir está um exemplo de solicitação Virtual Agent API que usa a aplicação do provedor recém-criada.

    
    {
        "userId": "adminuser1",
        "emailId": "[e-mail]",
        "action": "START_CONVERSATION",
        "message": {
            "text": "",
            "typed": true
        },
        "appInboundId": "custom_1",
        "contextVariables": {
            "app_name": "test"
        }
    }
    

    Você pode testar a configuração exibindo os logs de HTTP de saída para verificar se o endpoint de resposta foi acionado.