---
sourceDocument: Interfaces conversacionais de Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais de Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Configure a Autenticação de mensagem para comunicação de entrada

# Configure a Autenticação de mensagem para comunicação de entrada {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Você pode configurar a Autenticação de mensagem para Virtual AgentAPI em vez de Básica ou OAuth. A autenticação de mensagem envolve a configuração de tokens estáticos ou de hash, a configuração da autenticação do provedor e a definição da identidade do canal.

## Antes de Iniciar

Siga as etapas em [Revise o endpoint REST de entrada e configure a autenticação de entrada](https://servicenow-prod.fluidtopics.net/oxZ2GnMEPMHrPdf0zTOwBA "Depois de instalar o. Virtual AgentAPI, navegue até o recurso REST API com script para revisar o endpoint e configurar a autenticação.").

Função necessária: administrador

## Procedimento

1. Configure o token seguindo um destes procedimentos, dependendo do tipo de token:
   * Token estático:
     1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">token_verification.list </kbd>no filtro.
     2. Clique em Novo.
     3. No formulário Verificações de token, preencha os campos.  
        {#set-up-message-auth-va-api__table_lml_hbq_kqb__entry__2}

        | Campo | Descrição |
        |-|-|
        | Nome | Nome do token de autenticação, como <kbd class="ph userinput">B2BTestAppAuthToken </kbd>. |
        | Descrição | Descrição do token de autenticação, como <kbd class="ph userinput">Token de autenticação da aplicação de teste B2B </kbd>. |
        | Token | Insira um token de autenticação gerado usando qualquer linguagem geral de programação ou script ou clique em Gerar token seguro Nos links relacionados. |
        [ ]

        {#set-up-message-auth-va-api__table_lml_hbq_kqb}
     4. Clique em Enviar.
     {#set-up-message-auth-va-api__ol_m4d_kcx_v4b}
   * Token de hash:
     1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">hash_message_verification.list </kbd>no filtro.
     2. Clique em Novo.
     3. No formulário Verificação de mensagem de hash, preencha os campos.  
        {#set-up-message-auth-va-api__table_zwd_nbq_kqb__entry__2}

        | Campos | Descrição |
        |-|-|
        | Nome | Nome do token de autenticação, como <kbd class="ph userinput">B2BTestAppAuthToken </kbd>. |
        | Descrição | Descrição do token de autenticação, como <kbd class="ph userinput">Token de autenticação da aplicação de teste B2B </kbd>. |
        | Segredo | Token de autenticação (cadeia de caracteres aleatória). |
        [ ]

        {#set-up-message-auth-va-api__table_zwd_nbq_kqb}
     4. Clique em Enviar.
     {#set-up-message-auth-va-api__ol_o4d_kcx_v4b}
2. Configure a Autenticação do provedor para autenticação baseada em token.
   1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">message_auth.list </kbd>no filtro.
   2. Clique em Novo.
   3. No formulário Autorizações de mensagem, preencha os campos.  
      {#set-up-message-auth-va-api__table_ujp_1dp_kqb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Nome | Nome da autenticação da mensagem, como <kbd class="ph userinput">Token de autenticação B2B </kbd>. |
      | Provedor | Nome do provedor. |
      | Nome do grupo | Não obrigatório. |
      | Portal de serviços | Não obrigatório. |
      | Verificação de mensagem de entrada | Selecione o token estático ou o token de mensagem de hash que você criou. |
      | Criação de mensagem de saída | No momento, este campo não é compatível com Virtual AgentAPI. Selecione o token estático ou o token de mensagem de hash que você criou. |
      | Token de serviço de saída | No momento, este campo não é compatível com Virtual AgentAPI. |
      [ ]

      {#set-up-message-auth-va-api__table_ujp_1dp_kqb}
   4. Clique em Enviar.
   {#set-up-message-auth-va-api__substeps_pqj_dqv_4tb}
3. Defina a identidade do canal.
   1. Navegue até Todos e, em seguida, insira <kbd class="ph userinput">sys_cs_provider_application.list </kbd>no filtro.
   2. Selecione Bot do VA para aplicação do provedor de bot registre para abri-lo.
   3. No formulário Identidade do canal do provedor, localize Autenticação de mensagem e selecione a autenticação de mensagem que você configurou anteriormente.  
   4. Clique em Atualizar.
   {#set-up-message-auth-va-api__substeps_wnh_hqv_4tb}
4. Somente para autenticação baseada em token de hash, envie o. assinatura-b2b-x nos cabeçalhos da solicitação.  
   O valor é HmacSHA1valor codificado da carga de solicitação, que usa o token criado no ServiceNowinstância. Por exemplo, no Postman, siga estas etapas:
   1. Em Cabeçalhos, defina assinatura-b2b-x para `(HashValue) `.  
   2. Na área Script de pré-solicitação, defina o token da seguinte forma:  

          pm.environment.set('hashValue', CryptoJS.HmacSHA1(JSON.stringify(JSON.parse(request.data)), '<insert your token>').toString(CryptoJS.enc.Hex));

   {#set-up-message-auth-va-api__substeps_aj4_4rv_4tb}

## O que Fazer Depois

[Configure o endpoint REST da resposta de saída e a autenticação de saída para o. Virtual AgentAPI](https://servicenow-prod.fluidtopics.net/7Y3WK~W3_WewJTajdTPLMQ "Especifique o URL do endpoint de saída para o qual Virtual Agentas respostas foram publicadas. Configure a autenticação de saída.")