> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/configuracao/canais/connectionhub.md).

# ConnectionHub

### Visão geral

O **ConnectionHub** é uma estrutura de integração usada pelo DigitalSac para conectar canais externos de forma centralizada.

No sistema, esse canal aparece internamente com o tipo:

```
connectionhub
```

Além do tipo principal, existem canais específicos relacionados ao ConnectionHub, como:

```
ch-facebook
ch-instagram
ch-email
```

Esses tipos representam integrações conectadas através do hub.

***

### Para que serve

O ConnectionHub permite centralizar canais externos dentro do DigitalSac.

Com ele, é possível:

* Receber mensagens de canais integrados
* Enviar respostas pelo DigitalSac
* Criar tickets automaticamente
* Trabalhar com filas
* Controlar permissões por usuário
* Registrar histórico de atendimento
* Usar automações
* Integrar canais como Facebook, Instagram e E-mail

***

### Como funciona

O ConnectionHub atua como uma camada de conexão entre o canal externo e o DigitalSac.

Fluxo básico:

```
Cliente envia mensagem em um canal externo.
O ConnectionHub recebe o evento.
O evento é enviado ao DigitalSac.
O sistema identifica ou cria o contato.
Um ticket é criado ou atualizado.
O atendimento aparece para a equipe.
O atendente responde pelo DigitalSac.
A resposta retorna ao canal de origem pelo ConnectionHub.
```

***

### Tipos relacionados

O projeto possui tipos específicos relacionados ao ConnectionHub:

```
connectionhub
Canal base do hub.

ch-facebook
Facebook conectado via ConnectionHub.

ch-instagram
Instagram conectado via ConnectionHub.

ch-email
E-mail conectado via ConnectionHub.
```

***

### Cadastro do canal

No cadastro de canais via ConnectionHub, normalmente são configurados:

* Nome do canal
* Tipo do canal
* Identificador externo
* Token ou credencial
* Status
* Fila vinculada
* Configurações de webhook
* Configurações do provedor
* Permissões de acesso

Exemplo:

```
Nome do canal: Hub Atendimento
Tipo: ConnectionHub
Fila: Atendimento Geral
```

***

### Relação com filas

O ConnectionHub pode direcionar atendimentos para filas.

Exemplo:

```
Canal: ConnectionHub
Fila: Atendimento Geral
```

Os tickets recebidos pelo hub entram na fila configurada ou seguem o fluxo definido no sistema.

***

### Relação com usuários

O acesso aos atendimentos do ConnectionHub depende das permissões do usuário.

Exemplo:

```
Usuário: Carla
Canal permitido: ConnectionHub
Fila: Atendimento Geral
```

Resultado:

```
Carla poderá responder os tickets recebidos por canais conectados ao hub, conforme suas permissões.
```

***

### Quando usar ConnectionHub

O ConnectionHub é indicado quando a empresa deseja integrar canais externos de forma centralizada.

É útil para:

* Facebook
* Instagram
* E-mail
* Canais integrados por hub
* Operações multicanal
* Centralização de atendimento
* Organizações com vários canais digitais

***

### Boas práticas

Recomenda-se:

1. Identificar claramente cada canal conectado ao hub.
2. Separar canais por nome e finalidade.
3. Configurar filas específicas quando necessário.
4. Monitorar eventos recebidos.
5. Validar credenciais periodicamente.
6. Revisar permissões de usuários.
7. Testar envio e recebimento.
8. Manter webhooks configurados corretamente.
9. Documentar qual canal externo corresponde a cada conexão.
10. Evitar nomes genéricos que confundam a operação.

***

### Resumo

O ConnectionHub é uma camada de integração para canais externos no DigitalSac.

Em resumo:

```
Tipo interno: connectionhub
Tipos relacionados: ch-facebook, ch-instagram, ch-email
Uso principal: integração centralizada de canais externos
Organização: tickets, filas, usuários, webhooks e permissões
```