Bloqueio Inteligente de Contatos

​

Visão Geral

​

Como Funciona

​

1. Métodos de Bloqueio

​

2. Filtro Automático

​

3. Normalização Inteligente

• Remove caracteres especiais: ()-.
• Remove zeros à esquerda
• Adiciona código do país (55) quando ausente
• Adiciona código de área quando detectável
• Padroniza para formato E.164

​

Interface Web

​

Acesso

​

Funcionalidades

​

Integração com Bancos de Dados

​

Configuração

1. Configure um banco PostgreSQL no painel Super Admin
2. Defina a query SQL que retorna números bloqueados
3. Use na importação de contatos bloqueados

​

Exemplo de Query

-- Query deve retornar coluna 'phone' ou 'phoneNumber'
SELECT 
    telefone as phone,
    'Opt-out via sistema' as reason
FROM 
    clientes
WHERE 
    optout = true
    AND telefone IS NOT NULL

​

Mapeamento de Colunas

​

API Reference

​

Bloquear Contato Individual

POST /api/blocked-contacts

curl -X POST https://api.exemplo.com/api/blocked-contacts \
  -H "X-Access-Token: seu-token" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "11999999999",
    "reason": "Solicitou opt-out via WhatsApp"
  }'

​

Importar em Massa

POST /api/blocked-contacts/import

const contatos = [
  { phoneNumber: '11999999999', reason: 'Lista opt-out mensal' },
  { phoneNumber: '11888888888', reason: 'Número inválido' }
];

const response = await fetch('https://api.exemplo.com/api/blocked-contacts/import', {
  method: 'POST',
  headers: {
    'X-Access-Token': 'seu-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(contatos)
});

​

Verificar Múltiplos Contatos

POST /api/blocked-contacts/check

const numeros = ['11999999999', '11888888888', '11777777777'];

const response = await fetch('https://api.exemplo.com/api/blocked-contacts/check', {
  method: 'POST',
  headers: {
    'X-Access-Token': 'seu-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ phoneNumbers: numeros })
});

// Resposta
{
  "11999999999": true,   // bloqueado
  "11888888888": false,  // não bloqueado
  "11777777777": true    // bloqueado
}

​

Restrições por Empresa

• O botão fica inativo na interface
• A API continua funcionando
• Mensagem informativa é exibida
• Contatos NÃO são filtrados automaticamente

​

Boas Práticas

​

1. Sempre Documente o Motivo

{
  phoneNumber: "11999999999",
  reason: "Opt-out via email em 15/01/2024 - Ticket #12345"
}

​

2. Use Importação em Massa

// Uma única requisição para múltiplos contatos
await api.importBlockedContacts(listaDeContatos);

​

3. Valide Antes de Grandes Campanhas

// Verificar impacto antes de criar campanha
const verificacao = await api.checkBlockedContacts(contatosCampanha);
const bloqueados = Object.values(verificacao).filter(b => b).length;

console.log(`${bloqueados} de ${contatosCampanha.length} serão filtrados`);

​

Performance e Limites

​

Otimizações

• Cache inteligente para verificações frequentes
• Índices otimizados no banco de dados
• Queries em batch para melhor performance
• Suporta milhões de registros por empresa

​

Histórico e Auditoria

​

Informações Registradas

​

Soft Delete

• Contatos desbloqueados não são deletados
• Histórico completo é preservado
• Possível reativar bloqueios anteriores
• Auditoria completa disponível

​

Integração com Campanhas

​

Resposta ao Criar Campanha

{
  "id": 123,
  "name": "Campanha de Janeiro",
  "status": "SCHEDULED",
  "totalContacts": 950,           // Apenas contatos válidos
  "blockedContactsRemoved": 50,   // Quantidade filtrada
  "createdAt": "2024-01-15T10:00:00Z"
}

​

Transparência Total

• Número original é sempre informado
• Quantidade filtrada é destacada
• Lista de bloqueados pode ser consultada
• Logs detalham todo o processo

​

FAQ

​

Próximos Passos