> 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/messaging/administration.md).

# Administration

The Admin page is essential for maintaining system operations. It allows users to:

* [Configure sources](#source-configuration) (phone numbers and Syntphony CAI agents integration) 
* [Web widget configuration](#web-widget-setup)
* [User management](#user-management): Create and manage user accounts and assign roles efficiently.

Let's go through them below.

## Source Configuration

Set up the sources (channels) for sending messages. 

{% tabs %}
{% tab title="Step 1 - Phone" %}
First, configure your phone number filling the required fields.

<figure><img src="/files/hNktjKIdC473L3zGswUB" alt="" width="342"><figcaption><p>Phone numer configuration</p></figcaption></figure>
{% endtab %}

{% tab title="Step 2 - Agents" %}
Next, configure the AI agent. To connect with Syntphony Conversational AI you just have to provide:

* Organization name, UUID, and keycloak.
* Environment ID, key and password.
* And finally the agent and channel ID

<figure><img src="/files/jkhXvOo4GcBcart424sm" alt="" width="367"><figcaption><p>SCAI (formerly known as eva) configuration</p></figcaption></figure>
{% endtab %}

{% tab title="Step 3 - Source" %}
Once both are set up, connect them as a source on the Source page. Name the source, inform the channel and the agent. This creates a unified messaging experience where all your communication channels work together seamlessly.&#x20;

<figure><img src="/files/cvT8RzXV5bmSVLXoBefb" alt="" width="345"><figcaption><p>Source configuration</p></figcaption></figure>
{% endtab %}
{% endtabs %}

## Widget configuration

Adding a chat widget to your website, app, and mobile channels has become even easier. Now, you can customize the widget's appearance with a few clicks, preview its look, and publish it seamlessly.

The platform enables you to create a personalized webchat configuration that matches your brand identity, ensuring a dynamic user experience.&#x20;

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

After you complete setting up, you'll get a custom widget code, simply copy the generated script into your HTML to easily integrate it into your website or app.

## User management

Effortlessly add new team members and control what they can access. Create custom roles with specific permissions for different platform sections, giving you complete flexibility in managing your team. Each role you create determines exactly what users see and do within the platform, ensuring everyone has the right level of access for their responsibilities.

<figure><img src="/files/74CO5OwK6HzTM98dwyol" alt=""><figcaption><p>Roles management</p></figcaption></figure>


---

# 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 dynamically by asking a question.

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

```
GET https://docs-conversational-ai.syntphony.com/messaging/administration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.