# CobMAIS

### Login Externo

##### Realiza o login na plataforma de agentes do Tallk.me. O método abre uma nova janela no navegador e realiza o login de maneira automática.

##### Endpoint: `https://agente.tallk.me/login`

Método: 🟡 POST

Parâmetros a serem passados via body:

• `login` -&gt; Número de login do agente.

• `password` -&gt; Senha do login do agente.

• `token` -&gt; Token para autenticação da requisição. Deve ser requisitado para a equipe de desenvolvimento/suporte.

```json
{
	"login" : "1234",
	"password" : "123456789",
	"token" : "ABCDEFGHIJKLM",
  	"externalLoginToken" : "QWERTYUIOPASDFGHJKLZXCVBNM"
}
```

Exemplo abaixo (utilizando um formulário html simples passando os dados via href):

[https://docs.tallk.me/s/WGbpNf9Z82FcDH](https://docs.tallk.me/s/WGbpNf9Z82FcDHD)

---

### Logout Externo

##### Força o logout de um agente na plataforma do Tallk.me. Se o agente estiver logado, a sessão é terminada e ele é levado à página principal.

##### Endpoint: `https://api-agente.tallk.me/api/external/logout`

Método: 🟡 POST

Parâmetros a serem passados via body:

• `login` -&gt; Número de login do agente.

• `password` -&gt; Senha do login do agente.

• `token` -&gt; Token para autenticação da requisição. Deve ser requisitado para a equipe de desenvolvimento/suporte.

```json
{
	"login" : "1234",
	"password" : "123456789",
	"token" : "ABCDEFGHIJKLM",
  	"externalLoginToken" : "QWERTYUIOPASDFGHJKLZXCVBNM"
}
```

---

### Pausar/despausar agente na fila

##### Altera o status do agente nas filas de ligação para pausado/ativo. 

##### Endpoint: `<a href="https://api-bc.tallk.me/tallkme-ui/integration/attendants/status">https://api-bc.tallk.me/tallkme-ui/integration/attendants/status</a>`

Método: 🟡 POST

Parâmetros a serem passados via body:

• externalLoginToken -&gt; Token para autenticação da requisição. Deve ser requisitado para a equipe de desenvolvimento/suporte.

• token -&gt; Token da conta do cliente.

• status -&gt; Status para alteração do agente. Aceita dois valores, sendo `S` para **ativo** e `N` para **pausado**.

```json
{
	"login" : "1234",
	"password" : "123456789",
	"token" : "ABCDEFGHIJKLM",
	"externalLoginToken" : "QWERTYUIOPASDFGHJKLZXCVBNM",
	"status" : "N"
}
```

---

### Obter gravação externa

##### Devolve um link público referente a uma gravação de chamada.

##### Endpoint: [https://api-bc.tallk.me/tallkme-ui/external/operational/fetchaudio/](https://api-bc.tallk.me/tallkme-ui/external/operational/fetchaudio/){**protocol**}

Método: 🟡 POST

Parâmetros a serem passados via query string **(substituir no endpoint)**:

• protocol -&gt; Número de protocolo da chamada

Parâmetros a serem passados via body:

• token -&gt; Token da conta do cliente

• externalLoginToken -&gt; Token para autenticação da requisição. Deve ser requisitado para a equipe de desenvolvimento/suporte.

```json
{
	"token" : "ABCDEFGHIJKLM",
	"externalLoginToken" : "QWERTYUIOPASDFGHJKLZXCVBNM"
}
```