Skip to main content
POST
/
api
/
companies
/
{companyId}
/
blocked-contacts
/
check
curl -X POST https://api.disparador.com/api/companies/1/blocked-contacts/check \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: seu-access-token" \
  -d '[
    "5511999887766",
    "5511888776655",
    "5511777665544"
  ]'

{
  "5511999887766": true,
  "5511888776655": false,
  "5511777665544": true
}
Útil para validar listas de contatos antes de criar campanhas.

​
Headers

​
X-Access-Token
string
required
Token de acesso da empresa
​
Content-Type
string
required
application/json

​
Path Parameters

​
companyId
number
required
ID da empresa (deve corresponder ao token)

​
Body

​
phoneNumbers
array
required
Lista de números de telefone para verificar
Máximo recomendado: 1000 números por requisição
curl -X POST https://api.disparador.com/api/companies/1/blocked-contacts/check \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: seu-access-token" \
  -d '[
    "5511999887766",
    "5511888776655",
    "5511777665544"
  ]'

​
Response

Retorna um objeto onde as chaves são os números verificados e os valores são booleanos indicando se estão bloqueados. 
{
  "5511999887766": true,
  "5511888776655": false,
  "5511777665544": true
}

​
Caso de Uso

// Filtrar lista antes de criar campanha
async function filterBlockedContacts(contacts, companyId, token) {
  const response = await fetch(
    `https://api.disparador.com/api/companies/${companyId}/blocked-contacts/check`,
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-Access-Token': token
      },
      body: JSON.stringify(contacts)
    }
  );
  
  const blockedStatus = await response.json();
  
  // Retorna apenas contatos não bloqueados
  return contacts.filter(contact => !blockedStatus[contact]);
}

// Uso
const allContacts = ['5511999887766', '5511888776655', '5511777665544'];
const validContacts = await filterBlockedContacts(allContacts, 1, 'seu-token');
console.log(`${validContacts.length} contatos válidos de ${allContacts.length} total`);

​
Performance

  • Para listas grandes, considere dividir em lotes de 1000 números
  • A verificação é otimizada e responde rapidamente mesmo para listas grandes
  • Use este endpoint antes de criar campanhas para evitar erros