📡 Visão Geral dos Canais

Um canal no PulseHub representa uma única conta de mensagens conectada. Você pode ter vários canais do mesmo tipo — por exemplo, dois números de WhatsApp para departamentos diferentes, ou três caixas de email para vendas/suporte/faturamento.

---

Como os Canais Funcionam

Provedor (WhatsApp, Twilio, etc.)
           │
           │  HTTP POST (webhook)
           ▼
/webhooks/{type}/{channel_id}
           │
           ▼
WebhookController
  1. Verifica a assinatura
  2. Normaliza o payload
  3. Encontra/cria contato
  4. Encontra/cria conversa
  5. Salva a mensagem
  6. Dispara eventos de automação

Cada canal possui:

• Um ID único (UUID) — este é o {channel_id} na URL do webhook
• Um tipo — um dos 8 tipos de canal suportados
• Uma configuração — blob JSON com as credenciais específicas para aquele tipo de canal
• Um token de webhook — um token aleatório de 32 caracteres hexadecimais gerado no momento da criação
• Um flag ativo — canais inativos rejeitam webhooks de entrada e não enviam mensagens de saída

---

Adicionando um Canal

1. Vá para Canais na barra lateral
2. Clique em Adicionar Canal
3. Escolha o tipo de canal no menu suspenso
4. Preencha as credenciais específicas do tipo (consulte o guia de cada canal)
5. Clique em Salvar Canal

Após salvar, o cartão do canal mostra a URL do Webhook. Copie esta URL e cole no painel de desenvolvedor do seu provedor.

---

Formato da URL do Webhook

https://seudominio.com/webhooks/{type}/{channel_id}

---

Canais Suportados

Canal	Direção	Verificação de Assinatura	Notas
WhatsApp	Ambas	✅ HMAC-SHA256	Requer conta Meta Business
SMS / Twilio	Ambas	Parcial	Requer conta Twilio
Email	Ambas	N/A	Polling IMAP para entrada
Telegram	Ambas	—	Bot API, sem assinatura
Viber	Ambas	✅ HMAC-SHA256	Requer conta Viber Partners
Instagram	Ambas	✅ HMAC-SHA256	Via Meta Graph API
Facebook Messenger	Ambas	✅ HMAC-SHA256	Via Meta Graph API
Widget de Chat Web	Ambas	Token	Snippet JS incorporado