Canais

Um canal é a ponte entre o GCM e um provedor de mensagens — WAHA para WhatsApp, Twilio para SMS, Resend para e-mail, Web Push para navegadores, in-app para o sino de notificações. A página Canais (barra lateral → Canais, também acessível em Configurações) lista cada categoria de canal, deixa você escolher um provedor por categoria e guarda as credenciais necessárias para enviar.

Este é território de admin — a configuração de canal afeta a caixa de entrada de cada membro, então a página é protegida por isAdmin.

Abrir a página de Canais

Clique em Canais na barra lateral. Você verá um cartão por categoria de canal — WhatsApp, SMS, E-mail, Push, In-app. Cada cartão mostra:

• O nome do canal e um ícone.
• Um selo Configurado / Não configurado.
• Um interruptor Ativado — ligue após salvar as credenciais.
• Um botão Configurar que expande o formulário de credenciais inline.

Configurando um canal

Clique em Configurar no canal que quer conectar. O cartão expande para mostrar um seletor de provedor (se houver mais de um para esta categoria) e um formulário de credenciais.

Seletor de provedor

Cada categoria de canal aceita um ou mais provedores:

Canal	Opções de provedor
WhatsApp	WAHA (recomendado) · WhatsApp Cloud API (Meta)
SMS	Twilio · smsmobileapi
E-mail	Resend · SMTP · Plataforma padrão
Push	Web Push (nativo do navegador, sem terceiros)
In-app	Embutido (sem terceiros)

O provedor padrão vem marcado com "(padrão)" no dropdown. Você pode trocar de provedor depois reabrindo o formulário de configuração e escolhendo outro — credenciais ficam guardadas por provedor, então voltar não perde sua configuração.

Formulário de credenciais

O formulário é construído dinamicamente a partir do config_schema do provedor. Cada provedor declara que campos precisa (chave de API, endpoint, ID de remetente, etc.) e o formulário renderiza as entradas correspondentes. Campos obrigatórios têm asterisco vermelho.

Alguns padrões comuns:

WhatsApp via WAHA:

• URL de sessão — https://your-waha.example.com
• Token de API
• Uma etapa de scan QR na primeira salvada para parear a conta WhatsApp

WhatsApp Cloud API:

• ID do número de telefone (do Meta)
• Token de acesso permanente
• ID da conta business
• Token de verificação do webhook

Twilio SMS:

• Account SID
• Auth token
• Remetente — ou um número Twilio ou um ID alfanumérico onde aceito

smsmobileapi:

• Chave de API
• Rótulo de remetente

Resend (para e-mail):

• Chave de API
• Substituição opcional do domínio de origem

SMTP (para e-mail):

• Host, porta, usuário, senha
• Toggle TLS/SSL

Campos de senha e token vêm mascarados por padrão. Clique no ícone de olho para revelar enquanto cola, depois feche antes de salvar.

Salvar configuração

Clique em Salvar configuração. As credenciais são gravadas em org_channel_config (uma linha por organização, por canal, com chave (organization_id, channel_id)) e o toast confirma. A coluna de credenciais é jsonb; os valores ficam guardados criptografados em repouso no Supabase. Eles nunca aparecem no navegador depois do salvamento — na próxima vez que abrir o formulário, os campos sensíveis aparecem como •••• até você clicar para revelar.

Ativar o canal

Salvar as credenciais não liga o canal automaticamente. Vire o interruptor Ativado no cabeçalho do cartão para tornar o canal selecionável no compositor de mensagens, em nós de fluxo de trabalho e na configuração de lembretes.

TIP

Você pode configurar um canal sem ativá-lo — útil para preparar uma configuração de staging para ligar depois. Canais desativados não aparecem em nenhum outro lugar do app.

Como os canais são usados a jusante

Depois que um canal está configurado e ativado, ele aparece em:

• Enviar mensagem — o seletor de canal no compositor.
• Fluxos de trabalho — o nó de ação "Enviar notificação".
• Lembretes — a lista de checkbox de canais para lembretes de eventos.
• E-mails do sistema — redefinições de senha, magic links, e-mails de boas-vindas (apenas canais de e-mail).

Se um canal está desativado, o compositor o esconde; nós de fluxo de trabalho que o referenciam pausam com erro "canal indisponível" em vez de falhar silenciosamente.

Múltiplos provedores por categoria

Você pode ter mais de um provedor configurado por categoria — por exemplo, dois provedores de SMS (doméstico via Twilio, internacional via smsmobileapi). A edge function send-message escolhe o primeiro provedor que suporta o país do destinatário; você também pode sobrescrever por envio escolhendo o provedor manualmente no compositor.

Limites do plano

Os níveis de plano limitam quantos destinatários você pode atingir em um envio em massa:

Plano	Máx. destinatários por envio em massa
Starter	100
Growth	1.000
Network	10.000
Unlimited	sem teto

Limites de taxa por segundo são aplicados no nível do provedor — veja a visão geral dos canais de mensagens para os detalhes de como o WACRM distribui automaticamente envios em massa por vários dias quando você ultrapassa quotas diárias do provedor.

O que é salvo onde

• channels — catálogo a nível de plataforma das categorias de canal (somente leitura para organizações).
• channel_providers — catálogo a nível de plataforma dos provedores por canal, com config_schema.
• org_channel_config — linhas por organização: (organization_id, channel_id, provider_id, credentials, is_enabled). RLS escopado por current_org_id().

Testar um canal

O formulário de configuração não inclui (ainda) um envio de teste embutido. Para verificar, mande uma mensagem de teste pela página Enviar mensagem — escolha o canal, endereçe ao seu próprio telefone ou e-mail e confira a entrega. Se algo falhar, os logs de mensagens (Configurações → Logs de dados → Mensagens) mostram a resposta exata do provedor.

Armadilhas comuns

"WhatsApp diz Configurado mas as mensagens nunca chegam." Sua sessão WAHA provavelmente expirou. Faça o scan do QR de novo pelo painel do WAHA. As sessões morrem quando o WhatsApp Web rotaciona a autenticação, o que pode acontecer a cada poucas semanas.

"O Twilio rejeita todos os meus envios." O Twilio exige ou um número de remetente verificado ou um ID alfanumérico registrado para o país de destino. Confira no console do Twilio se há erros de remetente não registrado — esses não aparecem com tanta clareza nos logs do GCM.

"Configurei o Resend mas os e-mails ainda passam pela Plataforma padrão." O seletor de provedor em Configurações → E-mail é separado da página Canais para e-mail. E-mail tem configuração dedicada porque algumas organizações enviam e-mail pelo próprio SMTP enquanto os outros canais ficam no padrão. Defina o provedor de e-mail em Configurações → E-mail.

Próximos passos

• E-mail + notificações — o provedor de e-mail vive na própria aba.
• Lembretes — escolha quais canais enviam lembretes de eventos.
• Visão geral de mensagens — envie mensagens de fato uma vez que os canais estejam conectados.