# Transbordo Tech4Humans

Nesta página você irá encontrar um exemplo de configuração utilizando o ALTU Connector API para transbordo com a **Tech4Humans**.

## **INTEGRAÇÃO ALTU CONNECTOR**

Crie uma nova conexão no LiveChat no ALTU, na aba **Connect > Live Chats** &#x20;

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MaDgpgGc-ojynGHgdtR%2F-MaDhdkmi0cmMIPhpqHP%2Fimage.png?alt=media\&token=d822e741-bda8-4397-97c3-ecac9eed62fb)

Envie um email para **<suporte@tech4h.com.br>** solicitando o cadastro do webhook, para isso, precisaremos enviar no corpo do e-mail:

* **Chave de acesso:** gerado automaticamente pelo ALTU
* **Token de acesso:** gerado automaticamente pelo ALTU
* **ID da integração:** ID do livechat que acabou de ser criado, é o último parâmetro da URL
* **Instância do cliente:** a primeira parte da url, exemplo: community.altu.com.br

Esses dados podem ser encontrados no LiveChat criado, como na imagem abaixo

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkHk95ffst3MeU-7cNU%2F-MkIHA4n4ugAgqqpPr2r%2Ftech2.png?alt=media\&token=31e7bc67-2422-4717-9a63-606e64f28af0)

Após o envio, a tech irá nos informar o webhook ou o client\_id (um link ou token, respectivamente). Depois disso, basta incluir a URL recebida no campo Webhook da conexão LiveChat no ALTU:\
\
Exemplo da estrutura de um endpoint Webhook:

<https://api-messages.tech4h.com.br/channel/altu/receive/**{client\\_id}/{token> de acesso}\*\*

## **CONFIGURAÇÃO NO BUILDER**

No Builder devemos utilizar a ação de transferência do LiveChat, passando o ID da integração:&#x20;

Exemplo do nó de transbordo:

```
[
    {
        "name": "start_live_chat",
        "parameters": {
            "extra_info": {
                "matricula": "<? $matricula ?>",
                "data_nascimento": "<? $data_nascimento ?>"
            },
            "contact_info": {
                "matricula": "<? $matricula ?>",
                "data_nascimento": "<? $data_nascimento ?>"
            },
            
            "integration_id": 2
        },
        "result_variable": "tech4h_transfer_response"
    }
]
```

No contexto Tech4 Humans, temos uma **peculiaridade** no atributo `contact_info`

* **contact\_info** : informações extras do contato que ficam visíveis no Widget (ficha) do atendimento para o Agente e serão transformadas em relatório.
* **extraInfo** : informações extras da conversa que ficam visíveis no Widget (ficha) do atendimento para o Agente.

{% hint style="info" %}
Crie um nó com [input aberto](https://docs.altu.d1.cx/build/assistentes/builder/componentes/input/text_input) depois do nó de transbordo
{% endhint %}

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkHk95ffst3MeU-7cNU%2F-MkIHmUaV9ezLn4mvCRb%2Ftech3.png?alt=media\&token=4abab577-537b-4154-9824-f8d7b22e7b54)

Quando há transbordo o atendimento passa a ser encerrado pelo **agente** ou **usuário**.

É enviado uma notificação para o Assistente do ALTU e essa notificação vem pela variável  **input.live\_chat.status**, que é gerada automaticamente e pode ter os seguintes valores:

* **agent\_closed** (conversa fechada pelo agente)
* **user\_closed** (conversa fechada pelo cliente)
* **timeout** (chamada não atendida pelo agente)
* **user\_inactivity\_timeout** (quando o usuário não responde dentro do tempo definido)

Usamos esta variável, com seus respectivos valores de status, para criar uma condição no nó de encerramento do atendimento no Assistente e incluir, por exemplo, uma pesquisa de satisfação especifica para quando for finalizado pelo cliente e outra quando finalizado pelo agente.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkHk95ffst3MeU-7cNU%2F-MkII-isCkegbGi-8gLA%2Ftech4.png?alt=media\&token=6a71f89c-14f0-48e0-b112-b5f9a4b14713)

Caso queira adicionar uma mensagem de encerramento, para ser exibida quando atendimento for encerrado pelo agente ou usuário, ela deverá vir no `before_action_messages`, conforme  a imagem abaixo

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkHk95ffst3MeU-7cNU%2F-MkII2VfIuVpITwrYwkz%2FTech5.png?alt=media\&token=06dae6d0-140a-4975-978f-e8ae7f6973f3)

## **CONFIGURAÇÃO NA TECH 4 HUMANS**

**Acesse o painel da** [**Tech**](https://portal.tech4h.com.br/) **e preencha as credenciais para logar:**

* e-mail
* senha
* domínio da empresa **(instância/cliente)**

### **Configurar Habilidade**

Ao acessar, vá no menu lateral esquerdo, clique na opção :

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkHk95ffst3MeU-7cNU%2F-MkIIya2gntIp6g82QqP%2Ftech6.png?alt=media\&token=5ba69453-aebd-4730-bf9c-d4e9e136d402)

Nessa opção conseguiremos criar uma nova habilidade para um agente/usuário, clicando no botão **Adicionar habilidade** ou pesquisar por habilidades existentes na opção de **Buscar**.<br>

{% tabs %}
{% tab title="Exemplo" %}
Suponha que iremos criar uma nova habilidade, depois de clicar no botão para Adicionar

Aparecerá uma tela com vários campos a serem preenchidos.

**Obrigatórios:**

* **Nome:** nome da habilidade, especialidade do agente.
* **Tempo de inatividade:** tempo máximo em segundos que o cliente tem para responder o agente, caso contrário a conversa torna-se inativa. Geralmente usamos 300.
* **Peso da conversa ativa:** peso de conversa ativa, usado no cálculo de fila, entre 1 e 3, mas geralmente usamos 1.
* **Peso da conversa inativa:** peso de conversa inativa, usado no cálculo de fila, entre 1 e 3, mas geralmente usamos 1.
* **SLAs padrão:** tempo em segundos que o agente tem para responder o cliente, a cada nova mensagem, geralmente usamos 60
  * **first time SLA:** geralmente usamos 45.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkHk95ffst3MeU-7cNU%2F-MkIJ3LPjcOZ0mRenEBL%2Ftech7.png?alt=media\&token=4b071bde-b37b-476f-8f7f-b29126c2eb90)

Clique no botão **“confirmar”** para salvar a nova habilidade.

{% hint style="info" %}
Os campos com asterisco \* são obrigatórios e, ao passar o mouse em cima dos asteriscos, é possível ler o significado do campo.&#x20;
{% endhint %}
{% endtab %}
{% endtabs %}

### &#x20;**Configurar Canais**

Depois, no menu lateral esquerdo, clique em :

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkHk95ffst3MeU-7cNU%2F-MkIJ886cuaSQ-f6NtqF%2Ftech8.png?alt=media\&token=b67517ff-8ad8-452a-8e32-e62ae5e24dd8)

Nessa opção conseguiremos criar uma novo canal, para conectar-se à integração LiveChat no ALTU, clicando no botão **Adicionar canal** ou pesquisar por canais existentes na opção de **Buscar**.

{% tabs %}
{% tab title="Exemplo" %}
Suponha que iremos criar um novo canal, depois de clicar no botão para Adicionar, aparecerá uma tela com vários campos a serem preenchidos.&#x20;

Aparecerá uma tela com vários campos a serem preenchidos.

**Obrigatório:**

* **Nome:** nome do canal
* **Chave:**  token de acesso disponível na integração LiveChat no ALTU
* **Habilidade:** selecione uma habilidade disponível&#x20;
* **Canal:** selecione a opção “ALTU”
* **Id de integração:** Id da integração LiveChat no ALTU
* **Chave de acesso:** Chave de Acesso disponível na integração LiveChat no ALTU
* **Tamanho máximo da mensagem (caracteres):** Geralmente usamos 4096
* **Informações adicionais (JSON):** neste campo deve ter o JSON contendo a instância que está sendo usada na integração.

Exemplo do JSON: &#x20;

```
 {
       "instance": "community"
 }
```

Pronto, agora é só testar!

Lembre-se de conferir se o agente na Tech está online para começar o atendimento **😄**<br>

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkHk95ffst3MeU-7cNU%2F-MkIJRdKT38_hUqwouqf%2Ftech10.png?alt=media\&token=bf777556-af67-402c-80ee-2ce33357b901)
{% endtab %}
{% endtabs %}
