{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":4845,"path":"conversational-interfaces/virtual-agent/configure-send-request.md","title":"Review the inbound REST endpoint and configure inbound authentication","bundle":null,"doc_type":null,"release":"australia","body":"\n# Review the inbound REST endpoint and configure inbound authentication\n\nAfter you install the Virtual Agent API, navigate to the Scripted REST API resource to review the endpoint and set up authentication.\n\n## Before you begin\n\nRole required: admin\n\n## Procedure\n\n1.  Navigate to **All** > **System Web Services** > **Scripted Web Services** > **Scripted REST APIs**.\n\n2.  Select the **VA Bot Integration** record to open it.\n\n3.  In the **Resources** tab, open the **BOT Integration** record.\n\n4.  Review the inbound REST API resource details.\n\n    The format is: https://<customer instance>/api/sn\\_va\\_as\\_service/bot/integration\n\n    \\[Omitted image \"scripted-rest-api-endpoint.png\"\\] Alt text: Review the Resource path value for the REST endpoint.\n\n    For a description of the request parameters and an example send request, see [Virtual Agent Bot Integration API](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/bot-api.md).\n\n5.  In the **Security** tab on the same page, select the **Requires authentication** check box.\n\n    \\[Omitted image \"scripted-rest-api-botinteg-brand2.0.png\"\\] Alt text: Select the Requires authentication check box.\n\n6.  Set up Provider Authentication using any of these methods: Basic, OAuth, Hash, or Static Token.\n\n    **Note:** 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.\n\n    Do one of the following:\n\n    -   Set up Basic or OAuth authentication.\n\n        To learn more about OAuth authentication and the possible security configurations for scripted REST APIs, see [Enable OAuth with inbound REST](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/t_EnableOAuthWithREST.md).\n\n    -   Set up Message Authentication, which involves configuring either Static or Hash tokens, setting up Provider Authentication, and setting the channel identity. For details, see [Configure Message Authentication for inbound communication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/set-up-message-auth-va-api.md).\n\n## What to do next\n\nIf you're using Message Authentication, [Configure Message Authentication for inbound communication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/set-up-message-auth-va-api.md).\n\n.\n\n-   **[Configure Message Authentication for inbound communication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/set-up-message-auth-va-api.md)**  \nYou can configure Message Authentication for the Virtual Agent API instead of Basic or OAuth. Message Authentication involves configuring either Static or Hash tokens, setting up Provider Authentication, and setting the channel identity.\n\n**Parent Topic:**[Configuring Virtual Agent API](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/configure-virtual-agent-api.md)\n\n"}}