> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/connect/canais/bot_api.md).

# Bot API

O bot API é um serviço que permite iniciar atendimentos com integração por meio de uma API. 

## Configurações

Adicione uma nova API com as seguintes informações:

![](/files/-MRyV8m8MuRFFYyOr437)

* **Nome:** nome que deseja para a API
* **Assistente:** selecione o assistente >adicionar o link da página de assistentes da doc<
* **Squad:** selecione o nome da squad se estiver disponível na lista, caso contrário mantenha como “geral”

Após criar, acesse sua área de edição para configurar algumas opções:

![](/files/-MRyVlwDISy6xfRlz57_)

O processo assíncrono é utilizado na V2, nesta temos a possibilidade de configurar um callback, que é o endpoint informado na tela de configuração da API que irá receber a resposta do assistente após uma requisição com input.

<mark style="color:green;">`POST`</mark> `https://connector.ms.altubots.com/<slug>/api/<id_integracao>`

#### Headers

| Name                                            | Type   | Description      |
| ----------------------------------------------- | ------ | ---------------- |
| Content-Type:<mark style="color:red;">\*</mark> | string | application/json |

#### Request Body

| Name                                            | Type   | Description          |
| ----------------------------------------------- | ------ | -------------------- |
| Authorization<mark style="color:red;">\*</mark> | string | token gerado no ALTU |

{% tabs %}
{% tab title="200 " %}

```
{
    "code": 200,
    "message": "Message sent."
}
```

{% endtab %}

{% tab title="400 " %}

```
{
    "code": 400,
    "message": "Bad request: body"
}
```

{% endtab %}

{% tab title="401 " %}

```
{
    "code": 401,
    "message": "Unauthorized."
}
```

{% endtab %}

{% tab title="404 " %}

```
{
    "code": 404,
    "message": "Client not found."
}
```

{% endtab %}

{% tab title="500 " %}

```
{
    "code": 500,
    "message": "Unexpected Error."
}
```

{% endtab %}
{% endtabs %}

#### **Body:**

```
{
    "input": {
        "text": "Olá"
    },
    "identifier": "{identificador_do_contato}",
    "context": {
        "var1": "value1",
        "var2": "value2"
    }
}
```

Para obter o contexto é necessário marcar a opção "Incluir contexto do atendimento na resposta", disponível na tela de configuração da API.

#### **Header:**

```
Content-Type: application/json
Authorization: <token autogerado pelo ALTU> 
```

{% hint style="info" %}
Para que o POST no *callback* seja realizado, é **obrigatório** informar tanto a `URL` quanto o `Token`.
{% endhint %}

![](/files/-MRy_BhrAV3ctzaH1Zfd)