# Account Linking Setup

### Part 1: Enable Account Linking in ixHello Portal <a href="#toc40147921" id="toc40147921"></a>

Assumptions: To complete account linking you need to have set up an account in the ixHello and created an app in the ixHello portal. To learn how to set up apps in the ixHello platform you can follow this [documentation](/ixhc/general/use-cases/contact-finder-with-rest-api.md).

1. Login to ixHello portal at [https://bots.ixhello.com](https://bots.ixhello.com/).
2. On the menu go to Apps -> Custom Apps. Click on the App for which you need to setup Account Linking. If you do not have any apps ready, you can follow [this](/ixhc/general/use-cases/contact-finder-with-rest-api/build-custom-app.md) document to create app in ixHello

<figure><img src="/files/cOaOioLsbS5R8lYrRZyk" alt=""><figcaption></figcaption></figure>

1. After the App has been selected, following screen with all components of the app will display. Click on the Publish tab.

<figure><img src="/files/nTN4NlqlGTMsorzigsNX" alt=""><figcaption></figcaption></figure>

1. On the publishing tab, Create Publish Profile (if not already created), fill out other details and click the Enable Account Linking check box and click save. As the Note says, “When this option is selected, it is still required to configure account linking in Alexa”, there are few additional steps we need to configure in Alexa developer console.&#x20;

<figure><img src="/files/kHW7T8VcnQ0mwTHl0IEY" alt=""><figcaption></figcaption></figure>

1. Before heading to Alexa developer console, save this publish profile and publish to Alexa. You can again follow [this](https://docs.voiceworx.ai/skills/custom-skill-with-publishing-to-alex-contact-finder) document for assistance in publishing to Alexa.

<figure><img src="/files/6XO1UfHFOMivbkXDbIk8" alt=""><figcaption></figcaption></figure>

![](/files/LAYmWmLtJFercNzny0mH)

Once you click "Publish to Alexa", you will see the below screen, update the necessary details and click on Publish to Alexa.

<figure><img src="/files/HqDENLjvrAC0LObCxRf5" alt=""><figcaption></figcaption></figure>

Once you publish the skill to Alexa, you will see the success message as below:

<figure><img src="/files/71ZgkXXNaG8J7jXrCrOt" alt=""><figcaption></figcaption></figure>

Click on "Go to Alexa Skill", you will be redirected to Alexa Developer Console as below,

<figure><img src="/files/Vr1ZWpOiFc8LnLS6kyvL" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PKiHApRInZX71aeqKQtj" alt=""><figcaption></figcaption></figure>

### Part 2: Login with Amazon to create Security Profile

1. Go to <https://developer.amazon.com> and login with the same Amazon Account the app has been published to in step 5. Click on Developer Console.

<figure><img src="/files/JjyxecnJclnva45AjGFd" alt=""><figcaption></figcaption></figure>

2. On the resulting screen, Click on "Login with Amazon".

<figure><img src="/files/H2abJbQ64yaB1MYgq0cs" alt=""><figcaption></figcaption></figure>

3. Login with Amazon Console page would open in a new tab. Click the “Create a New Security Profile” button.

<figure><img src="/files/PLWHQTrLjiRSi9jJGSYZ" alt=""><figcaption></figcaption></figure>

4. Fill all the required fields in the Security Profile Management page and click the Save button.

<figure><img src="/files/uLZvWEIowcQL8U0bVxu7" alt=""><figcaption></figcaption></figure>

5. Security Profile is successfully created. Click the gear icon and click on web settings

<figure><img src="/files/1SzKJ4RQWbE6NvQw01O5" alt=""><figcaption></figcaption></figure>

6. In the web settings page, fill the following fields as shown below and click the “Save” button.

Allowed Origins -

* [https://bots.ixhello.com](https://bots.ixhello.com/)

Allowed Return URLs

* [https://bots.ixhello.com/oauthCode/redirect](https://bots.ixhello.com/OAuthCode/Redirect)

<figure><img src="/files/CZPuvNRY6LwuCA7NoU5P" alt=""><figcaption></figcaption></figure>

7. Note the Client ID and Client Secret from Step 11 for later use.

<figure><img src="/files/823yYrOe2ir4lntnDfll" alt=""><figcaption></figcaption></figure>

### Part 3: Link Your Skill

1. Go <https://developer.amazon.com/alexa/console/ask> and select the skill that needs account linking

<figure><img src="/files/LMiSecN4XvdXHBqwRveK" alt=""><figcaption></figcaption></figure>

2. Select Models tab

<figure><img src="/files/bSiQmgk7EvvSwAkzruVv" alt=""><figcaption></figcaption></figure>

3. Click on the Account Linking Tab

<figure><img src="/files/Fjk6PvunRRLvPU2H8IYK" alt=""><figcaption></figcaption></figure>

4. In the resulting page enable account linking by clicking the “Do you allow users to create an account or link to an existing account with you?” toggle and click Save

!\[Graphical user interface, text, application, website

Description automatically generated]\(/files/ql24XLk3rD14uwzNTzgh)

5. Set Auth Grant as the authorization type and fill in the following.

* Your Web Authorization URI: <https://www.amazon.com/ap/oa>
* Access Token URI: <https://api.amazon.com/auth/o2/token>
* Your client ID: This is the client Id shown in the security profile created in step 10 above. Example- amzn1.application-oa2-client.2ec922f2fbfa435433892
* Your Secret: Click on show secret in the Security Profile page as shown in step 10. Copy and paste the secret here
* Your Authentication Scheme: Http Basic
* Scope: Click on add new Scope and type in “profile”
* Domain List: channeltest.voiceworx.ai, channel.voiceworx.ai
* Default Token Expiration Time : 80420
* Alexa Redirect URLs:&#x20;

<https://alexa.amazon.co.jp/api/skill/link/M278T3HJB37YPD>

<https://pitangui.amazon.com/api/skill/link/M278T3HJB37YPD>

<https://layla.amazon.com/api/skill/link/M278T3HJB37YPD>                                                                                                           &#x20;

<figure><img src="/files/lC9UOVIyg3yMfdaL5FPQ" alt=""><figcaption></figcaption></figure>

*Note: You also need to add these Redirect URLs to your Allowed Return URLs in your Amazon Security Profile.*

<figure><img src="/files/yQSfYKVmWm7AmRdPlEG5" alt=""><figcaption></figcaption></figure>

* Scroll up and click save.

![](/files/VHxuLjr0pu2dhyeOcu1N)

Once saved you will see the below screen:

<figure><img src="/files/HrYdBqLTYQGdQhWdsA1h" alt=""><figcaption></figcaption></figure>

1. Go to [http://alexa.amazon.co](https://developer.amazon.com/alexa/console/ask/build/custom/amzn1.ask.skill.ae51ab1e-ff75-45ef-a3bd-20ab1a0f15e4/development/en_US/dashboard)m, login and click on Skills

<figure><img src="/files/g4E21UTW9YG9kuWTWvE2" alt="" width="563"><figcaption></figcaption></figure>

!\[Graphical user interface, text, application

Description automatically generated]\(/files/v9i3cv7sSxxHN5jB1Ihh)

1. On the Skills page, click on the Your Skills button

!\[Graphical user interface, background pattern

Description automatically generated]\(/files/WnlISZ4Zp7F2Hh4XG5Kt)

1. Search the name of the skill you want to enable account linking on. Select the skill.
2. Click on Enable Skill
3. This will open the Login with Amazon page. Insert your username and password and press login
4. If your login details are correct, you will be presented with a success screen.
5. You can now try invoking the skill from your Alexa device and Alexa developer console.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ixhello.com/ixhc/apps/account-linking-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.