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