# Integração Omnichannel - Opa! Suite

## Introdução

>[!TIP] **Definição - Opa! Suite:**
> O [Opa! Suite](https://opasuite.com.br/) é uma plataforma de atendimento ao cliente que unifica todos os seus canais de comunicação em um só lugar. Isso significa que você pode gerenciar suas interações com os clientes, de forma multicanal, mas através de uma única interface.

A integração entre o sistema IXC Soft e o sistema Opa! Suite tem como objetivo otimizar ferramentas de comunicação e usabilidade.

Esta integração permite o envio de mensagens através do canal de comunicação de WhatsApp e também carregar uma dashboard com informações detalhadas sobre um cliente específico a partir do cadastro do cliente no sistema IXC Soft.

> [!NOTA] **Acesso ao Formulário**
> **Caminho:** Configurações > Integrações > Integrações Omnichannel

### Requisitos de Uso
- Credenciamento junto à plataforma Opa! Suite;
- Dados de integração fornecidos pelo Opa! Suite (geração do token de acesso API).

### Entrega de valor
- Permite a [[abrir o dashboard do cliente no opa! suite|abertura da dashboard do cliente no Opa]], através do IXC, promovendo acesso rápido às informações do cliente, como o histórico de atendimentos; 
- Permite o envio de cobranças por mensagens omnichannel, utilizando os [[parametros de cobranca|Parâmetros de Cobrança]];
- Gerencia a fila de mensagens do Omnichannel;

## Conceitos Fundamentais

 >[!TIP] Definições:
 >- **Gateway Omnichannel**: Interface que permite a comunicação entre o sistema Opa!Suite e a plataforma Omnichannel;
 >- **Dashboard do Cliente**: Painel visual que apresenta informações consolidadas sobre um cliente específico;
 >- **Fila de Mensagens**: Sistema de gerenciamento de mensagens recebidas e enviadas pelo Omnichannel.

## Estrutura do Formulário
O formulário **Integração Omnichannel** consiste em uma grid que reúne todos os cadastros de integrações de canais Omnichannel. Além da grid, o formulário permite o cadastro, edição e exclusão de uma integração e está estruturado nos seguintes campos:

| **Campo**                     | **Descrição**                                                    |
| ----------------------------- | ---------------------------------------------------------------- |
| **ID**                        | Número identificador único para o gateway omnichannel.           |
| **Descrição**                 | Descrição textual do gateway omnichannel.                        |
| **Gateway**                   | Seleção do tipo de gateway omnichannel utilizado.                |
| **URL**                       | Endereço URL da API do gateway omnichannel.                      |
| **Token**                     | Token de autenticação para acesso à API do gateway.              |
| **Utiliza fila de mensagens** | Indicação se o gateway vai utilizar fila de mensagens (Sim/Não). |

## Configuração da Integração do Opa! Suite no IXC Provedor

### Passo 1: Geração do Token de Acesso no Opa! Suite
O token de acesso é um método de autenticação necessário para operar a API do Opa! Suite através do IXC Provedor. 

>[!TIP] **Token:**
Um token tem a função de proporcionar segurança na transferência de dados, garantindo que os dados fornecidos sejam encaminhados somente a solicitantes autenticados, funcionando como uma espécie de senha. Desta forma, os usuários terão acesso somente aos dados necessários para manipular aplicações.

Para gerar um token de acesso no Opa!Suite, é necessário configurar um **perfil de permissão**. Siga as seguintes etapas:

1. Acesse **Menu** na plataforma **Opa! Suite**;
2. Em seguida, siga em **Configurações**;
3. Clique em **Permissões**;
4. Clique no botão laranja com **sinal de mais (+)**, localizado na parte inferior direita do formulário de **permissões**, para criar um novo perfil de permissão;

>[!INFO] Perfil de permissão:
>O perfil de permissão tem como objetivo definir quais dados da plataforma a API terá permissão de manipular.

5. No perfil de permissão, selecione **API** no parâmetro **Tipo de permissão**;
6. Defina um usuário para gerar o token e acesse-o, através do caminho **Menu > Usuários**;
7. Selecione o usuário e clique em **Editar**;
8. No cadastro do usuário, na aba Dados, marque o parâmetro **Permitir acesso API**;
9. Em seguida, acesse a aba **API**. No campo **Grupo de permissões**, selecione o grupo de permissão criado anteriormente e clique em **Salvar**. O token será gerado automaticamente. Copie o token e armazene-o em um bloco de notas para ser cadastrado no IXC Provedor.

>[!Caution] Atenção:
>Certifique-se de que o usuário de acesso ao Opa! Suite tenha o mesmo e-mail de acesso ao sistema IXC Soft para ocorrer a comunicação adequada desta função.

### Passo 2: Liberação de Permissão
Para o uso da integração, é necessária a liberação da permissão **Dashboard cliente** no **perfil de permissão** que o usuário do Opa! Suite encontra-se vinculado. Siga os passos abaixo:

1. No Opa! Suite, acesse **Menu** e selecione **Configurações**;
2. Clique no botão **Permissões** e edite o perfil de permissão que o usuário está vinculado;
3. No perfil de permissão, localize a opção **Dashboard cliente** e marque-a;
4. Clique em **Salvar** para validar as modificações.


### Passo 3: Configuração no Sistema
Para realizar a configuração do Opa! Suite no IXC Provedor, siga as etapas a seguir:

1. Acesse o formulário de [[integracoes omnichannel|Integrações Omnichannel]] através do caminho: Menu Configurações > Integrações > **Integrações Omnichannel**;
2. Clique no botão **Novo**;
3. Preencha os campos: 
   - **Descrição:** insira uma breve descrição da integração, exemplo: IXC - OPA;
   - **URL:** preencha com a sua URL de acesso ao Opa! Suite;
   - **Gateway:** selecione a opção Opa! Suite;
   - **Token**: insira o token gerado no Opa! Suite;
   
> [!INFO] **Atenção:** 
> A URL deve ser inserida baseada na máscara: **https://dominioopasuite.com.br/api/v1.** É necessário retirar o final **"/atendente"** para ocorrer a comunicação entre IXC Provedor e Opa! Suite.

4. Clique em **Salvar** para estabelecer a comunicação entre as duas plataformas;

### Passo 4: Parametrização Padrão no Sistema
Após realizar o cadastro da integração no sistema, será necessário parametrizar este canal como padrão, para isto, siga as seguintes etapas:

1. Acesse o formulário de [[formulario parametros gerais|Formulário Parâmetros Gerais]] através do caminho: Configurações >Parâmetros > Parâmetros Gerais;
4. Acesse a [[aba integracoes - formulario de parametros gerais|Aba Integrações - Formulário de Parâmetros gerais]];
5. No campo **Integração Opa! Suite,** clique sobre a lupa e preencha com a integração cadastrada;
6. Clique em **Salvar** para validar as alterações e concluir a integração.

Após concluir os passos descritos, a integração estará pronta para uso, disponibilizando as funcionalidades de [[abrir o dashboard do cliente no opa! suite|Abrir o dashboard do cliente no Opa! Suite]] e de [[rotina de cobranca com opa! suite|Rotina de cobrança com Opa! Suite]].


## Casos de Uso

### Atendimento de cobrança automatizado através da [[rotina de cobranca com opa! suite|Rotina de cobrança com Opa! Suite]]

1. O sistema identifica automaticamente clientes com faturas vencidas pelos parâmetros de cobrança;
2. Através da integração e parametrização da rotina de cobrança com o Opa, um chamado é aberto no Opa! Suite a partir do envio de template;
3. O Opa! Suite inicia uma sequência de contatos automatizados;
4. O atendente do provedor recebe notificações sobre as interações no chat do Opa!Suite;
5. Todas as ações são registradas no histórico do chat.

Este processo reduz o tempo de cobrança e aumenta a eficiência do setor financeiro.

### Abertura de Dashboard do Cliente no Opa! Suite
A [[abrir o dashboard do cliente no opa! suite|abertura do dashboard do cliente no Opa! Suite]] é um recurso que permite aos atendentes acessar rapidamente informações relevantes do cliente diretamente na plataforma de atendimento, sem necessidade de alternar entre sistemas.

1. O operador identifica um cliente para visualizar seu histórico de atendimentos;
2. O operador acessa o cadastro deste cliente diretamente no IXC;
3. No cadastro do cliente, ao lado do campo **ID**, o operador clica sobre o botão **Opa! Suite** para acessar o dashboard deste cliente diretamente no Opa;
4. É aberta uma nova página no navegador com o direcionamento para a dashboard do cliente no Opa, possibilitando a visualização do histórico de atendimentos do cliente.


## Fluxo de Trabalho

```mermaid
graph TD
    A[Início] --> B[Geração do token no Opa!Suite]
    B --> C[Configuração no IXC]
    C --> D[Cadastrar a integração e inserir token e URL do Opa!Suite]
    D --> E[Parametrização geral no IXC]
    E --> F[Salvar configurações]
    F --> G[Integração pronta para uso]
    G --> H[Abrir dashboard do cliente no Opa! Suite]
    G --> I[Utilizar rotina de cobrança com o Opa! Suite]
```

## Considerações Finais
A integração entre Opa! Suite e o sistema IXC Soft oferece uma solução robusta para gerenciamento de comunicações e cobranças, melhorando significativamente a eficiência operacional.

## Etiquetas
#Integracao #IntegracaoOmnichannel #RotinaDeCobranca #AbrirDashboardOpa #OpaSuite

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes omnichannel|Integrações Omnichannel]]
- [[logs omnichannel|Logs Omnichannel]]
- [[parametros de cobranca|Parâmetros de Cobrança]]
- [[rotina de cobranca com opa! suite|Rotina de cobrança com Opa! Suite]]
- [[abrir o dashboard do cliente no opa! suite|Abrir o dashboard do cliente no Opa! Suite]]