- | <%= contato.nome %> |
- <%= contato.telefone.presence || '—' %> |
+
+ <%= contato.nome %>
+ <% if contato.grupo_whatsapp? %>
+ grupo
+ <% end %>
+ |
+
+ <% if contato.grupo_whatsapp? %>
+ <%= contato.whatsapp_grupo_nome.presence || contato.whatsapp_grupo_jid %>
+ <% else %>
+ <%= contato.telefone.presence || '—' %>
+ <% end %>
+ |
<%= contato.email.presence || '—' %> |
<% if contato.grupo_contato %>
diff --git a/config/routes.rb b/config/routes.rb
index 0d925e6..ec50104 100644
--- a/config/routes.rb
+++ b/config/routes.rb
@@ -121,7 +121,12 @@ Rails.application.routes.draw do
# singular igual ao plural para o Inflector (que não fala português), e aí
# o Rails sufixa o helper de index com `_index` — pegadinha silenciosa.
resources :grupos, except: [:show], controller: 'grupos_contato'
- resources :contatos, except: [:show]
+ resources :contatos, except: [:show] do
+ # Grupos do WhatsApp de que o número conectado participa (JSON). Carregado
+ # sob demanda pelo form: se fosse no render da tela, uma ponte fora do ar
+ # faria o cadastro de contato inteiro esperar o timeout.
+ collection { get :grupos_whatsapp }
+ end
resources :eventos, except: [:show], controller: 'eventos_notificacao' do
member do
post :disparar # gatilho `manual` — manda mensagem de verdade
diff --git a/db/migrate/20260824000008_add_grupo_whatsapp_to_contatos.rb b/db/migrate/20260824000008_add_grupo_whatsapp_to_contatos.rb
new file mode 100644
index 0000000..8ca374b
--- /dev/null
+++ b/db/migrate/20260824000008_add_grupo_whatsapp_to_contatos.rb
@@ -0,0 +1,27 @@
+# Permite que um destinatário seja um GRUPO do WhatsApp, e não só uma pessoa.
+#
+# O grupo entra como Contato de propósito: assim ele herda tudo que já existe —
+# pertence a um grupo de contatos, recebe os eventos que o grupo assina e cada
+# envio fica registrado em notificacao_envios. Uma tabela separada duplicaria
+# essa máquina inteira.
+#
+# `whatsapp_grupo_jid` guarda o identificador do WhatsApp (ex.:
+# "120363012345678901@g.us"). NÃO é telefone: não tem DDD, não normaliza, e a
+# validação de número não se aplica — daí a coluna própria em vez de reaproveitar
+# `telefone`.
+#
+# ⚠️ Nome: `grupo_contato_id` é o GRUPO INTERNO (Diretoria, Motoristas...);
+# `whatsapp_grupo_*` é o grupo lá no WhatsApp. Coisas diferentes.
+class AddGrupoWhatsappToContatos < ActiveRecord::Migration[7.1]
+ def change
+ change_table :contatos, bulk: true do |t|
+ t.string :tipo, null: false, default: 'pessoa' # pessoa | grupo_whatsapp
+ t.string :whatsapp_grupo_jid
+ # Nome do grupo no momento do cadastro: o JID é opaco e a tela precisa
+ # mostrar algo legível mesmo com a ponte fora do ar.
+ t.string :whatsapp_grupo_nome
+ end
+
+ add_index :contatos, :whatsapp_grupo_jid
+ end
+end
diff --git a/spec/models/contato_spec.rb b/spec/models/contato_spec.rb
index 7139c18..61fdce6 100644
--- a/spec/models/contato_spec.rb
+++ b/spec/models/contato_spec.rb
@@ -41,3 +41,50 @@ RSpec.describe Contato do
end
end
end
+
+RSpec.describe Contato, 'grupo do WhatsApp' do
+ let(:jid) { '120363012345678901@g.us' }
+
+ def grupo(**extra)
+ build(:contato, { tipo: 'grupo_whatsapp', nome: 'Motoristas SP',
+ whatsapp_grupo_jid: jid, telefone: nil }.merge(extra))
+ end
+
+ it 'aceita grupo sem telefone nem e-mail' do
+ expect(grupo).to be_valid
+ expect(grupo.destino_whatsapp).to eq(jid)
+ end
+
+ it 'recusa identificador que não é de grupo' do
+ contato = grupo(whatsapp_grupo_jid: '5511920051157')
+ expect(contato).not_to be_valid
+ expect(contato.errors[:whatsapp_grupo_jid].join).to include('@g.us')
+ end
+
+ # Cadastro meio pessoa, meio grupo mandaria a mesma mensagem duas vezes.
+ it 'limpa telefone e e-mail ao virar grupo' do
+ contato = grupo(telefone: '11 92005-1157', email: 'x@y.com')
+ contato.validate
+ expect(contato.telefone).to be_nil
+ expect(contato.email).to be_nil
+ end
+
+ it 'limpa o grupo ao voltar a ser pessoa' do
+ contato = build(:contato, tipo: 'pessoa', telefone: '11 92005-1157',
+ whatsapp_grupo_jid: jid, whatsapp_grupo_nome: 'Motoristas')
+ contato.validate
+ expect(contato.whatsapp_grupo_jid).to be_nil
+ end
+
+ # Cortar "Motoristas SP" em "Motoristas" no {{contato}} só empobreceria o texto.
+ it '{{contato}} usa o nome inteiro do grupo' do
+ expect(grupo.primeiro_nome).to eq('Motoristas SP')
+ expect(build(:contato, nome: 'Carlos Matheus').primeiro_nome).to eq('Carlos')
+ end
+
+ it 'entra no canal whatsapp e fica fora do canal e-mail' do
+ salvo = grupo.tap(&:save!)
+ expect(Contato.com_canal('whatsapp')).to include(salvo)
+ expect(Contato.com_canal('email')).not_to include(salvo)
+ end
+end
diff --git a/spec/services/notificacao/whatsapp_spec.rb b/spec/services/notificacao/whatsapp_spec.rb
index a5174c4..6fb535a 100644
--- a/spec/services/notificacao/whatsapp_spec.rb
+++ b/spec/services/notificacao/whatsapp_spec.rb
@@ -33,3 +33,26 @@ RSpec.describe Notificacao::Whatsapp do
expect(resposta.erro).to include('rede fora')
end
end
+
+RSpec.describe Notificacao::Whatsapp, 'grupo do WhatsApp' do
+ let(:jid) { '120363012345678901@g.us' }
+
+ it 'manda o JID cru para a ponte, sem tentar normalizar como telefone' do
+ config = ConfiguracaoNotificacao.new(whatsapp_ativo: true, whatsapp_provedor: 'baileys')
+ ponte = instance_double(Notificacao::ClienteWhatsapp,
+ enviar: Notificacao::ClienteWhatsapp::Resposta.new(ok: true))
+ allow(Notificacao::ClienteWhatsapp).to receive(:padrao).and_return(ponte)
+
+ expect(described_class.enviar(para: jid, texto: 'oi', config: config)).to be_ok
+ expect(ponte).to have_received(:enviar).with(para: jid, texto: 'oi')
+ end
+
+ it 'recusa com mensagem clara quando o provedor é Twilio' do
+ config = ConfiguracaoNotificacao.new(whatsapp_ativo: true, whatsapp_provedor: 'twilio')
+
+ resposta = described_class.enviar(para: jid, texto: 'oi', config: config)
+
+ expect(resposta).not_to be_ok
+ expect(resposta.erro).to include('grupo')
+ end
+end
|