Review the inbound REST endpoint and configure inbound authentication

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 1 min. de leitura

    • After you install the Virtual Agent API, navigate to the Scripted REST API resource to review the endpoint and set up authentication.

    Antes de Iniciar

    Role required: admin

    Procedimento

    1. Navigate to All > System Web Services > Scripted Web Services > Scripted REST APIs.
    2. Select the VA Bot Integration record to open it.
    3. In the Resources tab, open the BOT Integration record.
    4. Review the inbound REST API resource details.

      The format is: https://<customer instance>/api/sn_va_as_service/bot/integration

      Review the Resource path value for the REST endpoint.

      For a description of the request parameters and an example send request, see Virtual Agent Bot Integration API.

    5. In the Security tab on the same page, select the Requires authentication check box.
      Select the Requires authentication check box.
    6. Set up Provider Authentication using any of these methods: Basic, OAuth, Hash, or Static Token.
      Nota:
      Guest usage via Basic or OAuth is already supported out-of-box when you select Requires authentication. To support user account linking, you must use Static or Hash token-based authentication. You can use token-based authentication (Static or Hash) with or without Basic or OAuth authentication. The token can be passed in either the request body or the header. If the token is specified in both places, the one in the header is accepted.
      Do one of the following:

    O que Fazer Depois

    If you are using Message Authentication, Configure Message Authentication for inbound communication.

    Configure the output response REST endpoint and outbound authentication for the Virtual Agent API.