# API channel

## Create/Edit an API channel

To connect an API channel in NovaTalks, select **API** as the channel type when creating a new Inbox. 

<figure><img src="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FLnGIZmONrvriUJX6rDnt%2Fimage.png?alt=media&#x26;token=35191428-50c7-4fba-be7a-b8f4d38b1d2b" alt=""><figcaption></figcaption></figure>

## Main settings

The main settings show an Inbox name, Chatbot, Webhook URL, Conversation type, and Write first to a new client option.

<figure><img src="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FkqPhgV33MQVjM2CW21wm%2Fimage.png?alt=media&#x26;token=d5e67ba5-92c4-450a-ba08-449af27f5737" alt=""><figcaption></figcaption></figure>

1. **Inbox name**
2. **Chatbot** - a chatbot connected to a channel (Setting up in the [Chatbots](https://help.novatalks.com.ua/en/get-started/settings/chatbots)).
3. **Webhook URL** - webhook URL used to connect messengers.
4. **Conversation type** - a type of inbox from which a customer contacts you. Namely: Chat, Social Media, Email or Call.
5. **Can write first to a new client** - this feature allows agents to initiate contact (write/call) with new customers.
6. **Channel for writing first to a new client -** an option to select a preferred channel for contacting first new customers.

{% hint style="warning" %}
You can write to a new client via WhatsApp, Whatsapp Business API or Telegram. Only one messenger can be connected to one inbox.
{% endhint %}

***

## Configure conversation handling

<figure><img src="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FBbYl6iJ2h8uYCylZR3AE%2Fimage.png?alt=media&#x26;token=81c948ab-8196-4f35-8301-634020472b87" alt=""><figcaption></figcaption></figure>

1. **Utilization, %** - an indicator that shows how much a certain dialogue utilizes an agent. Possible values: 0 - 100.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>Depending on the value of this parameter, the current utilization of an agent is calculated (the sum of the utilization of dialogs assigned to this agent). </p><p>When automatically distributing dialogs, an agent utilization should not exceed 100%. </p><p>Therefore, the lower the utilization value of a dialog assigned to a team, the more dialogs can be automatically distributed to an agent and vice versa.</p></div>

2. **Auto Assignment Limit** - the maximum number of simultaneous conversations an agent can handle within a given Team and Conversation type. Once this limit is reached, ACD will no longer assign similar dialogues to that agent.

3. **Auto Answer** is the option that determines if a dialog is accepted automatically when assigned to an agent.

4. **Alerting Timeout** - the duration an agent has to accept or reject a conversation. If an agent does not respond within this time, the conversation returns to the beginning of the queue, and the agent's status changes to Busy substatus Not responding.

The option is available only if the Auto Answer option is disabled.&#x20;

5. **Wrap-up codes** - special codes used to categorize dialogs with customers. They are selected by an agent after resolving a conversation.&#x20;
6. **Wrap-Up Timeout (sec)** - the time limit for selecting a Wrap-up code. If an agent does not react within the specified time, a conversation resolves, and the Wrap-up code is not set.

***

## Agents <a href="#agents" id="agents"></a>

The list of agents included in an Inbox.

<figure><img src="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FSV9vY77B9Ba27U8J79Vh%2Fimage.png?alt=media&#x26;token=a6410be5-59aa-4ab5-b4ec-9fbf7f0bc586" alt=""><figcaption></figcaption></figure>

***

### View and create a channel

Steps to view the settings of a new channel and confirm its creation.

<figure><img src="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FOEW1lakzVL8acebCafzb%2Fimage.png?alt=media&#x26;token=49368bd0-aa14-4e64-addd-46c17876d1f9" alt=""><figcaption></figcaption></figure>


---

# 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://help.novatalks.com.ua/en/get-started/settings/inboxes/api.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.