{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21621,"path":"integrate-applications/integration-hub/ssetup-alexa.md","title":"Set up the Amazon Alexa spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Set up the Amazon Alexa spoke\n\nIntegrate the ServiceNow instance and Amazon Alexa account by creating a custom OAuth application in Amazon Alexa to authenticate ServiceNow requests.\n\n## Before you begin\n\n-   Request an Integration Hub subscription.\n-   Activate the Amazon Alexa spoke.\n-   Role required: admin\n\n## Create a security profile\n\nCreate and register a security profile through the Developer Console to use Login with Amazon on your ServiceNow instance.\n\n### Before you begin\n\nRole required: admin.\n\n### Procedure\n\n1.  Log in to [Amazon Developer Portal](https://developer.amazon.com/) with admin credentials.\n\n2.  Create a security profile.\n\n    For information about creating a security profile, see [Create an LwA Security Profile](https://developer.amazon.com/docs/dash/create-a-security-profile.html) in [Amazon Developer Documentation](https://developer.amazon.com/documentation).\n\n3.  Copy and record the values of Client ID and Client Secret for later use.\n\n4.  Configure the security profile and specify these values in **Web Settings**:\n\n    |Field|Value|\n    |-----|-----|\n    |Allowed Origins|ServiceNow instance URL.|\n    |Allowed Return URLs|ServiceNow instance redirect URL in this format: `https://<Instance-Name>.com/oauth_redirect.do`|\n\n    For more information about configuring the security policy, see [Add your Website to your Security Profile](https://developer.amazon.com/docs/login-with-amazon/register-web.html#add-your-website-to-your-security-profile) in [Amazon Developer Documentation](https://developer.amazon.com/documentation).\n\n\n## Configure a connection for Amazon Alexa spoke\n\nAdd and configure a Amazon Alexa connection to authenticate ServiceNow requests in the Amazon Alexa spoke.\n\n### Before you begin\n\nRole required: admin\n\n### Procedure\n\n1.  Navigate to **All** &gt; **Process Automation** &gt; **Workflow Studio**.\n\n2.  Click the **Integrations** tab.\n\n3.  Under **Connections**, the **Outbound** connections are displayed by default.\n\n4.  Locate the **AmazonAlexa** connection alias and click **View Details**.\n\n5.  On the **Connection** form, fill in the fields.\n\n    |Field|Description|\n    |-----|-----------|\n    |Connection Information|\n    |Connection Name|Name to uniquely identify the record. By default, the name is `AmazonAlexa`.|\n    |Connection URL|Base URL to connect to Amazon Alexa. Enter: `https://api.amazonalexa.com`|\n    |API Version|Required API version of Amazon Alexa. Enter `v1`.|\n    |Credential Information|\n    |OAuth Entity Name|Name to identify the OAuth entity record. For example, `Amazon Alexa OAuth`.|\n    |OAuth Client ID|Client ID created during the configuration of the security profile.|\n    |OAuth Client Secret|Client Secret created during the configuration of the security profile.|\n    |OAuth Redirect URL|OAuth callback endpoint in this format: `https://<instance>.service-now.com/oauth_redirect.do`. Replace `<instance>` with the ServiceNow instance name.|\n\n6.  Click **Configure and Get OAuth Token**.\n\n\n## Setup webhook for the Amazon Alexa spoke\n\nAuthenticate the inbound requests from Amazon Alexa account to your ServiceNow instance by creating a webhook registry.\n\n### Before you begin\n\nRole required: admin.\n\n### Procedure\n\n1.  In the filter navigator, enter `token_verification.list`.\n\n    Records in the Token Verifications \\[token\\_verification\\] table are displayed.\n\n2.  Click **New**.\n\n3.  On the form, fill these values.\n\n    |Field|Description|\n    |-----|-----------|\n    |Name|Name to identify the token record. For example, `Alexa token`.|\n    |Description|Brief description of the token.|\n    |Token|Value of token. This value is encrypted before it is used.|\n\n4.  Click **Submit**.\n\n5.  Navigate to **Alexa Webhooks** &gt; **Alexa Webhook Registries**.\n\n6.  Click **New**.\n\n7.  On the form, fill these values.\n\n    |Field|Description|\n    |-----|-----------|\n    |Name|Name to identify the webhook registry record. For example, `Alexa token`.|\n    |Description|Brief description of the webhook registry record.|\n    |Token|Token you have created. For example, `Alexa token`.|\n    |Path|Scripted REST endpoint. A default endpoint is available. You can change the default value as per your requirement.|\n\n8.  Right-click the form header and click **Save**.\n\n9.  Click **Callback URL**.\n\n    Webhook Callback URL is displayed in the confirmation message. Copy and record this value.\n\n10. Log in to [AWS Management Console](https://aws.amazon.com/console/).\n\n11. In the AWS Lambda function, specify the Webhook Callback URL and save the changes.\n\n    \\[Omitted image \"alexa-url.png\"\\] Alt text: Webhook Callback URL\n\n12. Log in to [Alexa Developer Console](https://developer.amazon.com/alexa/console/ask).\n\n13. Navigate to **Build** &gt; **CUSTOM** &gt; **Endpoint** and specify ARN of the AWS Lambda function you had configured.\n\n    \\[Omitted image \"alexa-lambda-arn.png\"\\] Alt text: AWS Lambda ARN\n\n\n"}}