> For the complete documentation index, see [llms.txt](https://docs-conversational-ai.syntphony.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-conversational-ai.syntphony.com/getting-started/login.md).

# Login

Learn how to access Syntphony Conversational AI for the first time and securely log in to the platform.

Access **Syntphony Conversational AI** using your registered account. Whether you are signing in for the first time or returning to the platform, follow the steps below to securely access the Organizations, Environments, and Projects available to you.

## First Access

When a new user is registered, an email is sent to the registered email address with the information required to access Syntphony Conversational AI.

The email includes:

* A direct link to your Enterprise account
* Your **Organization** name
* Your registered email address
* A temporary password.

To set your password, use the link provided in the email. The link can be used once and remains valid for up to 24 hours. If it expires, you can request a new link from the same page.

***

## Log into the Platform

Go to your Enterprise login page and enter your **Organization** name. Then, provide the credentials associated with your account to continue.

Once authenticated, the content available to you depends on the access and permissions assigned to your user.

#### Understanding the platform structure

Syntphony Conversational AI is organized into three main levels:

<table><thead><tr><th width="258.5379638671875">Level</th><th>What it represents</th></tr></thead><tbody><tr><td><strong>Organization</strong></td><td>The highest level of the platform, bringing together your company's Environments and users.</td></tr><tr><td><strong>Environment</strong></td><td>A space within the Organization that groups Conversational Projects and defines access to them.</td></tr><tr><td><strong>Conversational Project</strong></td><td>The workspace where conversational experiences are built and configured using the resources available in Syntphony Conversational AI.</td></tr></tbody></table>

After logging in, select an **Environment** you have access to. From there, you can access the available **Conversational Projects** or create a new one, according to your permissions.

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FZcfn5u6w35X6m6nWBuBj%2FCaptura%20de%20Tela%202026-10-20%20a%CC%80s%2015.29.24.png?alt=media&amp;token=3ff60bcc-0c27-443b-87cb-5e24b0277eae" alt="Login Page"><figcaption><p>Login Page</p></figcaption></figure>

***

## Login with OpenID

f your Organization uses **Microsoft Entra ID** for authentication, use your organization's OpenID account to log in.

Your user must also be registered in Syntphony Conversational AI. If you do not have access, contact your Organization Admin.

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2Fa7xrA7NVBRtdi8iiqra5%2Fad1.png?alt=media&amp;token=79d6213d-7304-4aa5-9c14-2649eb44c8bb" alt="" width="375"><figcaption><p>Choose an account or create a new one</p></figcaption></figure>

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FuagDDTghzsXVqa20nV92%2Fad2.png?alt=media&amp;token=9e57c8cc-ebda-489f-8a73-99affc692e15" alt="" width="375"><figcaption><p>Inform your Microsoft account (email, phone or Skype)</p></figcaption></figure>

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FTiU84ld6NI3U3D6Sl4hb%2Fimage.png?alt=media&amp;token=7d5cca4a-027e-4372-b8cf-be8a5d4a8038" alt="" width="375"><figcaption><p>Accept the terms</p></figcaption></figure>

### Setting up a Microsoft Entra ID

To to set up your Azure Account with Microsoft Entra ID (Active Directory new name)​ in Syntphony Conversational AI, you'll need to provide the following information:

* "clientId"
* "authorizationUrl"
* "tokenUrl"
* "clientSecret"
* Email of one of the Admin users

Follow the steps below to find the information you'll need to provide:

1. Access the [**Azure Portal**](https://portal.azure.com/).

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FDUCtAH48bkE7mNAnZ0EY%2Fimage.png?alt=media&amp;token=ee25d61c-51ca-4b60-ac6a-b286835666ce" alt=""><figcaption></figcaption></figure>

2. Once you're in Azure Entra ID, choose the option **App registrations​**.

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FZRncXNKvM7wCl2sewm0b%2Fimage.png?alt=media&amp;token=825d49e9-2c71-48c3-ab88-76fcb9f58e82" alt=""><figcaption></figcaption></figure>

3. Then, click in **New registrations**.​

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FKQha85aYwQkt9qoMA21c%2Fimage.png?alt=media&amp;token=7cc7941a-9188-4a38-9884-1febbf8b5379" alt=""><figcaption></figcaption></figure>

4. Enter the application name.

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FycUphNX1gnD5bxrNHIFU%2Fimage.png?alt=media&amp;token=ec8ca402-7ad6-4bb6-9cfb-603b2609324f" alt=""><figcaption></figcaption></figure>

5. Choose Web to Redirect URI and insert the redirect URI from keycloak​ with the format: {keycloakHost}/auth/realms/{realm}/broker/oidcAD/endpoint​

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FzpEEFWF77aKikuqAgUFm%2Fimage.png?alt=media&amp;token=fb064171-4d20-4653-a718-34de53946fab" alt=""><figcaption></figcaption></figure>

6. Now you can get the necessary data from the application:​

<div><figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FslOXyvWF254OHwpD4aLE%2Fimage.png?alt=media&amp;token=7f846f81-29b0-499a-9a52-96b26ecdcafa" alt=""><figcaption><p>Application (Client) ID</p></figcaption></figure> <figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FRb4aj3V9bVmHiTgaFPN9%2Fimage.png?alt=media&amp;token=f630eb36-99cb-46c3-a6e5-c24ae69e796c" alt=""><figcaption><p>Copy the two first endpoints</p></figcaption></figure> <figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FkozY0ed1Gj2ktR8GPlAh%2Fimage.png?alt=media&amp;token=fd4f8915-c102-4744-859e-1d332bed5656" alt=""><figcaption><p>Inside Certificates &#x26; secrets, click <strong>New cliente secret​.</strong></p></figcaption></figure></div>

Remember to enter a description and then choose when the secret expires​.

<div><figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2Fkhdm52HbKMF7A8um0Tcs%2Fimage.png?alt=media&amp;token=c9795738-6f25-4330-ba8d-43a8aae68b02" alt=""><figcaption><p>Set expiration date</p></figcaption></figure> <figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2Fh8tUAdpVTDlT4fEAOuLy%2Fimage.png?alt=media&amp;token=474da5c7-3cdd-43cf-a7d3-8a6009402bcc" alt=""><figcaption><p>Copy the secret value ​</p></figcaption></figure></div>

***

## Supported Browsers

For a better experience, we recommend using the latest versions of Google Chrome or Microsoft Edge.&#x20;

{% hint style="info" %}
**Note:** Internet Explorer and access via mobile devices are not supported.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs-conversational-ai.syntphony.com/getting-started/login.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
